diff options
| author | piegames <git@piegames.de> | 2024-08-18 16:02:23 +0200 |
|---|---|---|
| committer | piegames <git@piegames.de> | 2024-08-21 06:55:52 +0000 |
| commit | 7210ed1b87410a0df597c0c4efe642bf82cc2b06 (patch) | |
| tree | 85be2a9cc889c74da6a16dd8ca64713f86ce8691 /doc | |
| parent | ac6974777efdaa85715cf7838fe878665061f86c (diff) | |
libexpr: Soft-deprecate __overrides
Change-Id: I787e69e1dad6edc5ccdb747b74a9ccd6e8e13bb3
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual/rl-next/deprecated-features.md | 14 |
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/manual/rl-next/deprecated-features.md b/doc/manual/rl-next/deprecated-features.md index d800ac248..3f9756fc9 100644 --- a/doc/manual/rl-next/deprecated-features.md +++ b/doc/manual/rl-next/deprecated-features.md @@ -1,12 +1,16 @@ --- -synopsis: Deprecated URL literals +synopsis: Deprecated language features issues: [fj#437] -cls: [1736, 1735, 1744] +cls: [1785, 1736, 1735, 1744] category: Breaking Changes credits: [piegames, horrors] --- -URL literals have long been obsolete and discouraged of use, and now they are officially deprecated. -This means that all URLs must be properly put within quotes like all other strings. +A system for deprecation (and then the planned removal) of undesired language features has been put into place. +It is controlled via feature flags much like experimental features, except that the deprecations are enabled default, +and can be disabled via the flags for backwards compatibility (opt-out with `--extra-deprecated-features` or the Nix configuration file). -To ease migration, they can still be enabled with `--extra-deprecated-features url-literals` for now. +- `url-literals`: **URL literals** have long been obsolete and discouraged of use, and now they are officially deprecated. + This means that all URLs must be properly put within quotes like all other strings. +- `rec-set-overrides`: **__overrides** is an old arcane syntax which has not been in use for more than a decade. + It is soft-deprecated with a warning only, with the plan to turn that into an error in a future release. |