[latex3-commits] [git/LaTeX3-latex3-latex3] morechk: document \cs_use:N (573d6aa)

[Will Robertson]

Repository : https://github.com/latex3/latex3
On branch  : morechk
Link       : https://github.com/latex3/latex3/commit/573d6aa88a3c4fa4f717404bcf52d35318fcdc7d

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

commit 573d6aa88a3c4fa4f717404bcf52d35318fcdc7d
Author: Will Robertson <wspr81 at gmail.com>
Date:   Mon Jan 14 15:07:10 2019 +0800

    document \cs_use:N
    
    (improvements welcome)


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

573d6aa88a3c4fa4f717404bcf52d35318fcdc7d
 l3kernel/l3basics.dtx |   14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/l3kernel/l3basics.dtx b/l3kernel/l3basics.dtx
index bd0aa71..0576e1d 100644
--- a/l3kernel/l3basics.dtx
+++ b/l3kernel/l3basics.dtx
@@ -737,6 +737,20 @@
 %   \end{verbatim}
 %   after two expansions of \cs{use:c}.
 %
+% \begin{function}[EXP]{\cs_use:N, \cs_use:c, added = 2019-01-14}
+%   \begin{syntax}
+%     \cs{cs_use:N} \meta{control sequence}
+%     \cs{cs_use:c} \Arg{control sequence name}
+%   \end{syntax}
+%   The \texttt{N} variant places the \meta{control sequence} directly
+%   into the input stream.
+%   The \texttt{c} variant constructs the control sequence name as described for \cs{use:c}
+%   and does the same.
+%   Unlike \cs{use:c}, these functions check for the existence of the control sequence
+%   when the \texttt{check-declarations} option is in effect.
+%   This affords a level of safety when testing.
+% \end{function}
+%
 % \begin{function}[noTF, EXP, added = 2012-11-10]
 %   {\cs_if_exist_use:N, \cs_if_exist_use:c}
 %   \begin{syntax}