diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/expl3.pdf | bin | 645900 -> 645306 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/interface3.pdf | bin | 1104102 -> 1103736 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf | bin | 265601 -> 267007 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf | bin | 200418 -> 200418 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/source3.pdf | bin | 2732784 -> 2781705 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/source3body.tex | 3 |
7 files changed, 17 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf Binary files differindex 3f8746e8f89..c43c9431b77 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf b/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf Binary files differindex e42c41d7046..e402f3670df 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf Binary files differindex b790e90356e..d631f182eb7 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex index c14d7d8eefd..4f63ed8fc70 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex @@ -1,6 +1,6 @@ \iffalse meta-comment -File l3styleguide.tex Copyright (C) 2011 The LaTeX3 Project +File l3styleguide.tex Copyright (C) 2011,202 The LaTeX3 Project It may be distributed and/or modified under the conditions of the LaTeX Project Public License (LPPL), either version 1.3c of this @@ -155,19 +155,30 @@ look like the example: \section{Code conventions} +All code-level functions should be \enquote{long} if they accept any +arguments, even if it seems \enquote{very unlikely} that a \cs{par} token. +will be passed. Thus \cs{cs_new_nopar:Npn} and so forth should only be used +to create functions which accept no arguments at all. + +The expandability of each function should be well-defined. Functions which +cannot be fully expanded must be \texttt{protected}. This means that expandable +functions must themselves only contain expandable material. Functions which +use any non-expandable material must be defined using \cs{cs_new_protected:Npn} +or similar. + When using \cs{cs_generate_variant:Nn}, group related variants together to make the pattern clearer. A common example is variants of a function which has an \texttt{N}-type first argument: -\begin{verbatim*} -\cs_generate_variant:Nn \foo:Nn { NV , No } -\cs_generate_variant:Nn \foo:Nn { c , cV , co } +\begin{verbatim} + \cs_generate_variant:Nn \foo:Nn { NV , No } + \cs_generate_variant:Nn \foo:Nn { c , cV , co } \end{verbatim*} There are cases where omitting braces from \texttt{o}-type arguments is desirable for performance reasons. This should only be done if the argument is a single token, thus for example \begin{verbatim} -\tl_set:No \l_some_tl \l_some_other_tl + \tl_set:No \l_some_tl \l_some_other_tl \end{verbatim} remains clear and can be used where appropriate. diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf Binary files differindex b9f9e36d9b1..144bbd62727 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf Binary files differindex df80fa30686..a48af7e1f7e 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex index 119886c86cb..bd618e6fa23 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex @@ -171,7 +171,7 @@ following argument specifiers: \item[\texttt{x}] The \texttt{x} specifier stands for \emph{exhaustive expansion}: every token in the argument is fully expanded until only unexpandable ones remain. The \TeX{} \tn{edef} primitive carries out - this type of expansion. Functions which feature an \texttt{x}-type + this type of expansion. Functions which feature an \texttt{x}-type argument are in general \emph{not} expandable, unless specifically noted. \item[\texttt{f}] The \texttt{f} specifier stands for \emph{full @@ -411,7 +411,6 @@ logical construct. \DocInput{l3box.dtx} \DocInput{l3coffins.dtx} \DocInput{l3color.dtx} -\DocInput{l3io.dtx} \DocInput{l3msg.dtx} \DocInput{l3keys.dtx} \DocInput{l3file.dtx} |