[latex3-commits] [git/LaTeX3-latex3-latex3] main: Hint at \str_case_e:nn in \str_case:nn (aaffcc752)

[PhelypeOleinik]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/aaffcc752adb3f2f9626bded552506b9f61baa25

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

commit aaffcc752adb3f2f9626bded552506b9f61baa25
Author: PhelypeOleinik <phelype.oleinik at latex-project.org>
Date:   Wed Jun 15 01:32:27 2022 -0300

    Hint at \str_case_e:nn in \str_case:nn
    
    from #1097


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

aaffcc752adb3f2f9626bded552506b9f61baa25
 l3kernel/l3str.dtx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/l3kernel/l3str.dtx b/l3kernel/l3str.dtx
index f2c8fd1d3..020970654 100644
--- a/l3kernel/l3str.dtx
+++ b/l3kernel/l3str.dtx
@@ -305,6 +305,12 @@
 %   match then the \meta{false code} is inserted. The function
 %   \cs{str_case:nn}, which does nothing if there is no match, is also
 %   available.
+%
+%   This set of functions performs no expansion on each
+%   \meta{string~case} argument, so any variable in there will be
+%   compared as a string.  If expansion is needed in the
+%   \meta{string~cases}, then \cs[no-index]{str_case_e:nn(TF)} should
+%   be used instead.
 % \end{function}
 %
 % \begin{function}[added = 2018-06-19, EXP, noTF]{\str_case_e:nn}