[latex3-commits] [git/LaTeX3-latex3-latex3] master: Clarify that mappings don't happen in a group [ci skip] (f78a33a01)

[Bruno Le Floch]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/f78a33a01c3752d2d5e4011a0679bdcf0b37fa0d

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

commit f78a33a01c3752d2d5e4011a0679bdcf0b37fa0d
Author: Bruno Le Floch <bruno at le-floch.fr>
Date:   Sun Aug 25 09:25:47 2019 +0200

    Clarify that mappings don't happen in a group [ci skip]


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

f78a33a01c3752d2d5e4011a0679bdcf0b37fa0d
 l3kernel/l3clist.dtx       | 3 +++
 l3kernel/l3file.dtx        | 4 ++++
 l3kernel/l3prop.dtx        | 4 ++++
 l3kernel/l3seq.dtx         | 4 ++++
 l3kernel/l3str.dtx         | 8 ++++++++
 l3kernel/l3tl-analysis.dtx | 3 +++
 l3kernel/l3tl.dtx          | 4 ++++
 7 files changed, 30 insertions(+)

diff --git a/l3kernel/l3clist.dtx b/l3kernel/l3clist.dtx
index bcac2b813..c08a1129e 100644
--- a/l3kernel/l3clist.dtx
+++ b/l3kernel/l3clist.dtx
@@ -401,6 +401,9 @@
 %
 % The functions described in this section apply a specified function
 % to each item of a comma list.
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
 %
 % When the comma list is given explicitly, as an \texttt{n}-type argument,
 % spaces are trimmed around each item.
diff --git a/l3kernel/l3file.dtx b/l3kernel/l3file.dtx
index 334375a07..440382443 100644
--- a/l3kernel/l3file.dtx
+++ b/l3kernel/l3file.dtx
@@ -241,6 +241,10 @@
 %   \end{texnote}
 % \end{function}
 %
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
+%
 % \begin{function}[added = 2012-02-11]{\ior_map_inline:Nn}
 %   \begin{syntax}
 %     \cs{ior_map_inline:Nn} \meta{stream} \Arg{inline function}
diff --git a/l3kernel/l3prop.dtx b/l3kernel/l3prop.dtx
index 7b0fb5aa3..9f340d0b9 100644
--- a/l3kernel/l3prop.dtx
+++ b/l3kernel/l3prop.dtx
@@ -339,6 +339,10 @@
 %
 % \section{Mapping to property lists}
 %
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
+%
 % \begin{function}[updated = 2013-01-08, rEXP]
 %   {\prop_map_function:NN, \prop_map_function:cN}
 %   \begin{syntax}
diff --git a/l3kernel/l3seq.dtx b/l3kernel/l3seq.dtx
index 9b57df586..eb6da6501 100644
--- a/l3kernel/l3seq.dtx
+++ b/l3kernel/l3seq.dtx
@@ -486,6 +486,10 @@
 %
 % \section{Mapping to sequences}
 %
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
+%
 % \begin{function}[rEXP, updated = 2012-06-29]
 %   {\seq_map_function:NN, \seq_map_function:cN}
 %   \begin{syntax}
diff --git a/l3kernel/l3str.dtx b/l3kernel/l3str.dtx
index 437ca6caa..d769fe77c 100644
--- a/l3kernel/l3str.dtx
+++ b/l3kernel/l3str.dtx
@@ -401,6 +401,10 @@
 %
 % \section{Mapping to strings}
 %
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
+%
 % \begin{function}[added = 2017-11-14, rEXP]
 %   {\str_map_function:NN, \str_map_function:cN}
 %   \begin{syntax}
@@ -1275,6 +1279,10 @@
 %   times speed up by testing only every $9$-th character for whether it
 %   is \cs{q_recursion_tail} (also by converting $9$ spaces at a time in
 %   the \cs{str_map_function:nN} case).
+%
+%   For the \texttt{map_variable} functions we use a string assignment
+%   to store each character because spaces are made catcode~$12$ before
+%   the loop.
 %    \begin{macrocode}
 \cs_new:Npn \str_map_function:nN #1#2
   {
diff --git a/l3kernel/l3tl-analysis.dtx b/l3kernel/l3tl-analysis.dtx
index d75531e26..0195588dd 100644
--- a/l3kernel/l3tl-analysis.dtx
+++ b/l3kernel/l3tl-analysis.dtx
@@ -88,6 +88,9 @@
 %       parameter, 7: superscript, 8: subscript, A: space, B: letter,
 %       C:other, D:active).
 %   \end{itemize}
+%   As all other mappings the mapping is done at the current group
+%   level, \emph{i.e.}~any local assignments made by the \meta{inline
+%   function} remain in effect after the loop.
 % \end{function}
 %
 % \end{documentation}
diff --git a/l3kernel/l3tl.dtx b/l3kernel/l3tl.dtx
index 939b9fcf1..836faaa7e 100644
--- a/l3kernel/l3tl.dtx
+++ b/l3kernel/l3tl.dtx
@@ -505,6 +505,10 @@
 %
 % \section{Mapping to token lists}
 %
+% All mappings are done at the current group level, \emph{i.e.}~any
+% local assignments made by the \meta{function} or \meta{code} discussed
+% below remain in effect after the loop.
+%
 % \begin{function}[updated = 2012-06-29, rEXP]
 %   {\tl_map_function:NN, \tl_map_function:cN}
 %   \begin{syntax}