use tl_map_tokens:nn

latex3 · Feb 1, 2025 · 49265cc · 49265cc
1 parent c93624f
commit 49265cc
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 7 deletions.
diff --git a/base/changes.txt b/base/changes.txt
@@ -6,6 +6,12 @@ to completeness or accuracy and it contains some references to files that are
 not part of the distribution.
 ================================================================================
 
+2025-02-01  Jonathan P. Spratte
+
+    * ltcmd.dtx (subsection{User functions}):
+    Generalise \cs{ProcessList} by using \cs{tl_map_tokens:nn} instead of
+    \cs{tl_map_function:nN}.
+
 2025-01-31  Frank Mittelbach  <[email protected]>
 
 	* latexrelease.dtx (subsection{Ignoring \texttt{\string_new} errors when rolling back}):

diff --git a/base/doc/usrguide.tex b/base/doc/usrguide.tex
@@ -43,7 +43,7 @@
     \texttt{usrguide.tex} for full details.}%
 }
 
-\date{2025-01-24}
+\date{2025-02-01}
 
 \NewDocumentCommand\cs{m}{\texttt{\textbackslash\detokenize{#1}}}
 \NewDocumentCommand\marg{m}{\arg{#1}}
@@ -668,15 +668,21 @@ \subsection{Argument processors}
 \end{verbatim}
 
 \begin{decl}
-  |\ProcessList| \arg{list} \arg{cmd}
+  |\ProcessList| \arg{list} \arg{tokens}
 \end{decl}
 To support \cs{SplitList}, the function \cs{ProcessList} is available
-to apply a \meta{cmd} to every entry in a \meta{list}. The
-\meta{cmd} should absorb one argument: the list entry. For example
+to apply a \meta{tokens} to every entry in a \meta{list}. The
+\meta{tokens} can be arbitrary contents that should expect one argument
+after it: the list entry. For example
 \begin{verbatim}
 \NewDocumentCommand \foo {>{\SplitList{;}} m}
   {\ProcessList{#1}{\SomeDocumentCommand}}
 \end{verbatim}
+or
+\begin{verbatim}
+\NewDocumentCommand \foo {>{\SplitList{;}} m}
+  {\ProcessList{#1}{Abc \SomeDocumentCommand}}
+\end{verbatim}
 
 \begin{decl}
   |\ReverseBoolean|

diff --git a/base/ltcmd.dtx b/base/ltcmd.dtx
@@ -34,8 +34,8 @@
 %%% From File: ltcmd.dtx
 %
 %    \begin{macrocode}
-\def\ltcmdversion{v1.3a}
-\def\ltcmddate{2025-01-24}
+\def\ltcmdversion{v1.3b}
+\def\ltcmddate{2025-02-01}
 %    \end{macrocode}
 %
 %<*driver>
@@ -5706,8 +5706,10 @@
 %
 % \begin{macro}{\ProcessList}
 %   To support \cs{SplitList}.
+% \changes{v1.3b}{2025-02-01}
+%                {Use \cs{tl_map_tokens:nn} instead of \cs{tl_map_function:nN}}
 %    \begin{macrocode}
-\cs_new_eq:NN \ProcessList \tl_map_function:nN
+\cs_new_eq:NN \ProcessList \tl_map_tokens:nn
 %    \end{macrocode}
 % \end{macro}
 %