summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3kernel/expl3.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/expl3.dtx')
-rw-r--r--Master/texmf-dist/source/latex/l3kernel/expl3.dtx74
1 files changed, 38 insertions, 36 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/expl3.dtx b/Master/texmf-dist/source/latex/l3kernel/expl3.dtx
index f001b8c12c1..84f7141bb7c 100644
--- a/Master/texmf-dist/source/latex/l3kernel/expl3.dtx
+++ b/Master/texmf-dist/source/latex/l3kernel/expl3.dtx
@@ -21,7 +21,7 @@
% for those people who are interested.
%
%<*driver|generic|package>
-\def\ExplFileDate{2018/03/05}%
+\def\ExplFileDate{2018-04-30}%
%</driver|generic|package>
%<*driver>
\documentclass[full]{l3doc}
@@ -49,7 +49,7 @@
% }^^A
% }
%
-% \date{Released 2018/03/05}
+% \date{Released 2018-04-30}
%
% \maketitle
%
@@ -575,11 +575,11 @@
% arguments before passing it to the base function:
% \begin{description}
% \item[c] Character string used as a command name.\\ The argument (a
-% token or braced token list) must, when fully expanded, produce a
-% sequence of characters which is then used to construct a command
-% name (\emph{via}~\tn{csname} \ldots \tn{endcsname}).
-% This command name is the
-% single token that is passed to the function as the argument. Hence
+% token or braced token list) is \emph{fully expanded}; the result
+% must be a sequence of characters which is then used to construct a
+% command name (\emph{via}~\tn{csname} \ldots \tn{endcsname}). This
+% command name is a single token that is passed to the function as
+% the argument. Hence
% \begin{quote}
% \cs{seq_gpush:cV} |{ g_file_name_seq }| \cs{l_tmpa_tl}
% \end{quote}
@@ -587,8 +587,7 @@
% \begin{quote}
% \cs{seq_gpush:NV} |\g_file_name_seq| \cs{l_tmpa_tl}.
% \end{quote}
-% Remember that \texttt{c} arguments are \emph{fully expanded} by
-% \TeX{} when creating csnames. This means that (a) the entire
+% Full expansion means that (a) the entire
% argument must be expandable and (b) any variables are
% converted to their content. So the preceding examples are also
% equivalent to
@@ -599,21 +598,23 @@
% \end{quote}
% (Token list variables are expandable and we could omit the
% accessor function \cs{tl_use:N}. Other variable types require the
-% appropriate \cs{<var>_use:N} functions to be used in this
+% appropriate \cs{\meta{var}_use:N} functions to be used in this
% context.)
% \item[V] Value of a variable.\\
-% This means that the contents of the register in question is used as the
-% argument, be it an integer, a length-type register, a token list variable
-% or similar. The value is passed to the function as a braced token list.
-% Can be applied to variables which have a \cs{\meta{var}_use:N} function,
-% and which therefore deliver a single \enquote{value}.
+% This means that the contents of the register in question is used
+% as the argument, be it an integer, a length-type register, a token
+% list variable or similar. The value is passed to the function as a
+% braced token list. Can be applied to variables which have a
+% \cs{\meta{var}_use:N} function (other than floating points and
+% boxes), and which therefore deliver a single \enquote{value}.
% \item[v] Value of a register, constructed from a character string
% used as a command name.\\
% This is a combination of |c| and |V| which first constructs a
-% control sequence from the argument and then passes the value of the
-% resulting register to the function.
-% Can be applied to variables which have a \cs{\meta{var}_use:N} function,
-% and which therefore deliver a single \enquote{value}.
+% control sequence from the argument and then passes the value of
+% the resulting register to the function. Can be applied to
+% variables which have a \cs{\meta{var}_use:N} function (other than
+% floating points and boxes), and which therefore deliver a single
+% \enquote{value}.
% \item[x] Fully-expanded token or braced token list.\\
% This means that the argument is expanded as in the replacement
% text of an~\tn{edef}, and the expansion is passed to the function as
@@ -920,15 +921,16 @@
% which are constructed using macros as the underlying storage system. The
% \texttt{check-declarations} option enables checking for all variable
% assignments, issuing an error if any variables are assigned without being
-% initialised. See also the function \cs{debug_check_declarations_on:}.
+% initialised.
+% See also \cs{debug_on:n} \texttt{\{check-declarations\}} for finer control.
%
% \DescribeOption{log-functions}
% The \texttt{log-functions} option is used to enable recording of every new
% function name in the \texttt{.log} file. This is useful for debugging
% purposes, as it means that there is a complete list of all functions
% created by each module loaded (with the exceptions of a very small number
-% required by the bootstrap code for \LaTeX3). See also the function
-% \cs{debug_log_functions_on:}.
+% required by the bootstrap code for \LaTeX3).
+% See also \cs{debug_on:n} \texttt{\{log-functions\}} for finer control.
%
% \DescribeOption{enable-debug}
% To allow more localized checking and logging than provided by
@@ -998,7 +1000,7 @@
% \item \pdfTeX{} v1.40 or later.
% \item \XeTeX{} v0.9994 or later.
% \item \LuaTeX{} v0.70 or later.
-% \item e-(u)p\TeX{} mid-2012 or later.
+% \item e-(u)\pTeX{} mid-2012 or later.
% \end{itemize}
%
% Additional modules beyond the core of \pkg{expl3} may require additional
@@ -1207,13 +1209,13 @@
\DeclareOption{#1=false}{\chardef #2=0 }%
\newcommand*#2{}%
\chardef #2=0 %
- }
+ }%
\expl@create@bool@option{check-declarations}\l@expl@check@declarations@bool
\expl@create@bool@option{log-functions}\l@expl@log@functions@bool
\expl@create@bool@option{enable-debug}\l@expl@enable@debug@bool
\let\expl@create@bool@option\@undefined
\chardef\l@expl@enable@debug@bool=0 %
-\newcommand*\l@expl@options@clist{}
+\newcommand*\l@expl@options@clist{}%
\DeclareOption*
{%
\ifx\l@expl@options@clist\@empty
@@ -1224,7 +1226,7 @@
\expandafter\expandafter\expandafter
{\expandafter\l@expl@options@clist\expandafter,\CurrentOption}
\fi
- }
+ }%
\ProcessOptions\relax
\ifodd\l@expl@check@declarations@bool
\chardef\l@expl@enable@debug@bool=1 %
@@ -1249,23 +1251,23 @@
{%
\ProvidesPackage{#1}[#2 \ifx\relax#3\relax\else v#3\space\fi #4]%
\ExplSyntaxOn
- }
+ }%
\protected\def\ProvidesExplClass#1#2#3#4%
{%
\ProvidesClass{#1}[#2 \ifx\relax#3\relax\else v#3\space\fi #4]%
\ExplSyntaxOn
- }
+ }%
\protected\def\ProvidesExplFile#1#2#3#4%
{%
\ProvidesFile{#1}[#2 \ifx\relax#3\relax\else v#3\space\fi #4]%
\ExplSyntaxOn
- }
+ }%
% \end{macrocode}
% \end{macro}
%
% Load the business end: this leaves \cs{expl3} syntax on.
% \begin{macrocode}
-\input{expl3-code.tex}
+\input{expl3-code.tex}%
% \end{macrocode}
%
% A check that the bootstrap code did not abort loading: if it did,
@@ -1472,8 +1474,8 @@
\hbox_set:Nn #1
{
\resizebox *
- { \__dim_eval:n {#2} }
- { \__dim_eval:n {#3} }
+ { \dim_eval:n {#2} }
+ { \dim_eval:n {#3} }
{ \box_use:N #1 }
}
}
@@ -1481,7 +1483,7 @@
{
\hbox_set:Nn #1
{
- \resizebox * { ! } { \__dim_eval:n {#2} }
+ \resizebox * { ! } { \dim_eval:n {#2} }
{ \box_use:N #1 }
}
}
@@ -1489,7 +1491,7 @@
{
\hbox_set:Nn #1
{
- \resizebox * { \__dim_eval:n {#2} } { ! }
+ \resizebox * { \dim_eval:n {#2} } { ! }
{ \box_use:N #1 }
}
}
@@ -1534,7 +1536,7 @@
% \begin{macrocode}
\tl_put_left:Nn \@pushfilename
{
- \exp_args:Nx \__file_input_push:n
+ \exp_args:Nx \__kernel_file_input_push:n
{
\tl_to_str:N \@currname
\tl_to_str:N \@currext
@@ -1559,7 +1561,7 @@
}
\tl_put_right:Nn \@popfilename
{
- \__file_input_pop:
+ \__kernel_file_input_pop:
\tl_if_empty:NTF \l__expl_status_stack_tl
{ \ExplSyntaxOff }
{ \exp_after:wN \__expl_status_pop:w \l__expl_status_stack_tl \q_stop }