[latex3-commits] [git/LaTeX3-latex3-latex3] main: Formally deprecate l3keys2e (bba26d9e9)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/bba26d9e9ec5cbc8ebd2f37747d4513758382140

>---------------------------------------------------------------

commit bba26d9e9ec5cbc8ebd2f37747d4513758382140
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Jun 21 10:11:15 2022 +0100

    Formally deprecate l3keys2e


>---------------------------------------------------------------

bba26d9e9ec5cbc8ebd2f37747d4513758382140
 l3packages/CHANGELOG.md          |  3 +++
 l3packages/l3keys2e/l3keys2e.dtx | 15 +++++++++++++++
 2 files changed, 18 insertions(+)

diff --git a/l3packages/CHANGELOG.md b/l3packages/CHANGELOG.md
index 0b939e9a6..c6c76ad9d 100644
--- a/l3packages/CHANGELOG.md
+++ b/l3packages/CHANGELOG.md
@@ -10,6 +10,9 @@ this project uses date-based 'snapshot' version identifiers.
 ### Changed
 - Revert alterations to `l3keys2e`
 
+### Deprecated
+- Package `l3keys2e`
+
 ## [2022-06-16]
 
 ### Changed
diff --git a/l3packages/l3keys2e/l3keys2e.dtx b/l3packages/l3keys2e/l3keys2e.dtx
index 7ca25a725..440f45dd7 100644
--- a/l3packages/l3keys2e/l3keys2e.dtx
+++ b/l3packages/l3keys2e/l3keys2e.dtx
@@ -68,6 +68,21 @@
 %
 % \begin{documentation}
 %
+% \section{Introduction}
+% 
+% \begin{center}
+%   \bfseries This package is obsolete with the June 2022 \LaTeX{} release.
+% \end{center}
+%
+% With new formats, \cs{ProcessKeyOptions} is available as a more powerful
+% version of \cs{ProcessKeysOptions}. In particular, it is built directly
+% into the \LaTeX{} kernel, uses `raw' options (and therefore does not
+% suffer from space stripping and expansion issues), and can avoid
+% option clash warnings. Package authors should transition their
+% code to the new approach.
+%
+% \section{Old introduction}
+%
 % The key--value method for optional arguments is very popular, as it
 % allows the class or package author to define a large number of
 % options with a simple interface. The \pkg{expl3} bundle of \LaTeX3