[latex3-commits] [git/LaTeX3-latex3-latex3] master: Document that \token_to_str:N and \token_to_meaning:N apply to braces too (5d98ef0)

[Bruno Le Floch]

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

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

commit 5d98ef094bc44e513bb8ec88991b88624528d13f
Author: Bruno Le Floch <bruno at le-floch.fr>
Date:   Sun Apr 29 15:27:40 2018 -0400

    Document that \token_to_str:N and \token_to_meaning:N apply to braces too


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

5d98ef094bc44e513bb8ec88991b88624528d13f
 l3kernel/l3basics.dtx |    2 ++
 l3kernel/l3token.dtx  |    8 ++++++++
 2 files changed, 10 insertions(+)

diff --git a/l3kernel/l3basics.dtx b/l3kernel/l3basics.dtx
index 9c23b45..6b8e4a8 100644
--- a/l3kernel/l3basics.dtx
+++ b/l3kernel/l3basics.dtx
@@ -673,6 +673,8 @@
 %   control sequence. For a macro, this includes the \meta{replacement text}.
 %   \begin{texnote}
 %     This is \TeX{}'s \tn{meaning} primitive.
+%     For tokens that are not control sequences, it is more logical to
+%     use \cs{token_to_meaning:N}.
 %     The \texttt{c} variant correctly reports undefined arguments.
 %   \end{texnote}
 % \end{function}
diff --git a/l3kernel/l3token.dtx b/l3kernel/l3token.dtx
index c1eff60..2fedd9a 100644
--- a/l3kernel/l3token.dtx
+++ b/l3kernel/l3token.dtx
@@ -445,6 +445,10 @@
 %   as |macro|s.
 %   \begin{texnote}
 %     This is the \TeX{} primitive \tn{meaning}.
+%     The \meta{token} can thus be an explicit space tokens or an
+%     explicit begin-group or end-group character token (|{|~or~|}| when
+%     normal \TeX{} category codes apply) even though these are not
+%     valid \texttt{N}-type arguments.
 %   \end{texnote}
 % \end{function}
 %
@@ -459,6 +463,10 @@
 %   \meta{token}). This function requires only a single expansion.
 %   \begin{texnote}
 %     \cs{token_to_str:N} is the \TeX{} primitive \tn{string} renamed.
+%     The \meta{token} can thus be an explicit space tokens or an
+%     explicit begin-group or end-group character token (|{|~or~|}| when
+%     normal \TeX{} category codes apply) even though these are not
+%     valid \texttt{N}-type arguments.
 %   \end{texnote}
 % \end{function}
 %