[latex3-commits] [latex3/latex3] tl-build-access: Deprecate \tl_build_get:NN (17f0b053f)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : tl-build-access
Link       : https://github.com/latex3/latex3/commit/17f0b053fbcc0ac1bfe1253cdd2b515b985f3516

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

commit 17f0b053fbcc0ac1bfe1253cdd2b515b985f3516
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed Oct 25 12:48:25 2023 +0100

    Deprecate \tl_build_get:NN


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

17f0b053fbcc0ac1bfe1253cdd2b515b985f3516
 l3kernel/CHANGELOG.md       |  1 +
 l3kernel/doc/l3obsolete.txt |  1 +
 l3kernel/l3candidates.dtx   | 28 ----------------------------
 l3kernel/l3deprecation.dtx  | 12 ++++++++++++
 4 files changed, 14 insertions(+), 28 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index d42af1e6c..258238e80 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -21,6 +21,7 @@ this project uses date-based 'snapshot' version identifiers.
 ### Deprecated
 - `\text_titlecase:n(n)` as ambiguous: replaced by `\text_titlecase_all:n(n)`
 - `\tl_build_(g)clear:N` in favour of `\tl_build_(g)begin:N`
+- `\tl_build_get:NN` in favor of `\tl_build_(g)suspend:N`/`\tl_build_(g)resume:N`
 
 ### Fixed
 - Support arbitrary BCP-47 locales for case-changing overrides (issue \#1239)
diff --git a/l3kernel/doc/l3obsolete.txt b/l3kernel/doc/l3obsolete.txt
index a5d93edc6..37ecc8b6c 100644
--- a/l3kernel/doc/l3obsolete.txt
+++ b/l3kernel/doc/l3obsolete.txt
@@ -60,6 +60,7 @@ Function                            Date deprecated
 \text_titlecase:nn                       2023-07-08
 \tl_build_clear:N                        2023-10-18
 \tl_build_gclear:N                       2023-10-18
+\tl_build_get:NN                         2023-10-25
 \tl_case:cn                              2023-05-23
 \tl_case:cnF                             2023-05-23
 \tl_case:cnT                             2023-05-23
diff --git a/l3kernel/l3candidates.dtx b/l3kernel/l3candidates.dtx
index 6668a18c9..2a45086ff 100644
--- a/l3kernel/l3candidates.dtx
+++ b/l3kernel/l3candidates.dtx
@@ -101,19 +101,6 @@
 %   \end{texnote}
 % \end{function}
 %
-% \section{Additions to \pkg{l3tl}}
-%
-% \begin{function}[added = 2018-04-01]{\tl_build_get:NN}
-%   \begin{syntax}
-%     \cs{tl_build_get:NN} \meta{tl~var_1} \meta{tl~var_2}
-%   \end{syntax}
-%   Stores the contents of the \meta{tl~var_1} in the \meta{tl~var_2}.
-%   The \meta{tl~var_1} must have been set up with \cs{tl_build_begin:N}
-%   or \cs{tl_build_gbegin:N}.  The \meta{tl~var_2} is a
-%   \enquote{normal} token list variable, assigned locally using
-%   \cs{tl_set:Nn}.
-% \end{function}
-%
 % \end{documentation}
 %
 % \begin{implementation}
@@ -154,21 +141,6 @@
 % \end{macro}
 % \end{macro}
 %
-% \subsection{Additions to \pkg{l3tl}}
-%
-% \subsubsection{Building a token list}
-%
-%    \begin{macrocode}
-%<@@=tl>
-%    \end{macrocode}
-%
-% \begin{macro}{\tl_build_get:NN}
-%    \begin{macrocode}
-\cs_new_protected:Npn \tl_build_get:NN
-  { \@@_build_get:NNN \__kernel_tl_set:Ne }
-%    \end{macrocode}
-% \end{macro}
-%
 %    \begin{macrocode}
 %</package>
 %    \end{macrocode}
diff --git a/l3kernel/l3deprecation.dtx b/l3kernel/l3deprecation.dtx
index 08b7fa4c7..6cc079e5a 100644
--- a/l3kernel/l3deprecation.dtx
+++ b/l3kernel/l3deprecation.dtx
@@ -623,6 +623,18 @@
 %    \end{macrocode}
 % \end{macro}
 %
+% \begin{macro}{\tl_build_get:NN}
+%    \begin{macrocode}
+\__kernel_patch_deprecation:nnNNpn { 2023-10-25 } { \tl_build_suspend:N }
+\cs_new_protected:Npn \tl_build_get:NN #1#2
+  {
+    \tl_build_suspend:N #1
+    \tl_set_eq:NN #2 #1
+    \tl_build_resume:N #2
+  }
+%    \end{macrocode}
+% \end{macro}
+%
 % \subsection{Deprecated \pkg{l3token} functions}
 %
 % \begin{macro}[EXP]{\char_to_utfviii_bytes:n}