[latex3-commits] [latex3/latex3] develop: Extend docs for \int_case:nn(TF) (3a0109523)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : develop
Link       : https://github.com/latex3/latex3/commit/3a01095233c3175fa691e2d7ce6fde2da0bba4b3

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

commit 3a01095233c3175fa691e2d7ce6fde2da0bba4b3
Author: Joseph Wright <joseph at texdev.net>
Date:   Thu Sep 5 21:47:22 2024 +0100

    Extend docs for \int_case:nn(TF)
    
    See #1589.


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

3a01095233c3175fa691e2d7ce6fde2da0bba4b3
 l3kernel/l3int.dtx | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/l3kernel/l3int.dtx b/l3kernel/l3int.dtx
index 0d34fc6ef..53ce3e4cb 100644
--- a/l3kernel/l3int.dtx
+++ b/l3kernel/l3int.dtx
@@ -411,7 +411,8 @@
 %   \end{syntax}
 %   This function evaluates the \meta{test int expr} and
 %   compares this in turn to each of the
-%   \meta{int expr cases}. If the two are equal then the
+%   \meta{int expr cases} until a match is found.
+%   If the two are equal 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
@@ -430,6 +431,10 @@
 %       { No idea! }
 %   \end{verbatim}
 %   leaves \enquote{\texttt{Medium}} in the input stream.
+%   Since evaluation of the test expressions stops at the first
+%   successful case, the order of possible matches should normally
+%   be that the most likely are earlier: this will reduce the average
+%   steps required to complete expansion.
 % \end{function}
 %
 % \begin{function}[EXP,pTF]{\int_if_even:n, \int_if_odd:n}