[latex3-commits] [l3svn] r6679 - Use new l3doc keys to get rid of all label warnings in l3kernel

noreply at latex-project.org noreply at latex-project.org
Thu Aug 18 22:54:06 CEST 2016


Author: bruno
Date: 2016-08-18 22:54:06 +0200 (Thu, 18 Aug 2016)
New Revision: 6679

Modified:
   trunk/l3kernel/l3basics.dtx
   trunk/l3kernel/l3candidates.dtx
   trunk/l3kernel/l3expan.dtx
   trunk/l3kernel/l3file.dtx
   trunk/l3kernel/l3fp-parse.dtx
   trunk/l3kernel/l3fp.dtx
   trunk/l3kernel/l3int.dtx
   trunk/l3kernel/l3keys.dtx
   trunk/l3kernel/l3luatex.dtx
   trunk/l3kernel/l3names.dtx
   trunk/l3kernel/l3prg.dtx
   trunk/l3kernel/l3quark.dtx
   trunk/l3kernel/l3skip.dtx
   trunk/l3kernel/l3str.dtx
   trunk/l3kernel/l3tl.dtx
   trunk/l3kernel/source3body.tex
Log:
Use new l3doc keys to get rid of all label warnings in l3kernel

The doc should now build with only Overfull/Underfull hbox
warnings, but no label warning (neither missing label nor
label multiply defined).  This commit also gets rid of some
meaningless index entries, but that task is not complete.


Modified: trunk/l3kernel/l3basics.dtx
===================================================================
--- trunk/l3kernel/l3basics.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3basics.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -1418,7 +1418,8 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}[EXP]{\token_to_meaning:c, \token_to_str:c, \cs_meaning:c}
+% \begin{macro}[EXP, documented-as=\token_to_meaning:N]
+%   {\token_to_meaning:c, \token_to_str:c, \cs_meaning:c}
 %   A small number of variants defined by hand.
 %   Some of the necessary functions
 %   (\cs{use_i:nn}, \cs{use_ii:nn}, and \cs{exp_args:NNc}) are not
@@ -2292,7 +2293,7 @@
 %    allow us to generate error messages. The definitions here are
 %    only temporary, they will be redefined later on.
 %
-% \begin{macro}{\iow_log:x, \iow_term:x}
+% \begin{macro}[documented-as=\iow_log:n]{\iow_log:x, \iow_term:x}
 %    We define a routine to write only to the log file. And a
 %    similar one for writing to both the log file and the terminal.
 %    These will be redefined later by \pkg{l3io}.
@@ -2485,7 +2486,7 @@
 % \end{macro}
 % \end{macro}
 %
-% \begin{macro}
+% \begin{macro}[documented-as=\cs_set_nopar:Npn]
 %   {
 %     \cs_set_nopar:cpn  , \cs_set_nopar:cpx  ,
 %     \cs_gset_nopar:cpn , \cs_gset_nopar:cpx ,
@@ -2513,7 +2514,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}
+% \begin{macro}[documented-as=\cs_set:Npn]
 %   {
 %     \cs_set:cpn  , \cs_set:cpx  ,
 %     \cs_gset:cpn , \cs_gset:cpx ,
@@ -2531,7 +2532,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}
+% \begin{macro}[documented-as=\cs_set_protected_nopar:Npn]
 %   {
 %     \cs_set_protected_nopar:cpn  , \cs_set_protected_nopar:cpx  ,
 %     \cs_gset_protected_nopar:cpn , \cs_gset_protected_nopar:cpx ,
@@ -2549,7 +2550,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}
+% \begin{macro}[documented-as=\cs_set_protected:Npn]
 %   {
 %     \cs_set_protected:cpn  , \cs_set_protected:cpx  ,
 %     \cs_gset_protected:cpn , \cs_gset_protected:cpx ,
@@ -2834,7 +2835,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}
+% \begin{macro}[documented-as=\cs_set:Nn]
 %   {
 %     \cs_set:cn                  , \cs_set:cx                  ,
 %     \cs_set_nopar:cn            , \cs_set_nopar:cx            ,

Modified: trunk/l3kernel/l3candidates.dtx
===================================================================
--- trunk/l3kernel/l3candidates.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3candidates.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -2957,7 +2957,8 @@
 % appropriate data extracted from the Unicode documentation (either manually
 % or automatically).
 %
-% \begin{macro}[EXP]{\tl_if_head_eq_catcode:oNTF}
+% \begin{macro}[EXP, documented-as=\tl_if_head_eq_catcode:nNTF]
+%   {\tl_if_head_eq_catcode:oNTF}
 %   Extra variants.
 %    \begin{macrocode}
 \cs_generate_variant:Nn \tl_if_head_eq_catcode:nNTF { o }

Modified: trunk/l3kernel/l3expan.dtx
===================================================================
--- trunk/l3kernel/l3expan.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3expan.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -462,8 +462,8 @@
 %
 % \begin{function}[EXP, updated = 2012-02-12]
 %   {
+%     \exp_last_unbraced:NV,
 %     \exp_last_unbraced:Nf,
-%     \exp_last_unbraced:NV,
 %     \exp_last_unbraced:No,
 %     \exp_last_unbraced:Nv,
 %     \exp_last_unbraced:Nco,
@@ -684,7 +684,7 @@
 %   in position 0 in the current font (typically ``\texttt`'')
 %   in the output without any error message!}
 %
-% \begin{function}[added=2015-08-23,EXP]
+% \begin{function}[added=2015-08-23, EXP, label = \exp_end_continue_f:w]
 %       {
 %         \exp:w ,
 %         \exp_end_continue_f:w
@@ -736,7 +736,7 @@
 % \footnotetext{In this particular case you may get a character into
 %    the output as well as an error message.}
 %
-% \begin{function}[added=2015-08-23,EXP]
+% \begin{function}[added=2015-08-23, EXP, label = \exp_end_continue_f:nw]
 %       {
 %         \exp:w ,
 %         \exp_end_continue_f:nw

Modified: trunk/l3kernel/l3file.dtx
===================================================================
--- trunk/l3kernel/l3file.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3file.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -69,9 +69,9 @@
 % \begin{documentation}
 %
 % This module provides functions for working with external files. Some of these
-% functions apply to an entire file, and have prefix \cs{file_\ldots}, while
+% functions apply to an entire file, and have prefix \cs[no-index]{file_\ldots}, while
 % others are used to work with files on a line by line basis and have prefix
-% \cs{ior_\ldots} (reading) or \cs{iow_\ldots} (writing).
+% \cs[no-index]{ior_\ldots} (reading) or \cs[no-index]{iow_\ldots} (writing).
 %
 % It is important to remember that when reading external files \TeX{} will
 % attempt to locate them both the operating system path and entries in the
@@ -178,9 +178,9 @@
 %   \end{syntax}
 %   Globally reserves the name of the \meta{stream}, either for reading
 %   or for writing as appropriate. The \meta{stream} is not opened until
-%   the appropriate \cs{\ldots_open:Nn} function is used. Attempting to
+%   the appropriate \cs[no-index]{\ldots_open:Nn} function is used. Attempting to
 %   use a \meta{stream} which has not been opened is an error, and the
-%   \meta{stream} will behave as the corresponding \cs{c_term_\ldots}.
+%   \meta{stream} will behave as the corresponding \cs[no-index]{c_term_\ldots}.
 % \end{function}
 %
 % \begin{function}[updated = 2012-02-10]{\ior_open:Nn, \ior_open:cn}

Modified: trunk/l3kernel/l3fp-parse.dtx
===================================================================
--- trunk/l3kernel/l3fp-parse.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3fp-parse.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -2611,7 +2611,7 @@
 %
 % \subsection{Candidate: defining new \pkg{l3fp} functions}
 %
-% \begin{macro}[EXP]{\fp_function:Nw}
+% \begin{macro}[EXP,int]{\fp_function:Nw}
 %   Parse the argument of the function~|#1| using
 %   \cs{@@_parse_operand:Nw} with a precedence of~$16$, and pass the
 %   function and argument to \cs{@@_function_apply:nw}.
@@ -2626,7 +2626,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}{\fp_new_function:Npn}
+% \begin{macro}[int]{\fp_new_function:Npn}
 % \begin{macro}[aux]{\@@_new_function:NNnnn, \@@_new_function:Ncfnn}
 % \begin{macro}[aux]{\@@_function_args:Nwn}
 %   Save the code provided by the user in the control sequence

Modified: trunk/l3kernel/l3fp.dtx
===================================================================
--- trunk/l3kernel/l3fp.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3fp.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -125,7 +125,7 @@
 %   \item Constants: \texttt{pi}, \texttt{deg} (one degree in radians).
 %   \item Dimensions, automatically expressed in points, \emph{e.g.},
 %     \texttt{pc} is~$12$.
-%   \item Automatic conversion (no need for \cs{\meta{type}_use:N}) of
+%   \item Automatic conversion (no need for \cs[no-index]{\meta{type}_use:N}) of
 %     integer, dimension, and skip variables to floating points,
 %     expressing dimensions in points and ignoring the stretch and
 %     shrink components of skips.
@@ -793,7 +793,7 @@
 % a truth value, a floating point expression is \texttt{false} if it is
 % $\pm 0$, and \texttt{true} otherwise, including when it is \nan{}.
 %
-% \begin{function}[tested = m3fp-logic002]{?:}
+% \begin{function}[tested = m3fp-logic002, module = ]{?:}
 %   \begin{syntax}
 %     \cs{fp_eval:n} \{ \meta{operand_1} |?| \meta{operand_2} |:| \meta{operand_3} \}
 %   \end{syntax}
@@ -876,7 +876,7 @@
 %   and \enquote{overflow} occur when appropriate.
 % \end{function}
 %
-% \begin{function}[tested = m3fp-basics004]{+, -, !}
+% \begin{function}[tested = m3fp-basics004, label = !]{+, -, !}
 %   \begin{syntax}
 %     \cs{fp_eval:n} \{ |+| \meta{operand} \}
 %     \cs{fp_eval:n} \{ |-| \meta{operand} \}

Modified: trunk/l3kernel/l3int.dtx
===================================================================
--- trunk/l3kernel/l3int.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3int.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -1546,8 +1546,8 @@
 %    \end{macrocode}
 % \end{macro}
 %
+% \begin{macro}[EXP, TF]{\int_case:nn}
 % \begin{macro}[EXP]{\int_case:nn}
-% \begin{macro}[EXP, TF]{\int_case:nn}
 % \begin{macro}[aux]{\@@_case:nnTF}
 % \begin{macro}[aux]{\@@_case:nw, \@@_case_end:nw}
 %   For integer cases, the first task to fully expand the check

Modified: trunk/l3kernel/l3keys.dtx
===================================================================
--- trunk/l3kernel/l3keys.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3keys.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -1360,7 +1360,7 @@
 %   current scope but exists at a higher level, we do not use \cs{prop_new:c}
 %   but rather \cs{prop_set_eq:cN}. The function \cs{__chk_log:x} only
 %   writes to the log file if logging all new functions is active: without
-%   it keys would not show up (as we are not using \cs{..._new}).
+%   it keys would not show up (as we are not using \cs[no-index]{..._new}).
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_ensure_exist:n #1
   {
@@ -2468,7 +2468,7 @@
 %
 % \subsection{Deprecated functions}
 %
-% \begin{macro}{.value_forbidden:}
+% \begin{macro}[deprecated = 2017]{.value_forbidden:}
 % \begin{macro}{.value_required:}
 %   Deprecated 2015-07-14.
 %    \begin{macrocode}

Modified: trunk/l3kernel/l3luatex.dtx
===================================================================
--- trunk/l3kernel/l3luatex.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3luatex.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -242,7 +242,7 @@
 %<*lua>
 %    \end{macrocode}
 %
-% \begin{macro}{l3kernel}
+% \begin{macro}[int]{l3kernel}
 %   Create a table for the kernel's own use.
 %    \begin{macrocode}
 l3kernel = l3kernel or { }
@@ -258,7 +258,7 @@
 local unicode_utf8_char = unicode.utf8.char
 %    \end{macrocode}
 %
-% \begin{macro}{l3kernel.strcmp}
+% \begin{macro}[int]{l3kernel.strcmp}
 %   String comparison which gives the same results as \pdfTeX{}'s
 %   \tn{pdfstrcmp}, although the ordering should likely not be relied upon!
 %    \begin{macrocode}
@@ -275,7 +275,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}{l3kernel.charcat}
+% \begin{macro}[int]{l3kernel.charcat}
 %   Creating arbitrary chars needs a category code table. As set up here,
 %   one may have been assigned earlier (see \pkg{l3bootstrap}) or a hard-coded
 %   one is used. The latter is intended for format mode and should be adjusted

Modified: trunk/l3kernel/l3names.dtx
===================================================================
--- trunk/l3kernel/l3names.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3names.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -112,7 +112,7 @@
 % names. In format mode, it also deletes all of the existing names (although
 % some do come back later).
 %
-% \begin{macro}{\tex_undefined:D}
+% \begin{macro}[int]{\tex_undefined:D}
 %   This function does not exist at all, but is the name used by the
 %   plain \TeX{} format for an undefined function. So it should
 %   be marked here as \enquote{taken}.

Modified: trunk/l3kernel/l3prg.dtx
===================================================================
--- trunk/l3kernel/l3prg.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3prg.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -101,8 +101,8 @@
 %     \prg_new_conditional:Nnn,  \prg_set_conditional:Nnn
 %    }
 %   \begin{syntax}
-%     \cs{prg_new_conditional:Npnn} \cs{\meta{name}:\meta{arg spec}} \meta{parameters} \Arg{conditions} \Arg{code} \\
-%     \cs{prg_new_conditional:Nnn} \cs{\meta{name}:\meta{arg spec}} \Arg{conditions} \Arg{code}
+%     \cs{prg_new_conditional:Npnn} \cs[no-index]{\meta{name}:\meta{arg spec}} \meta{parameters} \Arg{conditions} \Arg{code} \\
+%     \cs{prg_new_conditional:Nnn} \cs[no-index]{\meta{name}:\meta{arg spec}} \Arg{conditions} \Arg{code}
 %   \end{syntax}
 %   These functions create a family of conditionals using the same
 %   \Arg{code} to perform the test created. Those conditionals are
@@ -121,8 +121,8 @@
 %     \prg_new_protected_conditional:Nnn,  \prg_set_protected_conditional:Nnn
 %   }
 %   \begin{syntax}
-%     \cs{prg_new_protected_conditional:Npnn} \cs{\meta{name}:\meta{arg spec}} \meta{parameters} \Arg{conditions} \Arg{code} \\
-%     \cs{prg_new_protected_conditional:Nnn} \cs{\meta{name}:\meta{arg spec}} \Arg{conditions} \Arg{code}
+%     \cs{prg_new_protected_conditional:Npnn} \cs[no-index]{\meta{name}:\meta{arg spec}} \meta{parameters} \Arg{conditions} \Arg{code} \\
+%     \cs{prg_new_protected_conditional:Nnn} \cs[no-index]{\meta{name}:\meta{arg spec}} \Arg{conditions} \Arg{code}
 %   \end{syntax}
 %   These functions create a family of protected conditionals using the
 %   same \Arg{code} to perform the test created. The \meta{code} does
@@ -138,21 +138,21 @@
 % The conditionals are defined by \cs{prg_new_conditional:Npnn} and
 % friends as:
 % \begin{itemize}
-%   \item \cs{\meta{name}_p:\meta{arg spec}} --- a predicate function
+%   \item \cs[no-index]{\meta{name}_p:\meta{arg spec}} --- a predicate function
 %     which will supply either a logical \texttt{true} or logical
 %     \texttt{false}. This function is intended for use in cases where
 %     one or more logical tests are combined to lead to a final outcome.
 %     This function cannot be defined for \texttt{protected}
 %     conditionals.
-%   \item \cs{\meta{name}:\meta{arg spec}T} --- a function with one more
+%   \item \cs[no-index]{\meta{name}:\meta{arg spec}T} --- a function with one more
 %     argument than the original \meta{arg spec} demands. The \meta{true
 %       branch} code in this additional argument will be left on the
 %     input stream only if the test is \texttt{true}.
-%   \item \cs{\meta{name}:\meta{arg spec}F} --- a function with one more
+%   \item \cs[no-index]{\meta{name}:\meta{arg spec}F} --- a function with one more
 %     argument than the original \meta{arg spec} demands. The
 %     \meta{false branch} code in this additional argument will be left
 %     on the input stream only if the test is \texttt{false}.
-%   \item \cs{\meta{name}:\meta{arg spec}TF} --- a function with two
+%   \item \cs[no-index]{\meta{name}:\meta{arg spec}TF} --- a function with two
 %     more argument than the original \meta{arg spec} demands. The
 %     \meta{true branch} code in the first additional argument will be
 %     left on the input stream if the test is \texttt{true}, while the
@@ -192,7 +192,7 @@
 %
 % \begin{function}{\prg_new_eq_conditional:NNn, \prg_set_eq_conditional:NNn}
 %   \begin{syntax}
-%     \cs{prg_new_eq_conditional:NNn} \cs{\meta{name_1}:\meta{arg spec_1}} \cs{\meta{name_2}:\meta{arg spec_2}} \Arg{conditions}
+%     \cs{prg_new_eq_conditional:NNn} \cs[no-index]{\meta{name_1}:\meta{arg spec_1}} \cs[no-index]{\meta{name_2}:\meta{arg spec_2}} \Arg{conditions}
 %   \end{syntax}
 %   These functions copy a family of conditionals. The \texttt{new} version
 %   will check for existing definitions (\emph{cf.}~\cs{cs_new:Npn}) whereas
@@ -297,7 +297,7 @@
 %     \cs{bool_set:Nn} \meta{boolean} \Arg{boolexpr}
 %   \end{syntax}
 %   Evaluates the \meta{boolean expression} as described for
-%   \cs{bool_if:n(TF)}, and sets the \meta{boolean} variable to
+%   \cs{bool_if:nTF}, and sets the \meta{boolean} variable to
 %   the logical truth of this evaluation.
 % \end{function}
 %
@@ -594,10 +594,10 @@
 %
 % \begin{function}[EXP]{\__prg_break_point:Nn}
 %   \begin{syntax}
-%     \cs{__prg_break_point:Nn} \cs{\meta{type}_map_break:} \meta{tokens}
+%     \cs{__prg_break_point:Nn} \cs[no-index]{\meta{type}_map_break:} \meta{tokens}
 %   \end{syntax}
 %   Used to mark the end of a recursion or mapping: the functions
-%   \cs{\meta{type}_map_break:} and \cs{\meta{type}_map_break:n} use
+%   \cs[no-index]{\meta{type}_map_break:} and \cs[no-index]{\meta{type}_map_break:n} use
 %   this to break out of the loop. After the loop ends, the
 %   \meta{tokens} are inserted into the input stream. This occurs even
 %   if the break functions are \emph{not} applied:
@@ -607,15 +607,15 @@
 %
 % \begin{function}[EXP]{\__prg_map_break:Nn}
 %   \begin{syntax}
-%     \cs{__prg_map_break:Nn} \cs{\meta{type}_map_break:} \Arg{user code}
+%     \cs{__prg_map_break:Nn} \cs[no-index]{\meta{type}_map_break:} \Arg{user code}
 %     \ldots{}
-%     \cs{__prg_break_point:Nn} \cs{\meta{type}_map_break:} \Arg{ending code}
+%     \cs{__prg_break_point:Nn} \cs[no-index]{\meta{type}_map_break:} \Arg{ending code}
 %   \end{syntax}
 %   Breaks a recursion in mapping contexts, inserting in the input
 %   stream the \meta{user code} after the \meta{ending code} for the
 %   loop.  The function breaks loops, inserting their \meta{ending
 %     code}, until reaching a loop with the same \meta{type} as its
-%   first argument.  This \cs{\meta{type}_map_break:} argument is simply
+%   first argument.  This \cs[no-index]{\meta{type}_map_break:} argument is simply
 %   used as a recognizable marker for the \meta{type}.
 % \end{function}
 %

Modified: trunk/l3kernel/l3quark.dtx
===================================================================
--- trunk/l3kernel/l3quark.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3quark.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -323,12 +323,12 @@
 %     \__quark_if_recursion_tail_break:nN
 %   }
 %   \begin{syntax}
-%     \cs{__quark_if_recursion_tail_break:nN} \Arg{token list} \cs{\meta{type}_map_break:}
+%     \cs{__quark_if_recursion_tail_break:nN} \Arg{token list} \cs[no-index]{\meta{type}_map_break:}
 %   \end{syntax}
 %   Tests if \meta{token list} contains only \cs{q_recursion_tail}, and
-%   if so terminates the recursion using \cs{\meta{type}_map_break:}.
+%   if so terminates the recursion using \cs[no-index]{\meta{type}_map_break:}.
 %   The recursion end should be marked by \cs{prg_break_point:Nn}
-%   \cs{\meta{type}_map_break:}.
+%   \cs[no-index]{\meta{type}_map_break:}.
 % \end{function}
 %
 % \section{Scan marks}

Modified: trunk/l3kernel/l3skip.dtx
===================================================================
--- trunk/l3kernel/l3skip.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3skip.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -1268,8 +1268,8 @@
 % \end{macro}
 % \end{macro}
 %
+% \begin{macro}[EXP, TF]{\dim_case:nn}
 % \begin{macro}[EXP]{\dim_case:nn}
-% \begin{macro}[EXP, TF]{\dim_case:nn}
 % \begin{macro}[aux]{\@@_case:nnTF}
 % \begin{macro}[aux]{\@@_case:nw, \@@_case_end:nw}
 %   For dimension cases, the first task to fully expand the check

Modified: trunk/l3kernel/l3str.dtx
===================================================================
--- trunk/l3kernel/l3str.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3str.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -764,7 +764,7 @@
 %
 % \begin{macro}[int, EXP]{\@@_if_eq_x:nn}
 % \begin{macro}[aux, EXP]{\@@_escape_x:n}
-%   String comparisons rely on the primitive \cs{(pdf)strcmp} if available:
+%   String comparisons rely on the primitive \cs[index=pdfstrcmp]{(pdf)strcmp} if available:
 %   \LuaTeX{} does not have it, so emulation is required. As the net result
 %   is that we do not \emph{always} use the primitive, the correct approach
 %   is to wrap up in a function with defined behaviour. That's done by
@@ -872,10 +872,10 @@
 %    \end{macrocode}
 % \end{macro}
 %
+% \begin{macro}[EXP, TF]
+%   {\str_case:nn, \str_case:on, \str_case:nV, \str_case:nv, \str_case_x:nn}
 % \begin{macro}[EXP]
 %   {\str_case:nn, \str_case:on, \str_case:nV, \str_case:nv, \str_case_x:nn}
-% \begin{macro}[EXP, TF]
-%   {\str_case:nn, \str_case:on, \str_case:nV, \str_case:nv, \str_case_x:nn}
 % \begin{macro}[EXP, aux]{\@@_case:nnTF, \@@_case_x:nnTF}
 % \begin{macro}[aux, EXP]
 %   {\@@_case:nw, \@@_case_x:nw, \@@_case_end:nw}

Modified: trunk/l3kernel/l3tl.dtx
===================================================================
--- trunk/l3kernel/l3tl.dtx	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/l3tl.dtx	2016-08-18 20:54:06 UTC (rev 6679)
@@ -1925,7 +1925,7 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}[pTF]{\tl_if_empty:o}
+% \begin{macro}[pTF,documented-as=\tl_if_empty:nTF]{\tl_if_empty:o}
 % \begin{macro}[EXP,aux]{\@@_if_empty_return:o}
 %   The auxiliary function \cs{@@_if_empty_return:o} is for use
 %   in various token list conditionals which reduce to testing
@@ -2082,8 +2082,8 @@
 % \end{macro}
 % \end{macro}
 %
+% \begin{macro}[EXP, TF]{\tl_case:Nn, \tl_case:cn}
 % \begin{macro}[EXP]{\tl_case:Nn, \tl_case:cn}
-% \begin{macro}[EXP, TF]{\tl_case:Nn, \tl_case:cn}
 % \begin{macro}[EXP, aux]{\@@_case:nnTF}
 % \begin{macro}[aux, EXP]{\@@_case:Nw}
 % \begin{macro}[int, EXP]{\__prg_case_end:nw}
@@ -2948,7 +2948,7 @@
 %
 % \subsection{Deprecated functions}
 %
-% \begin{macro}{\tl_to_lowercase:n, \tl_to_uppercase:n}
+% \begin{macro}[deprecated=2017-12-31]{\tl_to_lowercase:n, \tl_to_uppercase:n}
 %   For removal after 2017-12-31.
 %    \begin{macrocode}
 \cs_new_protected:Npn \tl_to_lowercase:n #1

Modified: trunk/l3kernel/source3body.tex
===================================================================
--- trunk/l3kernel/source3body.tex	2016-08-18 20:50:55 UTC (rev 6678)
+++ trunk/l3kernel/source3body.tex	2016-08-18 20:54:06 UTC (rev 6679)
@@ -279,7 +279,7 @@
 
 Each group of related functions is given in a box. For a function with
 a \enquote{user} name, this might read:
-\begin{function}[no-label]{\ExplSyntaxOn, \ExplSyntaxOff}
+\begin{function}[label = ]{\ExplSyntaxOn, \ExplSyntaxOff}
   \begin{syntax}
     |\ExplSyntaxOn| \dots{} |\ExplSyntaxOff|
   \end{syntax}
@@ -295,7 +295,7 @@
 \emph{variants} of each other, and the latter functions are printed in grey to
 show this more clearly. They will carry out the same function but will take
 different types of argument:
-\begin{function}[no-label]{\seq_new:N, \seq_new:c}
+\begin{function}[label = ]{\seq_new:N, \seq_new:c}
   \begin{syntax}
     |\seq_new:N| \meta{sequence}
   \end{syntax}
@@ -314,7 +314,7 @@
 as well as within an \texttt{f}-type argument.
 These fully expandable functions are indicated in the documentation by
 a star:
-\begin{function}[EXP,no-label]{\cs_to_str:N}
+\begin{function}[EXP, label = ]{\cs_to_str:N}
   \begin{syntax}
     |\cs_to_str:N| \meta{cs}
   \end{syntax}
@@ -328,7 +328,7 @@
 \hypertarget{rexpstar}{A few functions are fully expandable} but cannot be fully expanded within
 an \texttt{f}-type argument. In this case a hollow star is used to indicate
 this:
-\begin{function}[rEXP,no-label]{\seq_map_function:NN}
+\begin{function}[rEXP, label = ]{\seq_map_function:NN}
   \begin{syntax}
     |\seq_map_function:NN| \meta{seq} \meta{function}
   \end{syntax}
@@ -342,7 +342,7 @@
 depending on
 which outcome the conditional is being used to test. To indicate this
 without repetition, this information is given in a shortened form:
-\begin{function}[EXP,TF,no-label]{\xetex_if_engine:}
+\begin{function}[EXP,TF, label = ]{\xetex_if_engine:}
   \begin{syntax}
     |\xetex_if_engine:TF| \Arg{true code} \Arg{false code}
   \end{syntax}
@@ -358,7 +358,7 @@
 \end{function}
 
 Variables, constants and so on are described in a similar manner:
-\begin{variable}[no-label]{\l_tmpa_tl}
+\begin{variable}[label = ]{\l_tmpa_tl}
   A short piece of text will describe the variable: there is no
   syntax illustration in this case.
 \end{variable}
@@ -366,7 +366,7 @@
 In some cases, the function is similar to one in \LaTeXe{} or plain \TeX{}.
 In these cases, the text will include an extra \enquote{\textbf{\TeX{}hackers
 note}} section:
-\begin{function}[EXP,no-label]{\token_to_str:N}
+\begin{function}[EXP, label = ]{\token_to_str:N}
   \begin{syntax}
     |\token_to_str:N| \meta{token}
   \end{syntax}



More information about the latex3-commits mailing list