From 52b787d36c60fda90673669dd2809c95c1fdfca5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 19 Oct 2016 20:38:20 +0000 Subject: l3 (19oct16) git-svn-id: svn://tug.org/texlive/trunk@42306 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/l3kernel/README.md | 2 +- Master/texmf-dist/doc/latex/l3kernel/expl3.pdf | Bin 586814 -> 587139 bytes .../texmf-dist/doc/latex/l3kernel/interface3.pdf | Bin 1508559 -> 1486421 bytes .../texmf-dist/doc/latex/l3kernel/l3docstrip.pdf | Bin 268241 -> 268241 bytes .../texmf-dist/doc/latex/l3kernel/l3styleguide.pdf | Bin 276808 -> 280000 bytes .../texmf-dist/doc/latex/l3kernel/l3styleguide.tex | 7 +++++-- .../doc/latex/l3kernel/l3syntax-changes.pdf | Bin 220227 -> 220242 bytes Master/texmf-dist/doc/latex/l3kernel/source3.pdf | Bin 4742116 -> 4480476 bytes .../texmf-dist/doc/latex/l3kernel/source3body.tex | 16 ++++++++-------- 9 files changed, 14 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc/latex/l3kernel') diff --git a/Master/texmf-dist/doc/latex/l3kernel/README.md b/Master/texmf-dist/doc/latex/l3kernel/README.md index d336060a8dd..c4d6de44cbc 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/README.md +++ b/Master/texmf-dist/doc/latex/l3kernel/README.md @@ -1,7 +1,7 @@ LaTeX3 Programming Conventions ============================== -Release 2016/05/18 (r6512) +Release 2016/10/19 (r6730) Overview -------- diff --git a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf index 5ae07c3c9f4..897b97c1479 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf and b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf b/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf index e4caf34fb3c..d3d49079f29 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf and b/Master/texmf-dist/doc/latex/l3kernel/interface3.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf index 5b21e8ee241..9348e56c1c2 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf index ec441e38464..1d6b913d694 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex index 690168a4778..fc476fdaf44 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,2012,2015 The LaTeX3 Project +File l3styleguide.tex Copyright (C) 2011,2012,2015,2016 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 @@ -158,7 +158,10 @@ look like the example: 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. +to create interfaces at the document level (where trapping \cs{par} tokens +may be appropriate) or where comparison to other code known not to be +\enquote{long} is required (\emph{e.g.}~when working with mixed +\LaTeXe{}/\pkg{expl3} situations). The expandability of each function should be well-defined. Functions which cannot be fully expanded must be \texttt{protected}. This means that expandable diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf index 4ec9382d0de..4fa9b98d8e8 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf index c89a61b50e1..03d736f4a66 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf and b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex index 260d0248d4c..2b498b75757 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex @@ -279,7 +279,7 @@ A number of conventions are used here to make the documentation clearer. 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 @@ with identical names but different argument specifiers, these are termed \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} @@ -309,12 +309,12 @@ different types of argument: \paragraph{Fully expandable functions} \hypertarget{expstar}{Some functions are fully expandable}, -which allows it to be used within +which allows them to be used within an \texttt{x}-type argument (in plain \TeX{} terms, inside an \cs{edef}), 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 @@ a star: \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 @@ them to be used for different \enquote{true}/\enquote{false} branches, 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 @@ without repetition, this information is given in a shortened form: \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 @@ Variables, constants and so on are described in a similar manner: 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} -- cgit v1.2.3