[latex3-commits] [l3svn] r7220 - Document that \tl_case etc stop once they find a matching case

[noreply at latex-project.org]

Author: bruno
Date: 2017-05-30 05:12:07 +0200 (Tue, 30 May 2017)
New Revision: 7220

Modified:
   trunk/l3kernel/l3int.dtx
   trunk/l3kernel/l3skip.dtx
   trunk/l3kernel/l3str.dtx
   trunk/l3kernel/l3tl.dtx
Log:
Document that \tl_case etc stop once they find a matching case

I came across this when reading an old StackExchange question
https://tex.stackexchange.com/questions/133619/


Modified: trunk/l3kernel/l3int.dtx
===================================================================
--- trunk/l3kernel/l3int.dtx	2017-05-29 19:34:21 UTC (rev 7219)
+++ trunk/l3kernel/l3int.dtx	2017-05-30 03:12:07 UTC (rev 7220)
@@ -350,7 +350,8 @@
 %   This function evaluates the \meta{test integer expression} and
 %   compares this in turn to each of the
 %   \meta{integer expression cases}. If the two are equal then the
-%   associated \meta{code} is left in the input stream. If any of the
+%   associated \meta{code} is left in the input stream
+%   and other cases are discarded. If any of the
 %   cases are matched, the \meta{true code} is also inserted into the
 %   input stream (after the code for the appropriate case), while if none
 %   match then the \meta{false code} is inserted. The function

Modified: trunk/l3kernel/l3skip.dtx
===================================================================
--- trunk/l3kernel/l3skip.dtx	2017-05-29 19:34:21 UTC (rev 7219)
+++ trunk/l3kernel/l3skip.dtx	2017-05-30 03:12:07 UTC (rev 7220)
@@ -267,7 +267,8 @@
 %   This function evaluates the \meta{test dimension expression} and
 %   compares this in turn to each of the
 %   \meta{dimension expression cases}. If the two are equal then the
-%   associated \meta{code} is left in the input stream. If any of the
+%   associated \meta{code} is left in the input stream
+%   and other cases are discarded. If any of the
 %   cases are matched, the \meta{true code} is also inserted into the
 %   input stream (after the code for the appropriate case), while if none
 %   match then the \meta{false code} is inserted. The function

Modified: trunk/l3kernel/l3str.dtx
===================================================================
--- trunk/l3kernel/l3str.dtx	2017-05-29 19:34:21 UTC (rev 7219)
+++ trunk/l3kernel/l3str.dtx	2017-05-30 03:12:07 UTC (rev 7220)
@@ -264,8 +264,8 @@
 %   \end{syntax}
 %   This function compares the \meta{test string} in turn with each
 %   of the \meta{string cases}. If the two are equal (as described for
-%   \cs{str_if_eq:nnTF} then the
-%   associated \meta{code} is left in the input stream. If any of the
+%   \cs{str_if_eq:nnTF} then the associated \meta{code} is left in the
+%   input stream and other cases are discarded. If any of the
 %   cases are matched, the \meta{true code} is also inserted into the
 %   input stream (after the code for the appropriate case), while if none
 %   match then the \meta{false code} is inserted. The function
@@ -288,7 +288,8 @@
 %   This function compares the full expansion of the \meta{test string}
 %   in turn with the full expansion of the \meta{string cases}. If the two
 %   full expansions are equal (as described for \cs{str_if_eq:nnTF} then the
-%   associated \meta{code} is left in the input stream.  If any of the
+%   associated \meta{code} is left in the input stream
+%   and other cases are discarded.  If any of the
 %   cases are matched, the \meta{true code} is also inserted into the
 %   input stream (after the code for the appropriate case), while if none
 %   match then the \meta{false code} is inserted. The function

Modified: trunk/l3kernel/l3tl.dtx
===================================================================
--- trunk/l3kernel/l3tl.dtx	2017-05-29 19:34:21 UTC (rev 7219)
+++ trunk/l3kernel/l3tl.dtx	2017-05-30 03:12:07 UTC (rev 7220)
@@ -475,7 +475,7 @@
 %   with each of the \meta{token list variable cases}. If the two
 %   are equal (as described for \cs{tl_if_eq:NNTF})
 %   then the associated \meta{code} is left in the input
-%   stream. If any of the
+%   stream and other cases are discarded. If any of the
 %   cases are matched, the \meta{true code} is also inserted into the
 %   input stream (after the code for the appropriate case), while if none
 %   match then the \meta{false code} is inserted. The function