diff options
author | Norbert Preining <norbert@preining.info> | 2023-11-02 03:04:13 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-11-02 03:04:13 +0000 |
commit | 2da66dea964ffa47d24f26081f2942a6e1ef1121 (patch) | |
tree | 74283568549892324b317485ab0a26dc23917afb /macros/latex/contrib/l3kernel/l3seq.dtx | |
parent | a9d0083bcc66de9ea863ed14cf8cde44e88e4355 (diff) |
CTAN sync 202311020304
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3seq.dtx')
-rw-r--r-- | macros/latex/contrib/l3kernel/l3seq.dtx | 66 |
1 files changed, 33 insertions, 33 deletions
diff --git a/macros/latex/contrib/l3kernel/l3seq.dtx b/macros/latex/contrib/l3kernel/l3seq.dtx index 56662dc623..d9ab9ba1dd 100644 --- a/macros/latex/contrib/l3kernel/l3seq.dtx +++ b/macros/latex/contrib/l3kernel/l3seq.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2023-10-23} +% \date{Released 2023-11-01} % % \maketitle % @@ -327,8 +327,8 @@ % \begin{texnote} % The result is returned within the \tn{unexpanded} % primitive (\cs{exp_not:n}), which means that the \meta{item} -% does not expand further when appearing in an \texttt{x}-type -% or \texttt{e}-type argument expansion. +% does not expand further when appearing in an \texttt{e}-type +% or \texttt{x}-type argument expansion. % \end{texnote} % \end{function} % @@ -342,8 +342,8 @@ % \begin{texnote} % The result is returned within the \tn{unexpanded} % primitive (\cs{exp_not:n}), which means that the \meta{item} -% does not expand further when appearing in an \texttt{x}-type -% or \texttt{e}-type argument expansion. +% does not expand further when appearing in an \texttt{e}-type +% or \texttt{x}-type argument expansion. % \end{texnote} % \end{function} % @@ -740,15 +740,15 @@ % \end{texnote} % \end{function} % -% \begin{function}[added = 2020-07-16] -% {\seq_set_map_x:NNn, \seq_gset_map_x:NNn} +% \begin{function}[added = 2020-07-16, updated = 2023-10-26] +% {\seq_set_map_e:NNn, \seq_gset_map_e:NNn} % \begin{syntax} -% \cs{seq_set_map_x:NNn} \meta{seq~var_1} \meta{seq~var_2} \Arg{inline function} +% \cs{seq_set_map_e:NNn} \meta{seq~var_1} \meta{seq~var_2} \Arg{inline function} % \end{syntax} % Applies \meta{inline function} to every \meta{item} stored % within the \meta{seq~var_2}. The \meta{inline function} should % consist of code which will receive the \meta{item} as |#1|. -% The sequence resulting from \texttt{x}-expanding +% The sequence resulting from \texttt{e}-expanding % \meta{inline function} applied to each \meta{item} % is assigned to \meta{seq~var_1}. As such, the code % in \meta{inline function} should be expandable. @@ -796,8 +796,8 @@ % \begin{texnote} % The result is returned within the \tn{unexpanded} % primitive (\cs{exp_not:n}), which means that the \meta{items} -% do not expand further when appearing in an \texttt{x}-type -% or \texttt{e}-type argument expansion. +% do not expand further when appearing in an \texttt{e}-type +% or \texttt{x}-type argument expansion. % \end{texnote} % \end{function} % @@ -821,8 +821,8 @@ % \begin{texnote} % The result is returned within the \tn{unexpanded} % primitive (\cs{exp_not:n}), which means that the \meta{items} -% do not expand further when appearing in an \texttt{x}-type -% or \texttt{e}-type argument expansion. +% do not expand further when appearing in an \texttt{e}-type +% or \texttt{x}-type argument expansion. % \end{texnote} % \end{function} % @@ -1308,14 +1308,14 @@ % spaces the item is enclosed within braces. After % \cs{tl_replace_all:Nnn}, the token list \cs{l_@@_internal_a_tl} % is a repetition of the pattern -% \cs{@@_set_split_auxi:w} \cs{prg_do_nothing:} +% \cs{@@_set_split:Nw} \cs{prg_do_nothing:} % \meta{item with spaces} \cs{@@_set_split_end:}. -% Then, \texttt{x}-expansion causes \cs{@@_set_split_auxi:w} +% Then, \texttt{e}-expansion causes \cs{@@_set_split:Nw} % to trim spaces, and leaves its result as -% \cs{@@_set_split_auxii:w} \meta{trimmed item} +% \cs{@@_set_split:w} \meta{trimmed item} % \cs{@@_set_split_end:}. This is then converted % to the \pkg{l3seq} internal structure by another -% \texttt{x}-expansion. In the first step, we insert +% \texttt{e}-expansion. In the first step, we insert % \cs{prg_do_nothing:} to avoid losing braces too early: % that would cause space trimming to act within those % lost braces. The second step is solely there to strip @@ -1480,7 +1480,7 @@ % % \begin{macro}{\@@_wrap_item:n} % This function converts its argument to a proper sequence item -% in an \texttt{x}-expansion context. +% in an \texttt{e}-expansion context. % \begin{macrocode} \cs_new:Npn \@@_wrap_item:n #1 { \exp_not:n { \@@_item:n {#1} } } % \end{macrocode} @@ -1542,15 +1542,15 @@ % items one at a time to an intermediate sequence. % The approach taken is therefore similar to % that in \cs{@@_pop_right:NNN}, using a \enquote{flexible} -% \texttt{x}-type expansion to do most of the work. As \cs{tl_if_eq:nnT} +% \texttt{e}-type expansion to do most of the work. As \cs{tl_if_eq:nnT} % is not expandable, a two-part strategy is needed. First, the -% \texttt{x}-type expansion uses \cs{str_if_eq:nnT} to find potential +% \texttt{e}-type expansion uses \cs{str_if_eq:nnT} to find potential % matches. If one is found, the expansion is halted and the necessary -% set up takes place to use the \cs{tl_if_eq:NNT} test. The \texttt{x}-type +% set up takes place to use the \cs{tl_if_eq:NNT} test. The \texttt{e}-type % is started again, including all of the items copied already. This % happens repeatedly until the entire sequence has been scanned. The code -% is set up to avoid needing and intermediate scratch list: the lead-off -% \texttt{x}-type expansion (|#1 #2 {#2}|) ensures that nothing is lost. +% is set up to avoid needing an intermediate scratch list: the lead-off +% \texttt{e}-type expansion (|#1 #2 {#2}|) ensures that nothing is lost. % \begin{macrocode} \cs_new_protected:Npn \seq_remove_all:Nn { \@@_remove_all_aux:NNn \__kernel_tl_set:Ne } @@ -1993,7 +1993,7 @@ % use some of the same ideas as getting from the right. What is needed is a % \enquote{flexible length} way to set a token list variable. This is % supplied by the |{ \if_false: } \fi:| \ldots -% |\if_false: { \fi: }| construct. Using an \texttt{x}-type +% |\if_false: { \fi: }| construct. Using an \texttt{e}-type % expansion and a \enquote{non-expanding} definition for \cs{@@_item:n}, % the left-most $n - 1$ entries in a sequence of $n$ items are stored % back in the sequence. That needs a loop of unknown length, hence using the @@ -2280,7 +2280,7 @@ % } % \UnitTested % This is just a specialised version of the in-line mapping function, -% using an \texttt{x}-type expansion for the code set up so that the +% using an \texttt{e}-type expansion for the code set up so that the % number of |#| tokens required is as expected. % \begin{macrocode} \cs_new_protected:Npn \seq_map_variable:NNn #1#2#3 @@ -2389,17 +2389,17 @@ % \end{macro} % \end{macro} % -% \begin{macro}{\seq_set_map_x:NNn, \seq_gset_map_x:NNn} -% \begin{macro}{\@@_set_map_x:NNNn} +% \begin{macro}{\seq_set_map_e:NNn, \seq_gset_map_e:NNn} +% \begin{macro}{\@@_set_map_e:NNNn} % Very similar to \cs{seq_set_filter:NNn}. We could actually % merge the two within a single function, but it would have weird % semantics. % \begin{macrocode} -\cs_new_protected:Npn \seq_set_map_x:NNn - { \@@_set_map_x:NNNn \__kernel_tl_set:Ne } -\cs_new_protected:Npn \seq_gset_map_x:NNn - { \@@_set_map_x:NNNn \__kernel_tl_gset:Ne } -\cs_new_protected:Npn \@@_set_map_x:NNNn #1#2#3#4 +\cs_new_protected:Npn \seq_set_map_e:NNn + { \@@_set_map_e:NNNn \__kernel_tl_set:Ne } +\cs_new_protected:Npn \seq_gset_map_e:NNn + { \@@_set_map_e:NNNn \__kernel_tl_gset:Ne } +\cs_new_protected:Npn \@@_set_map_e:NNNn #1#2#3#4 { \@@_push_item_def:n { \exp_not:N \@@_item:n {#4} } #1 #2 { #3 } @@ -2411,7 +2411,7 @@ % % \begin{macro}{\seq_set_map:NNn, \seq_gset_map:NNn} % \begin{macro}{\@@_set_map:NNNn} -% Similar to \cs{seq_set_map_x:NNn}, but prevents expansion of the +% Similar to \cs{seq_set_map_e:NNn}, but prevents expansion of the % <inline function>. % \begin{macrocode} \cs_new_protected:Npn \seq_set_map:NNn |