jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

cleaned up the changelog

Browse source
This commit is contained in:
Araq 2019-06-05 22:48:27 +02:00
commit 591007878c
1 changed files with 31 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

58
changelog.md
View file

@ -1,4 +1,4 @@
## v0.20.0 - XX/XX/2019 ## v0.20.0 - 2019-06-05
### Changes affecting backwards compatibility ### Changes affecting backwards compatibility
@ -6,13 +6,13 @@
- The ``isLower``, ``isUpper`` family of procs in strutils/unicode - The ``isLower``, ``isUpper`` family of procs in strutils/unicode
operating on **strings** have been operating on **strings** have been
deprecated since it was unclear what these do. Note that the much more deprecated since it was unclear what these do. Note that the much more
useful procs that operator on ``char`` or ``Rune`` are not affected. useful procs that operate on ``char`` or ``Rune`` are not affected.
- `strutils.editDistance` has been deprecated, - `strutils.editDistance` has been deprecated,
use `editdistance.editDistance` or `editdistance.editDistanceAscii` use `editdistance.editDistance` or `editdistance.editDistanceAscii`
instead. instead.
- The OpenMP parallel iterator \``||`\` now supports any `#pragma omp directives` - The OpenMP parallel iterator \``||`\` now supports any `#pragma omp directive`
and not just `#pragma omp parallel for`. See and not just `#pragma omp parallel for`. See
[OpenMP documentation](https://www.openmp.org/wp-content/uploads/OpenMP-4.5-1115-CPP-web.pdf). [OpenMP documentation](https://www.openmp.org/wp-content/uploads/OpenMP-4.5-1115-CPP-web.pdf).
@ -32,7 +32,10 @@
- `getImpl` on a `var` or `let` symbol will now return the full `IdentDefs` - `getImpl` on a `var` or `let` symbol will now return the full `IdentDefs`
tree from the symbol declaration instead of just the initializer portion. tree from the symbol declaration instead of just the initializer portion.
- To use multi-methods, explicit `--multimethods:on` is now needed. - Methods are now ordinary "single" methods, only the first parameter is
used to select the variant at runtime. For backwards compatbility
use the new `--multimethods:on` switch.
- Generic methods are now deprecated; they never worked well. - Generic methods are now deprecated; they never worked well.
- Compile time checks for integer and float conversions are now stricter. - Compile time checks for integer and float conversions are now stricter.
@ -44,20 +47,20 @@
as `void` or no result type at all. as `void` or no result type at all.
- A bug allowed `macro foo(): int = 123` to compile even though a - A bug allowed `macro foo(): int = 123` to compile even though a
macros has to return a `NimNode`. This has been fixed. macro has to return a `NimNode`. This has been fixed.
- `shr` is now sign preserving. Use `-d:nimOldShiftRight` to enable old - `shr` is now sign preserving. Use `-d:nimOldShiftRight` to enable
behavior globally. the old behavior globally.
- With the exception of `uint` and `uint64`, conversion to unsigned types - With the exception of `uint` and `uint64`, conversion to unsigned types
are now range checked during runtime. are now range checked during runtime.
- Macro arguments of type `typedesc` are now passed in to the macro as - Macro arguments of type `typedesc` are now passed to the macro as
`NimNode` like every other type. Use either `typed` or `NimNode` like every other type except `static`. Use `typed` for a
`static[typedesc]` for a behavior that is identical in new and old behavior that is identical in new and old
Nim. Nim. Seet the RFC [Pass typedesc as NimNode to macros](https://github.com/nim-lang/RFCs/issues/148>)
RFC: `Pass typedesc as NimNode to macros for more details.
<https://github.com/nim-lang/RFCs/issues/148>`_.
#### Breaking changes in the standard library #### Breaking changes in the standard library
@ -74,13 +77,14 @@
- The procs `parseutils.parseBiggestInt`, `parseutils.parseInt`, - The procs `parseutils.parseBiggestInt`, `parseutils.parseInt`,
`parseutils.parseBiggestUInt` and `parseutils.parseUInt` now raise a `parseutils.parseBiggestUInt` and `parseutils.parseUInt` now raise a
`ValueError` when the parsed integer is outside of the valid range. `ValueError` when the parsed integer is outside of the valid range.
Previously they sometimes raised a `OverflowError` and sometimes returned `0`. Previously they sometimes raised an `OverflowError` and sometimes they
returned `0`.
- The procs `parseutils.parseBin`, `parseutils.parseOct` and `parseutils.parseHex` - The procs `parseutils.parseBin`, `parseutils.parseOct` and `parseutils.parseHex`
were not clearing their `var` parameter `number` and used to push its value to were not clearing their `var` parameter `number` and used to push its value to
the left when storing the parsed string into it. Now they always set the value the left when storing the parsed string into it. Now they always set the value
of the parameter to `0` before storing the result of the parsing, unless the of the parameter to `0` before storing the result of the parsing, unless the
string to parse is not valid and then the value of `number` is not changed. string to parse is not valid (then the value of `number` is not changed).
- `streams.StreamObject` now restricts its fields to only raise `system.Defect`, - `streams.StreamObject` now restricts its fields to only raise `system.Defect`,
`system.IOError` and `system.OSError`. `system.IOError` and `system.OSError`.
@ -96,8 +100,8 @@
- nre's `RegexMatch.captures.{items,toSeq}` now returns an `Option[string]` - nre's `RegexMatch.captures.{items,toSeq}` now returns an `Option[string]`
instead of a `string`. With the removal of `nil` strings, this is the only instead of a `string`. With the removal of `nil` strings, this is the only
way to indicate a missing match. Inside your loops, instead of `capture == way to indicate a missing match. Inside your loops, instead
""` or `capture == nil`, use `capture.isSome` to check if a capture is of `capture == ""` or `capture == nil`, use `capture.isSome` to check if a capture is
present, and `capture.get` to get its value. present, and `capture.get` to get its value.
- nre's `replace()` no longer throws `ValueError` when the replacement string - nre's `replace()` no longer throws `ValueError` when the replacement string
@ -105,7 +109,7 @@
`IndexError` for un-named captures. This is consistant with `IndexError` for un-named captures. This is consistant with
`RegexMatch.{captureBounds,captures}[]`. `RegexMatch.{captureBounds,captures}[]`.
- splitFile now correctly handles edge cases, see #10047 - `splitFile` now correctly handles edge cases, see #10047.
- `isNil` is no longer false for undefined in the JavaScript backend: - `isNil` is no longer false for undefined in the JavaScript backend:
now it's true for both nil and undefined. now it's true for both nil and undefined.
@ -188,7 +192,7 @@ proc enumToString*(enums: openArray[enum]): string =
- Added ``std/sums`` module for fast summation functions. - Added ``std/sums`` module for fast summation functions.
- Added `Rusage`, `getrusage`, `wait4` to posix interface. - Added `Rusage`, `getrusage`, `wait4` to the posix interface.
- Added the `posix_utils` module. - Added the `posix_utils` module.
@ -210,7 +214,7 @@ proc enumToString*(enums: openArray[enum]): string =
- In `strutils` empty strings now no longer matched as substrings - In `strutils` empty strings now no longer matched as substrings
anymore. anymore.
- Complex type is now generic and not a tuple anymore. - The `Complex` type is now a generic object and not a tuple anymore.
- The `ospaths` module is now deprecated, use `os` instead. Note that - The `ospaths` module is now deprecated, use `os` instead. Note that
`os` is available in a NimScript environment but unsupported `os` is available in a NimScript environment but unsupported
@ -223,7 +227,7 @@ proc enumToString*(enums: openArray[enum]): string =
- `os.joinPath` and `os.normalizePath` handle edge cases like ``"a/b/../../.."`` - `os.joinPath` and `os.normalizePath` handle edge cases like ``"a/b/../../.."``
differently. differently.
- `securehash` is moved to `lib/deprecated` - `securehash` was moved to `lib/deprecated`.
- The switch ``-d:useWinAnsi`` is not supported anymore. - The switch ``-d:useWinAnsi`` is not supported anymore.
@ -236,10 +240,10 @@ proc enumToString*(enums: openArray[enum]): string =
- Vm support for float32<->int32 and float64<->int64 casts was added. - Vm support for float32<->int32 and float64<->int64 casts was added.
- There is a new pragma block `noSideEffect` that works like - There is a new pragma block `noSideEffect` that works like
the `gcsafe` pragma block. the `gcsafe` pragma block.
- added os.getCurrentProcessId() - added `os.getCurrentProcessId`.
- User defined pragmas are now allowed in the pragma blocks - User defined pragmas are now allowed in the pragma blocks.
- Pragma blocks are no longer eliminated from the typed AST tree to preserve - Pragma blocks are no longer eliminated from the typed AST tree to preserve
pragmas for further analysis by macros pragmas for further analysis by macros.
- Custom pragmas are now supported for `var` and `let` symbols. - Custom pragmas are now supported for `var` and `let` symbols.
- Tuple unpacking is now supported for constants and for loop variables. - Tuple unpacking is now supported for constants and for loop variables.
- Case object branches can be initialized with a runtime discriminator if - Case object branches can be initialized with a runtime discriminator if
@ -265,8 +269,8 @@ proc enumToString*(enums: openArray[enum]): string =
### Tool changes ### Tool changes
- `jsondoc` now include a `moduleDescription` field with the module - `jsondoc` now includes a `moduleDescription` field with the module
description. `jsondoc0` shows comments as it's own objects as shown in the description. `jsondoc0` shows comments as its own objects as shown in the
documentation. documentation.
- `nimpretty`: --backup now defaults to `off` instead of `on` and the flag was - `nimpretty`: --backup now defaults to `off` instead of `on` and the flag was
un-documented; use `git` instead of relying on backup files. un-documented; use `git` instead of relying on backup files.
@ -276,7 +280,7 @@ proc enumToString*(enums: openArray[enum]): string =
### Compiler changes ### Compiler changes
- The deprecated `fmod` proc is now unavailable on the VM'. - The deprecated `fmod` proc is now unavailable on the VM.
- A new `--outdir` option was added. - A new `--outdir` option was added.
- The compiled JavaScript file for the project produced by executing `nim js` - The compiled JavaScript file for the project produced by executing `nim js`
will no longer be placed in the nimcache directory. will no longer be placed in the nimcache directory.