From 7210ed1b87410a0df597c0c4efe642bf82cc2b06 Mon Sep 17 00:00:00 2001 From: piegames Date: Sun, 18 Aug 2024 16:02:23 +0200 Subject: libexpr: Soft-deprecate __overrides Change-Id: I787e69e1dad6edc5ccdb747b74a9ccd6e8e13bb3 --- doc/manual/rl-next/deprecated-features.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) (limited to 'doc') 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. -- cgit v1.2.3