nandi.uk
Fork of daniellemaywood.uk/gleam — Wasm codegen work
Add `fn` to v2 doc
author
Louis Pilfold
date
(Jun 4, 2025, 1:34 PM +0100)
commit
b0945d2b
b0945d2ba7e42b9e37ef16e68d1effc34cb83024
parent
b658d7fb
b658d7fb43976a0bd64c31057d7cbcd950b0c089
+42
-9
+42
-9
docs/v2.md
+42
-9
docs/v2.md
···
1
1
# Breaking changes to make for v2
2
2
3
-
- Remove `[1 ..]` syntax: due to a bug in the parser we accept that as a valid
4
-
list. At the moment we just raise a warning saying it's deprecated and the
5
-
formatter removes it.
6
-
- Do not allow `_ as a` anywhere in patterns. It doesn't make a lot of sense
7
-
since one could just write `a` instead and we don't want two ways of doing the
8
-
same thing.
9
-
- Do not allow shadowing an imported value, the same way one can't define two
10
-
top level functions with the same name.
11
-
- Do not allow to use dev dependencies under `src/`.
3
+
## `[1 ..]` syntax
4
+
5
+
Due to a bug in the parser we accept `[1, ..]` as a valid list value.
6
+
7
+
- [x] Emits warning when used.
8
+
- [x] Formatter rewrites it to desired syntax.
9
+
10
+
## `_ as a` syntax
11
+
12
+
This pattern doesn't make sense as one could write `a` instead. We don't want
13
+
two ways of doing the same thing.
14
+
15
+
- [ ] Emits warning when used.
16
+
- [ ] Formatter rewrites it to desired syntax.
17
+
18
+
## Shadowing imported values
19
+
20
+
Do not allow shadowing an imported value, the same way one can't define two
21
+
top level functions with the same name.
22
+
23
+
- [ ] Emits warning when used.
24
+
25
+
## Import one module multiple times
26
+
27
+
Do not one module to be imported multiple times. This is currently accepted so
28
+
long as each import uses a different alias.
29
+
30
+
- [ ] Emits warning when used.
31
+
32
+
## Development dependencies in `src/` code
33
+
34
+
Do not allow to use dev dependencies within `src/`.
35
+
36
+
- [ ] Emits warning when used.
37
+
- [ ] Blocks `gleam export erlang-shipment`.
38
+
- [ ] Blocks `gleam publish`.
39
+
40
+
## JavaScript runtime error `fn` property
41
+
42
+
On JavaScript there is a deprecated `fn` property. This was a mistake, it
43
+
should have been `function`. It still exists today due to backwards
44
+
compatibility.