diff options
author | Karl Berry <karl@freefriends.org> | 2024-04-30 20:03:09 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-04-30 20:03:09 +0000 |
commit | 753708379c1fbd17a96f1a6788c94ce1fa1208d7 (patch) | |
tree | d1bfa8c85ad78bf1312298d97eb72490baa44683 /Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx | |
parent | 93ae2978eea5bd5c39e8e0ac208a658c4c0c2e05 (diff) |
l3kernel (30apr24)
git-svn-id: svn://tug.org/texlive/trunk@71140 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx | 63 |
1 files changed, 33 insertions, 30 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx b/Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx index 3906c6786ef..7af8700df76 100644 --- a/Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx +++ b/Master/texmf-dist/source/latex/l3kernel/l3deprecation.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2024-03-14} +% \date{Released 2024-04-11} % % \maketitle % @@ -51,8 +51,10 @@ % % \section{\pkg{l3deprecation} documentation} % -% A few commands have had to be deprecated over the years. This module -% defines deprecated and deleted commands to produce an error. +% A few commands have had to be deprecated over the years. +% All commands deprecated before release 2022-01-12 were already +% removed; commands deprecated since then will no longer be removed. +% Instead, this module defines them to produce errors. % % \end{documentation} % @@ -74,31 +76,12 @@ % \cs{__kernel_patch_deprecation:nnNNpn} \Arg{date} \Arg{replacement} % \meta{definition} \meta{function} \meta{parameters} \Arg{code} % \end{quote} -% defines the \meta{function} to produce a warning and run its -% \meta{code}, or to produce an error and not run any \meta{code}, -% depending on the \pkg{expl3} date. -% \begin{itemize} -% \item If the \pkg{expl3} date is less than the \meta{date} (plus -% $6$~months in case \texttt{undo-recent-deprecations} is used) then -% we define the \meta{function} to produce a warning and run its code. -% The warning is actually suppressed in two cases: -% \begin{itemize} -% \item if neither \texttt{undo-recent-deprecations} nor -% \texttt{enable-debug} are in effect we may be in an end-user's -% document so it is suppressed; -% \item if the command is expandable then we cannot produce a warning. -% \end{itemize} -% \item Otherwise, we define the \meta{function} to produce an error. -% \end{itemize} -% In both cases we additionally make \cs{debug_on:n} |{deprecation}| -% turn the \meta{function} into an \tn{outer} error, and -% \cs{debug_off:n} |{deprecation}| restore whatever the behaviour was -% without \cs{debug_on:n} |{deprecation}|. -% -% In later sections we use the \pkg{l3doc} key \texttt{deprecated} with -% a date equal to that \meta{date} plus $6$~months, so that \pkg{l3doc} -% will complain if we forget to remove the stale \meta{parameters} and -% \Arg{code}. +% defines the \meta{function} to produce an error and run its +% \meta{code}. +% +% We make \cs{debug_on:n} |{deprecation}| turn the \meta{function} into +% an \tn{outer} error, and \cs{debug_off:n} |{deprecation}| restore +% whatever the behaviour was without \cs{debug_on:n} |{deprecation}|. % % In the explanations below, \meta{definition} \meta{function} % \meta{parameters} \Arg{code} or assignments that only differ in the @@ -183,8 +166,7 @@ % % \begin{macro}{\__kernel_deprecation_error:Nnn} % The \tn{outer} definition here ensures the command cannot appear -% in an argument. Use this auxiliary on all commands that have been -% removed since 2015. +% in an argument. % \begin{macrocode} \cs_new_protected:Npn \__kernel_deprecation_error:Nnn #1#2#3 { @@ -679,6 +661,27 @@ % \end{macrocode} % \end{macro} % +% \subsection{Deprecated \pkg{l3prop} functions} +% +% \begin{macro}[deprecated] +% { +% \prop_put_if_new:Nnn, \prop_put_if_new:NVn, \prop_put_if_new:NnV, +% \prop_put_if_new:cnn, \prop_put_if_new:cVn, \prop_put_if_new:cnV, +% \prop_gput_if_new:Nnn, \prop_gput_if_new:NVn, \prop_gput_if_new:NnV, +% \prop_gput_if_new:cnn, \prop_gput_if_new:cVn, \prop_gput_if_new:cnV +% } +% \begin{macrocode} +%\__kernel_patch_deprecation:nnNNpn { 2024-03-30 } { \prop_put_if_not_in:Nnn } +\cs_new_protected:Npn \prop_put_if_new:Nnn { \prop_put_if_not_in:Nnn } +%\__kernel_patch_deprecation:nnNNpn { 2024-03-30 } { \prop_gput_if_not_in:Nnn } +\cs_new_protected:Npn \prop_gput_if_new:Nnn { \prop_gput_if_not_in:Nnn } +\cs_generate_variant:Nn \prop_put_if_new:Nnn + { NnV , NV , c , cnV , cV } +\cs_generate_variant:Nn \prop_gput_if_new:Nnn + { NnV , NV , c , cnV , cV } +% \end{macrocode} +% \end{macro} +% % \begin{macrocode} %</package> % \end{macrocode} |