From a28e1bfccd6fe522fcd296426e4d89c7fb4f19b6 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 30 Apr 2018 22:39:09 +0000 Subject: l3 (30apr18) git-svn-id: svn://tug.org/texlive/trunk@47516 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/l3kernel/README.md | 2 +- Master/texmf-dist/doc/latex/l3kernel/expl3.pdf | Bin 585583 -> 585376 bytes .../texmf-dist/doc/latex/l3kernel/interface3.pdf | Bin 1546908 -> 1517866 bytes .../texmf-dist/doc/latex/l3kernel/interface3.tex | 2 +- .../texmf-dist/doc/latex/l3kernel/l3docstrip.pdf | Bin 263697 -> 263493 bytes .../texmf-dist/doc/latex/l3kernel/l3obsolete.txt | 6 +- .../texmf-dist/doc/latex/l3kernel/l3styleguide.pdf | Bin 280451 -> 280216 bytes .../texmf-dist/doc/latex/l3kernel/l3styleguide.tex | 2 +- .../doc/latex/l3kernel/l3syntax-changes.pdf | Bin 215877 -> 227950 bytes .../doc/latex/l3kernel/l3syntax-changes.tex | 86 ++++++++++++++++++++- Master/texmf-dist/doc/latex/l3kernel/source3.pdf | Bin 5281825 -> 5349698 bytes Master/texmf-dist/doc/latex/l3kernel/source3.tex | 2 +- .../texmf-dist/doc/latex/l3kernel/source3body.tex | 29 ++++--- 13 files changed, 112 insertions(+), 17 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 433e62cc34a..961e7f77c2e 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 2018/03/05 +Release 2018-04-30 Overview -------- diff --git a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf index be18c01edbf..29c314dbb5e 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 5c09697e2d7..6f38323a318 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/interface3.tex b/Master/texmf-dist/doc/latex/l3kernel/interface3.tex index 3b5f37b008b..370d56f9c9a 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/interface3.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/interface3.tex @@ -52,7 +52,7 @@ {latex-team@latex-project.org}% }% } -\date{Released 2018/03/05} +\date{Released 2018-04-30} \pagenumbering{roman} \maketitle diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf index 1bfa0e45d44..0b7c6fc147d 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/l3obsolete.txt b/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt index d29240218a9..85cef933ee2 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt +++ b/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt @@ -31,8 +31,12 @@ Function Expires end \iow_log_streams: 2018 \sort_ordered: 2018 \sort_reversed: 2018 +\tl_show_analysis:N 2019 +\tl_show_analysis:n 2019 \token_new:Nn 2018 ---------------------------------------- +Variants of n into N/c 2018 +Variants of N into n/o/V/v/f/x 2018 +-------------------------------------- Removed functions and variables =============================== diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf index 38e55417761..83577345a36 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 b882e95e9a7..d5a30013214 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex @@ -30,7 +30,7 @@ The released version of this bundle is available from CTAN. {latex-team@latex-project.org}% }% } -\date{Released 2018/03/05} +\date{Released 2018-04-30} \begin{document} diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.pdf index 6056efbb102..897ac4320e1 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/l3syntax-changes.tex b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex index 7476cbdb68d..d3eb59a1fd9 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex @@ -30,7 +30,7 @@ The released version of this bundle is available from CTAN. {latex-team@latex-project.org}% }% } -\date{Released 2018/03/05} +\date{Released 2018-04-30} \newcommand{\TF}{\textit{(TF)}} @@ -38,8 +38,13 @@ The released version of this bundle is available from CTAN. \maketitle -This file lists functions whose syntax has changed after August 2011, -with an approximate date. +This file describes functions that were expected to be completely +stable, but whose syntax has changed in ways that may potentially +require code relying on them to be changed. This file does not include +bug-fixes, nor backward-compatible extensions of the syntax, nor changes +to functions in \pkg{l3candidates}, nor functions that were completely +deprecated: the latter are listed in \texttt{l3obsolete.txt}. Only +changes after August 2011 are listed, with an approximate date. \section{August 2011} @@ -68,6 +73,16 @@ with an approximate date. now trim spaces from each item in the argument. \end{itemize} +\section{May 2012} + +\begin{itemize} + \item The \pkg{l3fp} code has been completely rewritten with a new + expandable interface. + \item Getting/popping from a comma list or sequence or property list + that is empty (or missing the given key) now gives the quark + \cs{q_no_value}. +\end{itemize} + \section{June 2012} \begin{itemize} @@ -97,5 +112,70 @@ with an approximate date. same way as for example \cs{str_if_eq_x:nn(TF)}. \end{itemize} +\section{December 2013} + +\begin{itemize} + \item In \pkg{l3fp} expressions, the badly named functions |round0|, + |round-|, |round+| are now named |trunc|, |floor|, |ceil|. +\end{itemize} + +\section{May 2014} + +\begin{itemize} + \item Now \cs{int_step_function:nnnN} evaluates its first three + arguments (start, step, stop) up front, rather than evaluating them + at each step in the loop. The same holds for the related mappings + \cs{int_step_inline:nnnn}, \cs{int_step_variable:nnnNn}, and their + analogues for \texttt{dim} and \texttt{fp} datatypes. +\end{itemize} + +\section{July 2014} + +\begin{itemize} + \item In \pkg{l3fp} expressions, juxtaposition is interpreted as + multiplication. Now the precedence of juxtaposition is set to be + the same as if there was an explicit multiplication + sign~\texttt{*}. Previously, juxtaposition would bound more tightly + than any other operation. +\end{itemize} + +\section{August 2015} + +\begin{itemize} + \item The \cs{hbox:n} and related \pkg{l3box} commands now take an + \texttt{n}-type argument and provide it braced to the underlying + \TeX{} primitive. The functions \cs{hbox:w} and \cs{hbox_end:} in + contrast do not read the contents of the box as a macro argument. +\end{itemize} + +\section{2016} + +No change. + +\section{July 2017} + +\begin{itemize} + \item Boolean expressions are now evaluated eagerly, namely both + operands of logical \texttt{and} (|&&|) and \texttt{or} (\verb"||") + are evaluated even when the result of the logical operation is fixed + after determining the first operand. For lazy evaluation, + \cs{bool_lazy_and_p:nn} and related functions are provided. +\end{itemize} + +\section{November 2017} + +\begin{itemize} + \item Spaces are now preserved inside keys in \pkg{l3keys}, and + trimmed at both ends. + \item \cs{cs_generate_variant:Nn} is now stricter: it only allows to + change \texttt{N}-type arguments to \texttt{c}, and \texttt{n} to + \texttt{o}, \texttt{V}, \texttt{v}, \texttt{f}, \texttt{x}. On the + one hand the latter argument types typically give rise to more than + one token, not suitable for use by an \texttt{N}-type base function. + On the other hand, \texttt{c} variants of \texttt{n} arguments + should often be \texttt{v} variants (when the argument is eventually + evaluated) or mistakes where the programmer thought the base + function was \texttt{N}-type. +\end{itemize} \end{document} diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf index bdedcd96bd6..db77914d391 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/source3.tex b/Master/texmf-dist/doc/latex/l3kernel/source3.tex index 6aea778860d..7fe47853b07 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3.tex @@ -51,7 +51,7 @@ {latex-team@latex-project.org}% }% } -\date{Released 2018/03/05} +\date{Released 2018-04-30} \pagenumbering{roman} \maketitle diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex index 57c36a4c4fd..029c19ae2fa 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex @@ -335,9 +335,14 @@ without repetition, this information is given in a shortened form: \begin{syntax} |\sys_if_engine_xetex:TF| \Arg{true code} \Arg{false code} \end{syntax} - The underlining and italic of \texttt{TF} indicates that - |\sys_if_engine_xetex:T|, |\sys_if_engine_xetex:F| and - |\sys_if_engine_xetex:TF| are all available. Usually, the illustration + The underlining and italic of \texttt{TF} indicates that three functions + are available: + \begin{itemize} + \item |\sys_if_engine_xetex:T| + \item |\sys_if_engine_xetex:F| + \item |\sys_if_engine_xetex:TF| + \end{itemize} + Usually, the illustration will use the \texttt{TF} variant, and so both \meta{true code} and \meta{false code} will be shown. The two variant forms \texttt{T} and \texttt{F} take only \meta{true code} and \meta{false code}, respectively. @@ -402,16 +407,19 @@ used on top of \LaTeXe{} if \cs{outer} tokens are used in the arguments. \DocInput{l3bootstrap.dtx} \DocInput{l3names.dtx} +\ExplSyntaxOn +\clist_gput_right:Nn \g_docinput_clist { l3kernel-functions.dtx } +\ExplSyntaxOff \DocInput{l3basics.dtx} \DocInput{l3expan.dtx} \DocInput{l3tl.dtx} \DocInput{l3str.dtx} +\DocInput{l3quark.dtx} \DocInput{l3seq.dtx} \DocInput{l3int.dtx} -\DocInput{l3intarray.dtx} \DocInput{l3flag.dtx} -\DocInput{l3quark.dtx} \DocInput{l3prg.dtx} +\DocInput{l3sys.dtx} \DocInput{l3clist.dtx} \DocInput{l3token.dtx} \DocInput{l3prop.dtx} @@ -441,17 +449,20 @@ used on top of \LaTeXe{} if \cs{outer} tokens are used in the arguments. } \ExplSyntaxOff +\DocInput{l3intarray.dtx} \DocInput{l3sort.dtx} -\DocInput{l3tl-build.dtx} \DocInput{l3tl-analysis.dtx} \DocInput{l3regex.dtx} \DocInput{l3box.dtx} \DocInput{l3coffins.dtx} \DocInput{l3color-base.dtx} -\DocInput{l3sys.dtx} -\DocInput{l3deprecation.dtx} -\DocInput{l3candidates.dtx} \DocInput{l3luatex.dtx} +\DocInput{l3unicode.dtx} +\DocInput{l3candidates.dtx} \DocInput{l3drivers.dtx} +\ExplSyntaxOn +\clist_gput_right:Nn \g_docinput_clist { l3deprecation.dtx } +\ExplSyntaxOff + \endinput -- cgit v1.2.3