[latex3-commits] [git/LaTeX3-latex3-latex3] main: Improve description of c-type argument (see #1065) (29bac921e)

[Joseph Wright]

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

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

commit 29bac921ec911974e3512e0a48e63f25ea9f25b3
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon Mar 21 12:54:17 2022 +0000

    Improve description of c-type argument (see #1065)


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

29bac921ec911974e3512e0a48e63f25ea9f25b3
 l3kernel/doc/source3body.tex |  4 +++-
 l3kernel/l3basics.dtx        |  7 -------
 l3kernel/l3expan.dtx         | 28 ----------------------------
 3 files changed, 3 insertions(+), 36 deletions(-)

diff --git a/l3kernel/doc/source3body.tex b/l3kernel/doc/source3body.tex
index a2e87856b..20e187536 100644
--- a/l3kernel/doc/source3body.tex
+++ b/l3kernel/doc/source3body.tex
@@ -207,7 +207,9 @@ following argument specifiers:
   \item[\texttt{c}] This means \emph{csname}, and indicates that the
     argument will be turned into a csname before being used. So
     |\foo:c| |{ArgumentOne}| will act in the same way as |\foo:N|
-    |\ArgumentOne|.
+    |\ArgumentOne|. All macros that appear in the argument are expanded.
+    An internal error will occur if the result of expansion inside
+    a \texttt{c}-type argument is not a series of character tokens.
   \item[\texttt{V} and \texttt{v}] These mean \emph{value
     of variable}. The \texttt{V} and \texttt{v} specifiers are used to
     get the content of a variable without needing to worry about the
diff --git a/l3kernel/l3basics.dtx b/l3kernel/l3basics.dtx
index 8f94eefe1..c4b2f98f8 100644
--- a/l3kernel/l3basics.dtx
+++ b/l3kernel/l3basics.dtx
@@ -727,13 +727,6 @@
 %   \meta{control sequence name} must, when fully expanded, consist of
 %   character tokens, typically a mixture of category code $10$ (space),
 %   $11$ (letter) and $12$ (other).
-%   \begin{texnote}
-%     Protected macros that appear in a \texttt{c}-type argument are
-%     expanded despite being protected; \cs{exp_not:n} also has no
-%     effect.  An internal error occurs if non-characters or active
-%     characters remain after full expansion, as the conversion to a
-%     control sequence is not possible.
-%   \end{texnote}
 % \end{function}
 %
 % As an example of the \cs{use:c} function, both
diff --git a/l3kernel/l3expan.dtx b/l3kernel/l3expan.dtx
index f84a0928d..8192410e5 100644
--- a/l3kernel/l3expan.dtx
+++ b/l3kernel/l3expan.dtx
@@ -331,13 +331,6 @@
 %
 %   The |:cc| variant constructs the \meta{function} name in the same
 %   manner as described for the \meta{tokens}.
-%   \begin{texnote}
-%     Protected macros that appear in a \texttt{c}-type argument are
-%     expanded despite being protected; \cs{exp_not:n} also has no
-%     effect.  An internal error occurs if non-characters or active
-%     characters remain after full expansion, as the conversion to a
-%     control sequence is not possible.
-%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[EXP]{\exp_args:No}
@@ -374,13 +367,6 @@
 %   recovered and placed inside braces into the input stream \emph{after}
 %   reinsertion of the \meta{function}. Thus the \meta{function} may take more
 %   than one argument: all others are left unchanged.
-%   \begin{texnote}
-%     Protected macros that appear in a \texttt{v}-type argument are
-%     expanded despite being protected; \cs{exp_not:n} also has no
-%     effect.  An internal error occurs if non-characters or active
-%     characters remain after full expansion, as the conversion to a
-%     control sequence is not possible.
-%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[EXP, added = 2018-05-15]{\exp_args:Ne}
@@ -683,13 +669,6 @@
 %   converts this into a control sequence.
 %   Further expansion of this control sequence is then inhibited using
 %   \cs{exp_not:N}.
-%   \begin{texnote}
-%     Protected macros that appear in a \texttt{c}-type argument are
-%     expanded despite being protected; \cs{exp_not:n} also has no
-%     effect.  An internal error occurs if non-characters or active
-%     characters remain after full expansion, as the conversion to a
-%     control sequence is not possible.
-%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[EXP]{\exp_not:n}
@@ -736,13 +715,6 @@
 %   name.
 %   The content of the \meta{variable} is recovered, and further
 %   expansion in |x|-type or \texttt{e}-type arguments is prevented using \cs{exp_not:n}.
-%   \begin{texnote}
-%     Protected macros that appear in a \texttt{v}-type argument are
-%     expanded despite being protected; \cs{exp_not:n} also has no
-%     effect.  An internal error occurs if non-characters or active
-%     characters remain after full expansion, as the conversion to a
-%     control sequence is not possible.
-%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[EXP]{\exp_not:e}