go-sylixos/elvish
3
0
Fork 0
mirror of https://github.com/go-sylixos/elvish.git synced 2024-12-14 02:57:52 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
a1cde7b77b
elvish/NEXT-RELEASE.md

100 lines
3.2 KiB
Markdown
Raw Normal View History

Create new NEXT-RELEASE.md for 0.15.0.
2020-07-02 05:11:04 +08:00
This is the draft release notes for 0.15.0, scheduled to be released on
2021-01-01.
Add str:from-utf8-bytes, str:to-utf8-bytes and move builtin ord and chr to str module (#1081) * pkg/eval/str: move builtin ord and chr to str Move builtin string function ord and chr to the str module and rename to to str:to-codepoints and str:from-codepoints respectively as suggested in #851. * pkg/eval/str: add from-utf8-bytes & to-utf8-bytes Add from-utf8-bytes and to-utf8-bytes functions to the str module. This functions differ from their *-codepoints in that they handle utf8 bytes instead of whole codepoints. Closes #851 * pkg/eval/str: range check for codepoint and bytes str:from-codepoints Add check if arguments codepoints are within valid unicode range, return an OutOfRange error otherwise. Return a BadValue error if the codepoint isn't valid. Add/change testcases. str:from-utf8-bytes Add check if byte arguments are within valid range, return an OutOfRange error otherwise. Return a BadValue error if the byte sequence isn't a valid UTF-8 sequence. Add/change testcases. Add additional test if piping from str:to-codepoints/str:to-utf8-bytes to str:from-codpoints/str:from-utf8-bytes returns the original input.
2020-08-14 04:56:28 +08:00
Document breaking changes in introspection of rest arguments.
2020-08-20 20:31:55 +08:00
# Breaking changes
Make all builtin functions and subnamespaces read-only. This fixes #1211.
2021-01-09 08:41:42 +08:00
- Builtin functions and subnamespaces of `edit:` are now read-only.
Document breaking changes in introspection of rest arguments.
2020-08-20 20:31:55 +08:00
- Introspection for rest arguments has changed:
- The rest argument is now contained in the `arg-names` field of a
closure.
- The `rest-arg` field now contains the index of the rest argument,
instead of the name.
Handle the global namespace correctly in the -source command. The -source command now runs with a temporary namespace that is amalgamated from the local and up namespace of the caller -source; this means that it can no longer mutate its caller's local scope, which is the only possible sensible behavior anyway. This fixes #1202.
2021-01-04 06:28:57 +08:00
- The `-source` command now runs in a temporary namespace and can no longer
affect the local scope of its caller.
Address feedback in PR #1177.
2020-12-25 08:43:57 +08:00
- Key modifiers are no longer case insensitive. For example, `Alt` is still
recognized but `alt` is not. This makes key modifier parsing consistent with
key names. See [#1163](https://b.elv.sh/1163).
Make key binding syntax more consistent Document the format key of names and modifiers; albeit with a TODO regarding the `Shift` modifier. Make function key modifier matching case sensitive (`Alt` not `alt`) to match key name matching (`Enter` not `enter`). Implement `Ctrl-?` as the logical counterpart to `"\c?"`. Resolves #1163
2020-10-21 12:49:47 +08:00
Add str:from-utf8-bytes, str:to-utf8-bytes and move builtin ord and chr to str module (#1081) * pkg/eval/str: move builtin ord and chr to str Move builtin string function ord and chr to the str module and rename to to str:to-codepoints and str:from-codepoints respectively as suggested in #851. * pkg/eval/str: add from-utf8-bytes & to-utf8-bytes Add from-utf8-bytes and to-utf8-bytes functions to the str module. This functions differ from their *-codepoints in that they handle utf8 bytes instead of whole codepoints. Closes #851 * pkg/eval/str: range check for codepoint and bytes str:from-codepoints Add check if arguments codepoints are within valid unicode range, return an OutOfRange error otherwise. Return a BadValue error if the codepoint isn't valid. Add/change testcases. str:from-utf8-bytes Add check if byte arguments are within valid range, return an OutOfRange error otherwise. Return a BadValue error if the byte sequence isn't a valid UTF-8 sequence. Add/change testcases. Add additional test if piping from str:to-codepoints/str:to-utf8-bytes to str:from-codpoints/str:from-utf8-bytes returns the original input.
2020-08-14 04:56:28 +08:00
# Deprecated features
Change slice syntax to use .. instead of :. Also support ..= for closed-range slices, a la Rust. The old syntax is still supported, but deprecated. This fixes #669.
2020-08-16 05:52:50 +08:00
The following deprecated features trigger a warning whenever the code is parsed
or compiled, even if it is not executed:
Add str:from-utf8-bytes, str:to-utf8-bytes and move builtin ord and chr to str module (#1081) * pkg/eval/str: move builtin ord and chr to str Move builtin string function ord and chr to the str module and rename to to str:to-codepoints and str:from-codepoints respectively as suggested in #851. * pkg/eval/str: add from-utf8-bytes & to-utf8-bytes Add from-utf8-bytes and to-utf8-bytes functions to the str module. This functions differ from their *-codepoints in that they handle utf8 bytes instead of whole codepoints. Closes #851 * pkg/eval/str: range check for codepoint and bytes str:from-codepoints Add check if arguments codepoints are within valid unicode range, return an OutOfRange error otherwise. Return a BadValue error if the codepoint isn't valid. Add/change testcases. str:from-utf8-bytes Add check if byte arguments are within valid range, return an OutOfRange error otherwise. Return a BadValue error if the byte sequence isn't a valid UTF-8 sequence. Add/change testcases. Add additional test if piping from str:to-codepoints/str:to-utf8-bytes to str:from-codpoints/str:from-utf8-bytes returns the original input.
2020-08-14 04:56:28 +08:00
- The `chr` command is now deprecated. Use `str:from-codepoints` instead.
- The `ord` command is now deprecated. Use `str:to-codepoints` instead.
Change slice syntax to use .. instead of :. Also support ..= for closed-range slices, a la Rust. The old syntax is still supported, but deprecated. This fixes #669.
2020-08-16 05:52:50 +08:00
Deprecate has-{prefix suffix}.
2020-08-16 23:27:24 +08:00
- The `has-prefix` command is now deprecated. Use `str:has-prefix` instead.
- The `has-suffix` command is now deprecated. Use `str:has-suffix` instead.
Deprecate the -source command.
2020-08-17 06:07:30 +08:00
- The `-source` command is now deprecated. Use `eval` instead.
Document builtin `sleep` and add tests I was reviewing test coverage and noticed that the `esleep` implementation was undocumented and had no tests. This a) implements `sleep` and deprecates `esleep`, b) uses the Go time.ParseDuration function rather than assuming a simple number of seconds, c) documents the command, d) adds tests of the function. Related #1062
2020-08-18 13:40:30 +08:00
- The undocumented `esleep` command is now deprecated. Use `sleep` instead.
Introduce the `path:` module (#1203) * Introduce the `path:` module This is based on https://github.com/elves/elvish/pull/1084 by @kolbycrouch submitted five months ago. It addresses all of the feedback on that change and includes other documentation and unit test improvements. It also includes a couple of extensions to the original P.R., such as a `path:is-abs` command. I decided to resurrect that change because I want better support for filesystem path manipulation so that users can replace non-portable external commands such as `realpath` and `find` with Elvish builtins. This is a baby step towards that goal. Related #849 * Add a `path:is-regular` command This adds a `path:is-regular` command. This is for symmetry with the `path:is-dir` command and the glob `[type:regular]` modifier. It also adds support for symlinks in the `testutil.Applydir` function and change the path unit test to use it. * Rename path:real to path:eval-symlinks
2021-01-17 07:21:33 +08:00
- The `eval-symlinks` command is deprecated. Use `path:eval-symlinks` instead.
- The `path-abs` command is deprecated. Use `path:abs` instead.
- The `path-base` command is deprecated. Use `path:base` instead.
- The `path-clean` command is deprecated. Use `path:clean` instead.
- The `path-dir` command is deprecated. Use `path:dir` instead.
- The `path-ext` command is deprecated. Use `path:ext` instead.
- The `-is-dir` command is deprecated. Use `path:is-dir` instead.
Change slice syntax to use .. instead of :. Also support ..= for closed-range slices, a la Rust. The old syntax is still supported, but deprecated. This fixes #669.
2020-08-16 05:52:50 +08:00
The following deprecated features trigger a warning when the code is evaluated:
Fix typos found by codespell
2020-10-06 02:35:52 +08:00
- Using `:` in slice indices is deprecated. Use `..` instead.
Change slice syntax to use .. instead of :. Also support ..= for closed-range slices, a la Rust. The old syntax is still supported, but deprecated. This fixes #669.
2020-08-16 05:52:50 +08:00
# Notable new features
New features in the language:
Introduce "var" and "set". Assignment using "foo = bar" instead of "var foo = bar" or "set foo = bar" is not yet deprecated, but will be soon. This addresses #645.
2021-01-16 13:00:15 +08:00
- A new `var` special command can be used to explicitly declare variables, and
optionally assign them initial values.
- A new `set` special command can be used to set the values of variables or
elements.
Fix typos found by codespell
2020-10-06 02:35:52 +08:00
- Slice indices can now use `..` for left-closed, right-open ranges, and `..=`
for closed ranges.
Introduce a new eval command. This fixes #230.
2020-08-17 06:02:51 +08:00
pkg/eval: Rewrite the lvalue parsing code. Also lift the restriction on rest variables and rest arguments - they may now appear anywhere, as long as there is only one.
2020-08-20 20:15:00 +08:00
- Rest variables and rest arguments are no longer restricted to the last
variable.
Support using arbitrary character in variable names by quoting.
2021-01-13 06:47:21 +08:00
- Variables containing any character can now be assigned and used by quoting
their name, for example `'name!' = foo; put $'name!'`.
Introduce a new eval command. This fixes #230.
2020-08-17 06:02:51 +08:00
New features in the standard library:
- A new `eval` command supports evaluating a dynamic piece of code in a
restricted namespace.
Update the xiaq/persistent dependency.
2020-08-21 05:46:42 +08:00
Document builtin `sleep` and add tests I was reviewing test coverage and noticed that the `esleep` implementation was undocumented and had no tests. This a) implements `sleep` and deprecates `esleep`, b) uses the Go time.ParseDuration function rather than assuming a simple number of seconds, c) documents the command, d) adds tests of the function. Related #1062
2020-08-18 13:40:30 +08:00
- A new `sleep` command.
Introduce the `path:` module (#1203) * Introduce the `path:` module This is based on https://github.com/elves/elvish/pull/1084 by @kolbycrouch submitted five months ago. It addresses all of the feedback on that change and includes other documentation and unit test improvements. It also includes a couple of extensions to the original P.R., such as a `path:is-abs` command. I decided to resurrect that change because I want better support for filesystem path manipulation so that users can replace non-portable external commands such as `realpath` and `find` with Elvish builtins. This is a baby step towards that goal. Related #849 * Add a `path:is-regular` command This adds a `path:is-regular` command. This is for symmetry with the `path:is-dir` command and the glob `[type:regular]` modifier. It also adds support for symlinks in the `testutil.Applydir` function and change the path unit test to use it. * Rename path:real to path:eval-symlinks
2021-01-17 07:21:33 +08:00
- A new `path:` module has been introduced for manipulating and testing
filesystem paths.
Document the support for SGR sequences in prompts.
2020-08-26 06:26:51 +08:00
New features in the interactive editor:
- SGR escape sequences written from the prompt callback are now supported.
pkg/shell: Print both parse and compile errors when using -compileonly -json. The new (*Evaler).Check method allows the implementation to be simpler. Also test the JSON format feature in an integration test instead of unit test; this makes it unnecessary for the eval package to expose NewCompilationError.
2021-01-04 00:25:52 +08:00
New features in the main program:
- When using `-compileonly` to check Elvish sources that contain parse errors,
Elvish will still try to compile the source code and print out compilation
errors.
Update the xiaq/persistent dependency.
2020-08-21 05:46:42 +08:00
# Notable bugfixes
- Using large lists that contain `$nil` no longer crashes Elvish.
Reference in New Issue Copy Permalink