[latex3-commits] [latex3/latex3] main: Mark some deprecated commands (3b1d95f57)

[github at latex-project.org]

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

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

commit 3b1d95f57e8c71da05ae48959c8b9ea380fc9a60
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Fri Dec 8 09:19:31 2023 +0000

    Mark some deprecated commands


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

3b1d95f57e8c71da05ae48959c8b9ea380fc9a60
 l3kernel/l3basics.dtx |  2 +-
 l3kernel/l3keys.dtx   | 22 ++++++++++++++++------
 l3kernel/l3text.dtx   |  2 +-
 3 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/l3kernel/l3basics.dtx b/l3kernel/l3basics.dtx
index 2ab629d7a..dcd227d6e 100644
--- a/l3kernel/l3basics.dtx
+++ b/l3kernel/l3basics.dtx
@@ -1631,7 +1631,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}{\use:x}
+% \begin{macro}[deprecated]{\use:x}
 %   Fully expands its argument and passes it to the input stream. Uses
 %   the reserved \cs{l_@@_internal_tl} which we've set up above.
 %    \begin{macrocode}
diff --git a/l3kernel/l3keys.dtx b/l3kernel/l3keys.dtx
index 375fdb920..7d8ddf452 100644
--- a/l3kernel/l3keys.dtx
+++ b/l3kernel/l3keys.dtx
@@ -1585,11 +1585,16 @@
 %    \end{macrocode}
 % \end{variable}
 %
-% \begin{variable}{\l_keys_key_str, \l_keys_key_tl}
-%   The name of a key itself: needed when setting keys. The |tl| version
-%   is deprecated but has to be handled manually.
+% \begin{variable}{\l_keys_key_str}
+%   The name of a key itself: needed when setting keys.
 %    \begin{macrocode}
 \str_new:N \l_keys_key_str
+%    \end{macrocode}
+% \end{variable}
+%
+% \begin{variable}[deprecated]{\l_keys_key_tl}
+%   The |tl| version is deprecated but has to be handled manually.
+%    \begin{macrocode}
 \tl_new:N \l_keys_key_tl
 %    \end{macrocode}
 % \end{variable}
@@ -1616,12 +1621,17 @@
 %    \end{macrocode}
 % \end{variable}
 %
-% \begin{variable}{\l_keys_path_str, \l_keys_path_tl}
+% \begin{variable}{\l_keys_path_str}
 %   The \enquote{path} of the current key is stored here: this is
-%   available to the programmer and so is public. The older version is
-%   deprecated but has to be handled manually.
+%   available to the programmer and so is public.
 %    \begin{macrocode}
 \str_new:N \l_keys_path_str
+%    \end{macrocode}
+% \end{variable}
+%
+% \begin{variable}[deprecated]{\l_keys_path_tl}
+%   The older version is deprecated but has to be handled manually.
+%    \begin{macrocode}
 \tl_new:N \l_keys_path_tl
 %    \end{macrocode}
 % \end{variable}
diff --git a/l3kernel/l3text.dtx b/l3kernel/l3text.dtx
index abf85a7ac..26665d48d 100644
--- a/l3kernel/l3text.dtx
+++ b/l3kernel/l3text.dtx
@@ -794,7 +794,7 @@
 %
 % \subsection{Configuration variables}
 %
-% \begin{variable}{\l_text_accents_tl, \l_text_letterlike_tl}
+% \begin{variable}[deprecated]{\l_text_accents_tl, \l_text_letterlike_tl}
 %   Used to be used for excluding these ideas from expansion: now deprecated.
 %    \begin{macrocode}
 \tl_new:N \l_text_accents_tl