diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex')
29 files changed, 75 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md b/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md index 9b2db54278e..d418810401c 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md +++ b/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md @@ -7,6 +7,31 @@ this project uses date-based 'snapshot' version identifiers. ## [Unreleased] +## [2023-05-22] + +### Added +- Rounded out the `\use_i:nn...` functions to cover all cases taking + one argument from up to nine arguments +- `\coffin_(g)reset_poles:N` +- `\dim_to_decimal_in_<unit>:n`, for `<unit>` types + `cc`, `cm`, `dd`, `in`, `mm` and `pc` +- `\int_if_zero:n(TF)` +- `\str_mdfive_hash:n` + +### Changed +- Remove `\noexpand` inside math mode in `\text_expand:n` +- Re-implement `\dim_to_decimal_in_bp:n` and + `\dim_to_decimal_in_unit:nn` to be re-entrant (issue \#954) + +### Fixed +- Omit `0123456789` from URL escaping (issue \#838) +- Leave implicit chars unchanged in `\text_expand:n` (issue \#874) +- Filtering/grouping applied to meta keys (issue \#940) +- Issue correct error message if `bool` key is set + incorrectly using `.initial:n` (issue \#1013) +- Set `\l_keys_key_str` in `.initial:n` (issue \#1013) +- Handling of implicit chars in `\text_purify:n` (issue \#1208) + ## [2023-05-15] ### Changed @@ -888,7 +913,7 @@ this project uses date-based 'snapshot' version identifiers. ## [2019-10-28] ### Fixed -- File searching when `\(pdf)filesize` is not available (fixes \#644) +- File searching when `\(pdf)filesize` is not available (issue \#644) ## [2019-10-27] @@ -988,7 +1013,7 @@ this project uses date-based 'snapshot' version identifiers. ## [2019-09-08] ### Fixed -- Missing internal variant (fixes \#624) +- Missing internal variant (issue \#624) ## [2019-09-05] @@ -1266,7 +1291,7 @@ this project uses date-based 'snapshot' version identifiers. ## [2018-10-19] ### Fixed -- Wrapping of text in messages, etc., for some line lengths (fixes \#491) +- Wrapping of text in messages, etc., for some line lengths (issue \#491) ## [2018-10-17] @@ -1281,7 +1306,7 @@ this project uses date-based 'snapshot' version identifiers. - `\msg_interrupt:nn`, `\msg_log:n` and `\msg_term:n` ### Fixed -- Handling of inheritance for choice keys (fixes \#483) +- Handling of inheritance for choice keys (issue \#483) ## [2018-09-24] @@ -1291,7 +1316,7 @@ this project uses date-based 'snapshot' version identifiers. `\peek_meaning_collect_inline:Nn` ### Fixed -- Handling of unknown keys when inheritance is active (fixes \#481) +- Handling of unknown keys when inheritance is active (issue \#481) ## [2018-08-23] @@ -1313,7 +1338,7 @@ this project uses date-based 'snapshot' version identifiers. ## [2018-06-01] ### Added -- `CHANGELOG.md` (fixes \#460) +- `CHANGELOG.md` (issue \#460) ### Fixed - Loading `expl3` with LuaTeX/XeTeX and certain letter tokens set @@ -1351,7 +1376,7 @@ this project uses date-based 'snapshot' version identifiers. - Several internal optimisations ### Fixed -- Expand boolean expression before calling `\chardef` (fixes \#461) +- Expand boolean expression before calling `\chardef` (issue \#461) ### Removed - Remove undocumented `\fp_function:Nw` and `\fp_new_function:Npn` @@ -1380,15 +1405,15 @@ this project uses date-based 'snapshot' version identifiers. the RNG - Make prg break functions public - Make scan marks mechanism public -- Make `\prg_do_nothing:` long rather than nopar (fixes \#455) +- Make `\prg_do_nothing:` long rather than nopar (issue \#455) - Several performance improvements - Documentation improvements ### Fixed - Only index TF, T, F functions together if they are `expl3` - functions (fixes \#453) + functions (issue \#453) - Make `\infty` and `\pi` into errors in fp expressions - (fixes \#357) + (issue \#357) ### Removed - Deprecated functions expiring at end of 2017 @@ -1407,7 +1432,8 @@ this project uses date-based 'snapshot' version identifiers. - Step functions have been added for dim variables, e.g. `\dim_step_inline:nnnn` -[Unreleased]: https://github.com/latex3/latex3/compare/2023-05-15...HEAD +[Unreleased]: https://github.com/latex3/latex3/compare/2023-05-22...HEAD +[2023-05-22]: https://github.com/latex3/latex3/compare/2023-05-15...2023-05-22 [2023-05-15]: https://github.com/latex3/latex3/compare/2023-05-11...2023-05-15 [2023-05-11]: https://github.com/latex3/latex3/compare/2023-05-05...2023-05-11 [2023-05-05]: https://github.com/latex3/latex3/compare/2023-04-20...2023-05-05 diff --git a/Master/texmf-dist/doc/latex/l3kernel/README.md b/Master/texmf-dist/doc/latex/l3kernel/README.md index 44bb66a2f77..dd571168c53 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 2023-05-15 +Release 2023-05-22 Overview -------- diff --git a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf Binary files differindex ae93ec68500..9d6d1226eca 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 84f53f8947f..e5733b848b0 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/interface3.tex b/Master/texmf-dist/doc/latex/l3kernel/interface3.tex index 7dea564c3f5..f20b8d2d998 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/interface3.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/interface3.tex @@ -62,7 +62,7 @@ for those people who are interested. {latex-team@latex-project.org}% }% } -\date{Released 2023-05-15} +\date{Released 2023-05-22} \pagenumbering{roman} \maketitle diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3doc.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3doc.pdf Binary files differindex a83c0c03df8..c87a4561565 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3doc.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3doc.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf Binary files differindex 1f63b514794..63e4c7157bf 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf Binary files differindex 71a9e6840e9..28d77fd1d60 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf Binary files differindex 6a994a24c16..011b51961d4 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf Binary files differindex 5e76c8d5aac..0175fd31b2e 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf Binary files differindex 9c38abc8c84..ad2cd7dd33d 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf Binary files differindex 1b410c1ef8e..d283d35e092 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf Binary files differindex c3fb4f022bc..d1e73ffb4b5 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf Binary files differindex 951757da636..fe6fb8ad497 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf Binary files differindex fee9bbf2dff..8e6967b08aa 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf Binary files differindex a858a42c431..d32b9bff997 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf Binary files differindex c043e68add3..2e54f340e3c 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf Binary files differindex 02e724712d1..4039ae74b83 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf Binary files differindex a521a6ca252..308e42b7ea3 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf Binary files differindex 166cdf0386d..086869b52c6 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf Binary files differindex b065870c917..9476774444e 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf Binary files differindex 76b087f8463..1a83be2d017 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 5c839204366..4c1a0087c69 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.tex @@ -32,7 +32,7 @@ The released version of this bundle is available from CTAN. {latex-team@latex-project.org}% }% } -\date{Released 2023-05-15} +\date{Released 2023-05-22} \begin{document} 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 6f8bc1166dc..aad08104ace 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/l3syntax-changes.tex b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex index 8218429e71f..847089ac7a7 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3syntax-changes.tex @@ -32,7 +32,7 @@ The released version of this bundle is available from CTAN. {latex-team@latex-project.org}% }% } -\date{Released 2023-05-15} +\date{Released 2023-05-22} \newcommand{\TF}{\textit{(TF)}} diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf Binary files differindex 11c4fbb8f74..238b5bb93e0 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf +++ b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex index 9fae8221bbc..c70b1353737 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex @@ -32,7 +32,7 @@ The released version of this bundle is available from CTAN. {latex-team@latex-project.org}% }% } -\date{Released 2023-05-15} +\date{Released 2023-05-22} \newcommand{\TF}{\textit{(TF)}} @@ -48,7 +48,7 @@ This file describes aspects of \TeX{} programming that are relevant in a Tokenization. Treatment of spaces, such as the trap that \verb|\~~a| is equivalent to -\verb|\~a| in expl syntax, or that \verb|~| fails to give a space at the +\verb|\~a| in \pkg{expl3} syntax, or that \verb|~| fails to give a space at the beginning of a line. \section{Structure of tokens} @@ -146,4 +146,35 @@ removed) becomes the argument. Note that explicit space characters at the start of the argument are \emph{not} ignored in this case (and they prevent brace-stripping). +\section{Handling of hash tokens} + +\TeX{} uses the hash (octothorpe) character |#| to denote parameters for +macros: these must be numbered sequentially. To allow handling of nested +macros, \TeX{} requires that for each nesting level, hash tokens are doubled. +For example +\begin{verbatim} +\cs_new:Npn \mypkg_outer:N #1 + { + \cs_new:Npn \mypkg_inner:N ##1 + { + #1 + ##1 + } + } +\end{verbatim} +would define both |\mypkg_outer:N| and |\mypkg_inner:N| as taking +exactly one argument. If we then do +\begin{verbatim} +\mypkg_outer:N \foo +\cs_show:N \mypkg_inner:N +\end{verbatim} +\TeX{} will report +\begin{verbatim} +> \mypkg_inner:N=\long macro:#1->\foo #1. +\end{verbatim} +i.e.~the hash is not doubled, but is now the parameter of this macro. + +Exactly the same concept applies to anywhere that inline code is nested in +\pkg{expl3}, for example inline mapping code, key definitions, etc. + \end{document} diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf Binary files differindex 84fa054d5f3..ffe5d5de9bf 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/source3.tex b/Master/texmf-dist/doc/latex/l3kernel/source3.tex index e12bd2b98d8..5d7b26ceff0 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3.tex @@ -53,7 +53,7 @@ for those people who are interested. {latex-team@latex-project.org}% }% } -\date{Released 2023-05-15} +\date{Released 2023-05-22} \pagenumbering{roman} \maketitle |