Skip to content

Commit f2f9f47

Browse files
Ph0enixKMlens0021Mte90
authored
Update what's new page (#98)
Co-authored-by: Lens0021 / Leslie <lorentz0021@gmail.com> Co-authored-by: Daniele Scasciafratte <mte90net@gmail.com>
1 parent 8cdac3c commit f2f9f47

File tree

2 files changed

+33
-23
lines changed

2 files changed

+33
-23
lines changed

docs/0.5.0-alpha/getting_started/usage.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -95,20 +95,10 @@ $ ./output.sh
9595

9696
## Syntax Highlighting
9797

98-
<<<<<<< HEAD:docs/0.4.1-alpha/getting_started/usage.md
99-
<<<<<<< Updated upstream:docs/0.4.1-alpha/getting_started/usage.md
100-
By default, Amber runs postprocessors `shfmt` and `bshchk` (if installed) on the compiled Bash script. This functionality can be disabled with a `--no-proc` option:
101-
=======
102-
[VS Code](https://code.visualstudio.com) as well as [Zed](https://zed.dev) now have built-in LSP integration.
103-
104-
![LSP Example]{"width": "100%"}(/images/lsp-example-light.webp)(/images/lsp-example-dark.webp)
105-
106-
=======
10798
[VS Code](https://code.visualstudio.com) as well as [Zed](https://zed.dev) now have built-in LSP integration.
10899

109100
![Amber LSP Feature]{"width": "100%"}(/images/lsp-example-light.webp)(/images/lsp-example-dark.webp)
110101

111-
>>>>>>> 87d48e1a600dc7d4aa463f93b4941ac80e59e252:docs/0.5.0-alpha/getting_started/usage.md
112102
Here is a list of plugins that support syntax highlighting for Amber language.
113103

114104
| Icon | Name | Location |

docs/0.5.0-alpha/getting_started/whats_new.md

Lines changed: 33 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,29 @@
11
Featuring a new compiler backend that improves readability, reliability, and performance of bash output, new `Int` data type and more.
22

3-
## More readable bash output
3+
# Amber LSP
4+
5+
Amber now offers code autocompletion, intelligent suggestions, real-time error checking, and more. It’s available in both [VS Code](https://marketplace.visualstudio.com/items?itemName=amber-lsp-publisher.amber-lsp), [Zed](https://zed.dev/extensions/amber) and [Helix](https://github.com/helix-editor/helix) through our language extension. Prebuilt binaries for all supported platforms can be found in the [LSP release page](https://github.com/amber-lang/amber-lsp/releases). Thank you [@KrosFire](https://github.com/KrosFire) for developing the LSP.
6+
7+
![Amber LSP Feature]{"width": "100%"}(/images/lsp-example-light.webp)(/images/lsp-example-dark.webp)
8+
9+
# Support for a wide range of Bash versions
10+
11+
Amber now compiles to a bash that is compatible with Bash versions all the way back from `3.2` to latest (currently `5.3`).
12+
13+
To achieve this, we integrated all the different bash versions and a macos runner into our continuous integration (CI) pipeline. Thank you [@lens0021](https://github.com/lens0021).
14+
15+
# More readable bash output
416

517
![Bash output comparison]{"width": "100%"}(/images/bash-output-comparison-light.webp)(/images/bash-output-comparison-dark.webp)
618

7-
## Integer type
19+
# Integer type
820

921
New integer `Int` data type that is now the only supported type for:
1022
- **Array subscript** - `i` in `arr[i]` can only be of type `Int`
1123
- **Range** - `a` and `b` in `a..b` range operator can only be `Int`
1224
- **Iterator** - `i` in `for i, item in items` is `Int` instead of `Num`.
1325

14-
## Comparison
26+
# Comparison
1527

1628
Comparison operator now supports lexical comparison of `Text` data type.
1729

@@ -29,7 +41,7 @@ echo left > right // True
2941
```
3042

3143

32-
## Optimizer
44+
# Optimizer
3345

3446
Optimizer removes redundant and unused variables in the bash output. It can significantly reduce the shell code size. Let's take this example:
3547

@@ -55,7 +67,7 @@ echo "${my_array[@]}"
5567

5668
For now, this optimizer works for simple expressions, but it will be improved as we continue to develop Amber.
5769

58-
## Reversed range support
70+
# Reversed range support
5971

6072
Previously, the range function required `start < end`. Now it supports any numeric order.
6173

@@ -67,24 +79,24 @@ echo 0..=3 // [0, 1, 2, 3]
6779
echo 6..=3 // [6, 5, 4, 3]
6880
```
6981

70-
## Standard library
82+
# Standard library
7183

7284
- New standard library function `bash_version` (in `std/env`) that returns currently installed version of bash.
7385
- New `temp_dir_create` function that properly creates a temporary directory on linux and macOS. Thanks [@lens0021](https://github.com/lens0021)
7486

75-
### `std/date`
87+
## `std/date`
7688

7789
Improved date library by replacing old functions with new ones.
7890

79-
#### Removed functions:
91+
### Removed functions:
8092

8193
| Name | Description |
8294
|:--|:--|
8395
| `date_posix` | By default reads date in a `YYYY-MM-DDTHH:MM:SST` format and stores in a platform dependent representation |
8496
| `date_add` | Adds time to already parsed date |
8597
| `date_compare` | Compares two dates and returns value of a sign function |
8698

87-
#### Introduced functions:
99+
### Introduced functions:
88100

89101
| Name | Description |
90102
|:--|:--|
@@ -95,9 +107,17 @@ Improved date library by replacing old functions with new ones.
95107

96108
How to compare dates now? Since date is now stored as milliseconds since epoch, we can simply compare them with `>`, `>=`, `<` and `<=` operators.
97109

98-
## Bugfixes
110+
# Other Features
111+
112+
- Documentation Generator can output generated.documentation to standard output. Thanks [@hdwalters](https://github.com/hdwalters).
113+
- Improved compiler error reporting.
114+
- When Amber is built by development branch, now the binary version includes commit hash. Thanks [@Thesola10](https://github.com/Thesola10).
115+
- Improved shellcheck code coverage.
116+
- Compiler collaborators can now benefit from a ready VS Code debug profile. Thanks [@b1ek](https://github.com/b1ek).
117+
118+
# Bugfixes
99119

100-
- Duplicate argument names are not allowed. Thanks [@MuhamedMagdi](https://github.com/MuhamedMagdi)
101-
- Standard library `replace_regex` now properly works on macOS and Linux musl. Thanks [@Aleksanaa](https://github.com/Aleksanaa)
102-
- Casting `Text` to `Bool` now raises an absurd cast warning. Thanks [@lens0021](https://github.com/lens0021)
120+
- Duplicate argument names are not allowed. Thanks [@MuhamedMagdi](https://github.com/MuhamedMagdi).
121+
- Standard library `replace_regex` now properly works on macOS and Linux musl. Thanks [@Aleksanaa](https://github.com/Aleksanaa).
122+
- Casting `Text` to `Bool` now raises an absurd cast warning. Thanks [@lens0021](https://github.com/lens0021).
103123
- Fixed escaping of backticks in text literals.

0 commit comments

Comments
 (0)