From 522964b40afca63660485cdcfc577b25bdf02e35 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 17 Jul 2020 21:45:53 +0000 Subject: l3 (17jul20) git-svn-id: svn://tug.org/texlive/trunk@55860 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md | 24 +++++- Master/texmf-dist/doc/latex/l3kernel/README.md | 2 +- Master/texmf-dist/doc/latex/l3kernel/expl3.pdf | Bin 585320 -> 584938 bytes .../texmf-dist/doc/latex/l3kernel/interface3.pdf | Bin 1545894 -> 1555993 bytes .../texmf-dist/doc/latex/l3kernel/interface3.tex | 2 +- .../texmf-dist/doc/latex/l3kernel/l3docstrip.pdf | Bin 263622 -> 263178 bytes Master/texmf-dist/doc/latex/l3kernel/l3news.pdf | Bin 379248 -> 379235 bytes Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf | Bin 113529 -> 113527 bytes Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf | Bin 140776 -> 140776 bytes Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf | Bin 144784 -> 144785 bytes Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf | Bin 107117 -> 107115 bytes Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf | Bin 105090 -> 105090 bytes Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf | Bin 140797 -> 140795 bytes Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf | Bin 119092 -> 119094 bytes Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf | Bin 152413 -> 152413 bytes Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf | Bin 235323 -> 235322 bytes Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf | Bin 147096 -> 147097 bytes Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf | Bin 165956 -> 165946 bytes Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf | Bin 199153 -> 199139 bytes .../texmf-dist/doc/latex/l3kernel/l3obsolete.txt | 68 +++++++-------- .../texmf-dist/doc/latex/l3kernel/l3prefixes.csv | 5 ++ .../texmf-dist/doc/latex/l3kernel/l3prefixes.pdf | Bin 75645 -> 75852 bytes .../texmf-dist/doc/latex/l3kernel/l3styleguide.pdf | Bin 280369 -> 279956 bytes .../texmf-dist/doc/latex/l3kernel/l3styleguide.tex | 2 +- .../doc/latex/l3kernel/l3syntax-changes.pdf | Bin 228663 -> 228250 bytes .../doc/latex/l3kernel/l3syntax-changes.tex | 2 +- .../doc/latex/l3kernel/l3term-glossary.pdf | Bin 186883 -> 217628 bytes .../doc/latex/l3kernel/l3term-glossary.tex | 95 ++++++++++++++++++++- Master/texmf-dist/doc/latex/l3kernel/source3.pdf | Bin 5904224 -> 5865524 bytes Master/texmf-dist/doc/latex/l3kernel/source3.tex | 2 +- .../texmf-dist/doc/latex/l3kernel/source3body.tex | 1 + 31 files changed, 161 insertions(+), 42 deletions(-) (limited to 'Master/texmf-dist/doc/latex/l3kernel') diff --git a/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md b/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md index d487068859f..13868561574 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md +++ b/Master/texmf-dist/doc/latex/l3kernel/CHANGELOG.md @@ -7,6 +7,27 @@ this project uses date-based 'snapshot' version identifiers. ## [Unreleased] +## [2020-07-17] + +### Added +- `l3cctab` module for using category code tables +- `\file_parse_full_name:n` and `\file_parse_full_name_apply:nN` +- Additional `\prop_put:Nnn` variants +- `\seq_set_map_x:NNn` +- `\msg_term:nn(nnnn)` + +### Fixed +- File lookup with `\input@path` + +### Changed +- Implementation of `\file_parse_full_name:nNNN` now uses + `\file_parse_full_name:n` internally +- `\seq_set_map:NNn` no longer `x`-expands `` + (`\seq_set_map_x:NNn` now does that). Both moved to stable. + +### Removed +- Functions deprecated at end of 2019 + ## [2020-06-18] ### Changed @@ -704,7 +725,8 @@ this project uses date-based 'snapshot' version identifiers. - Step func­tions have been added for dim vari­ables, e.g. `\dim_step_in­line:nnnn` -[Unreleased]: https://github.com/latex3/latex3/compare/2020-06-18...HEAD +[Unreleased]: https://github.com/latex3/latex3/compare/2020-07-17...HEAD +[2020-07-17]: https://github.com/latex3/latex3/compare/2020-06-18...2020-07-17 [2020-06-18]: https://github.com/latex3/latex3/compare/2020-06-03...2020-06-18 [2020-06-03]: https://github.com/latex3/latex3/compare/2020-05-15...2020-06-03 [2020-05-15]: https://github.com/latex3/latex3/compare/2020-05-14...2020-05-15 diff --git a/Master/texmf-dist/doc/latex/l3kernel/README.md b/Master/texmf-dist/doc/latex/l3kernel/README.md index 8ff01699d7e..bfd238bcce8 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 2020-06-18 +Release 2020-07-17 Overview -------- diff --git a/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf b/Master/texmf-dist/doc/latex/l3kernel/expl3.pdf index 18721992ab5..d76040d2bd9 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 8f3d8ec7874..3c44cfaf5e9 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 2c600d46964..467d04cf86e 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/interface3.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/interface3.tex @@ -54,7 +54,7 @@ for those people who are interested. {latex-team@latex-project.org}% }% } -\date{Released 2020-06-18} +\date{Released 2020-07-17} \pagenumbering{roman} \maketitle diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3docstrip.pdf index 52aaff704f1..4c59fc9770a 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/l3news.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf index b5ccaa4abda..9463b85375c 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf index 9df1d2e3572..5c3bb769142 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news01.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf index 986447ba43f..0d80eae0812 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news02.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf index b574f29d399..29264d35787 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news03.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf index bd289867158..1b990e38891 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news04.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf index 98f1049a042..ab75e4b9390 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news05.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf index 09db9922509..95606ad096e 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news06.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf index 7c1d2e11a66..a51e4512e44 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news07.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf index fde17f43055..45e221f9ba5 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news08.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf index b088958a78f..c2a1cc18169 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news09.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf index bc0ccc14ecf..af9d89b61a4 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news10.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf index 6a3bc0787df..c9a93fa9755 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news11.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf index 573feb45f8b..cc045f3a199 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3news12.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt b/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt index b7a97f48b0d..71e521aac1f 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt +++ b/Master/texmf-dist/doc/latex/l3kernel/l3obsolete.txt @@ -23,29 +23,6 @@ Function Expires end \box_set_eq_clear:cN 2020 \box_set_eq_clear:Nc 2020 \box_set_eq_clear:NN 2020 -\c_zero 2019 -\c_one 2019 -\c_two 2019 -\c_three 2019 -\c_four 2019 -\c_five 2019 -\c_six 2019 -\c_seven 2019 -\c_eight 2019 -\c_nine 2019 -\c_ten 2019 -\c_eleven 2019 -\c_twelve 2019 -\c_thirteen 2019 -\c_fourteen 2019 -\c_fifteen 2019 -\c_sixteen 2019 -\c_thirty_two 2019 -\c_one_hundred 2019 -\c_two_hundred_fifty_five 2019 -\c_two_hundred_fifty_six 2019 -\c_one_thousand 2019 -\c_ten_thousand 2019 \c_term_ior 2020 \char_fold_case:N 2022 \char_lower_case:N 2022 @@ -55,18 +32,10 @@ Function Expires end \char_str_lower_case:N 2022 \char_str_mixed_case:N 2022 \char_str_upper_case:N 2022 -\etex_....:D 2019 \hbox_unpack_clear:c 2020 \hbox_unpack_clear:N 2020 \l_keys_key_tl 2022 \l_keys_path_tl 2022 -\lua_escape_x:n 2019 -\luatex_...:D 2019 -\msg_interrupt:nn 2019 -\msg_log:n 2019 -\msg_term:n 2019 -\pdftex_...:D 2019 -\ptex_...:D 2019 \str_fold_case:n 2022 \str_fold_case:V 2022 \str_lower_case:f 2022 @@ -92,11 +61,8 @@ Function Expires end \token_get_arg_spec:N 2020 \token_get_prefix_spec:N 2020 \token_get_replacement_spec:N 2020 -\uptex_...:D 2019 -\utex_...:D 2019 \vbox_unpack_clear:c 2020 \vbox_unpack_clear:N 2020 -\xetex_...:D 2019 -------------------------------------- Removed functions and variables @@ -114,18 +80,41 @@ Function Date removed \box_use_clear:N 2018-12-27 \c_active_char_token 2011-09-08 \c_alignment_tab_token 2011-09-08 +\c_eight 2020-01-01 +\c_eleven 2020-01-01 \c_empty_toks 2011-09-08 +\c_fifteen 2020-01-01 +\c_five 2020-01-01 +\c_four 2020-01-01 +\c_fourteen 2020-01-01 \c_job_name_tl 2017-01-01 \c_keys_code_root_tl 2013-01-08 \c_letter_token 2011-09-08 \c_luatex_is_engine_bool 2011-12-30 \c_math_shift_token 2011-09-08 \c_minus_one 2018-12-27 +\c_nine 2020-01-01 +\c_one 2020-01-01 +\c_one_hundred 2020-01-01 +\c_one_thousand 2020-01-01 \c_other_char_token 2011-09-08 \c_pdftex_is_engine_bool 2011-12-30 +\c_seven 2020-01-01 +\c_six 2020-01-01 +\c_sixteen 2020-01-01 \c_string_cctab 2012-06-30 +\c_thirteen 2020-01-01 +\c_thirty_two 2020-01-01 +\c_three 2020-01-01 +\c_ten 2020-01-01 +\c_ten_thousand 2020-01-01 +\c_twelve 2020-01-01 +\c_two 2020-01-01 +\c_two_hundred_fifty_five 2020-01-01 +\c_two_hundred_fifty_six 2020-01-01 \c_undefined_fp 2014-05-28 \c_xetex_is_engine_bool 2011-12-30 +\c_zero 2020-01-01 \char_make_active:N 2011-09-08 \char_make_active:n 2011-09-08 \char_make_alignment_tab:N 2011-09-08 @@ -233,6 +222,7 @@ Function Date removed \dim_set_max:Nn 2013-01-08 \dim_set_min:cn 2013-01-08 \dim_set_min:Nn 2013-01-08 +\etex_....:D 2020-01-01 \ExplSyntaxNamesOff 2013-01-08 \ExplSyntaxNamesOn 2013-01-08 \file_add_path:nN 2018-12-27 @@ -352,8 +342,10 @@ Function Date removed \l_tmpb_toks 2011-09-08 \l_tmpc_int 2013-01-08 \l_tmpc_toks 2011-09-08 +\lua_escape_x:n 2020-01-01 \lua_now_x:n 2020-01-01 \lua_shipout_x:n 2020-01-01 +\luatex_...:D 2020-01-01 \luatex_if_engine_p: 2017-01-01 \luatex_if_engine:F 2017-01-01 \luatex_if_engine:T 2017-01-01 @@ -367,9 +359,12 @@ Function Date removed \msg_generic_new:nnn 2011-09-08 \msg_generic_set:nn 2011-09-08 \msg_generic_set:nnn 2011-09-08 +\msg_interrupt:nn 2020-01-01 \msg_interrupt:xxx 2013-01-08 +\msg_log:n 2020-01-01 \msg_log:x 2013-01-08 \msg_newline: 2013-01-08 +\msg_term:n 2020-01-01 \msg_term:x 2013-01-08 \msg_trace:nn 2011-09-08 \msg_trace:nnx 2011-09-08 @@ -377,6 +372,7 @@ Function Date removed \msg_trace:nnxxx 2011-09-08 \msg_trace:nnxxxx 2011-09-08 \msg_two_newlines: 2013-01-08 +\pdftex_...:D 2020-01-01 \pdftex_if_engine_p: 2017-01-01 \pdftex_if_engine:F 2017-01-01 \pdftex_if_engine:T 2017-01-01 @@ -432,6 +428,7 @@ Function Date removed \prop_if_in:ccF 2011-09-08 \prop_if_in:ccT 2011-09-08 \prop_if_in:ccTF 2011-09-08 +\ptex_...:D 2020-01-01 \quark_if_recursion_tail_break:N 2015-07-14 \quark_if_recursion_tail_break:n 2015-07-14 \scan_align_safe_stop: 2017-01-01 @@ -634,16 +631,19 @@ Function Date removed \toks_use_gclear:N 2011-09-08 \toks_use:c 2011-09-08 \toks_use:N 2011-09-08 +\uptex_...:D 2020-01-01 \use_i_after_else:nw 2011-12-30 \use_i_after_fi:nw 2011-12-30 \use_i_after_or:nw 2011-12-30 \use_i_after_orelse:nw 2011-12-30 +\utex_...:D 2020-01-01 \vbox_gset_inline_begin:c 2014-08-09 \vbox_gset_inline_begin:N 2014-08-09 \vbox_gset_inline_end: 2014-08-09 \vbox_set_inline_begin:c 2014-08-09 \vbox_set_inline_begin:N 2014-08-09 \vbox_set_inline_end: 2014-08-09 +\xetex_...:D 2020-01-01 \xetex_if_engine_p: 2017-01-01 \xetex_if_engine:F 2017-01-01 \xetex_if_engine:T 2017-01-01 diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.csv b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.csv index 3738670cf35..bcf02f23b6d 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.csv +++ b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.csv @@ -123,6 +123,7 @@ morewrites,morewrites,Bruno Le Floch,https://github.com/blefloch/latex-morewrite msg,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, msvg,media4svg,Alexander Grahn,,https://gitlab.com/agrahn/media4svg,https://gitlab.com/agrahn/media4svg/issues,2020-04-15,2020-04-15, muskip,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, +namedef,namedef,Phelype Oleinik,https://github.com/PhelypeOleinik/namedef,https://github.com/PhelypeOleinik/namedef.git,https://github.com/PhelypeOleinik/namedef/issues,2020-06-22,2020-06-22, nan,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, nicematrix,nicematrix,François Pantigny,,,,2019-12-19,2019-12-19, nil,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, @@ -138,9 +139,11 @@ overleaf,overleaf,Overleaf,https://www.overleaf.com/about,,support+tex-dev@overl parameter,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, pbs,media9,Alexander Grahn,,https://gitlab.com/agrahn/media9,https://gitlab.com/agrahn/media9/issues,2016-02-26,2020-04-15, pdf,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2019-06-02,2019-06-02, +pdfoverlay,pdfoverlay,David Purton,https://github.com/dcpurton/pdfoverlay,https://github.com/dcpurton/pdfoverlay.git,https://github.com/dcpurton/pdfoverlay/issues,2020-06-22,2020-06-22, pdftex,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, peek,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, percent,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, +pgf,pgf,The PGF/TikZ Team,https://pgf-tikz.github.io,https://github.com/pgf-tikz/pgf,https://github.com/pgf-tikz/pgf/issues,2020-07-03,2020-07-03, pi,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, pkgploader,pkgploader,Michiel Helvensteijn,,,,2014-02-05,2014-02-05, polyglossia,polyglossia,Arthur Reutenauer,https://www.polyglossia.org/,https://github.com/reutenauer/polyglossia,https://github.com/reutenauer/polyglossia/issues,2019-09-03,, @@ -149,7 +152,9 @@ primargs,morewrites,Bruno Le Floch,https://github.com/blefloch/latex-morewrites, prop,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, pseudo,pseudo,Magnus Lie Hetland,https://github.com/mlhetland/pseudo.sty,https://github.com/mlhetland/pseudo.sty.git,https://github.com/mlhetland/pseudo.sty/issues,2019-06-24,2019-06-24, ptex,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2015-07-28,2015-07-28, +ptxcd,ptxcd, Marei Peischl,,,,2020-07-27,2020-07-27,Used for specific corporate design templates quark,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2012-09-27, +qrbill,qrbill,Marei Peischl,https://github.com/peiTeX/qrbill,https://github.com/peiTeX/qrbill.git,https://github.com/peiTeX/qrbill/issues,2020-06-27,2020-06-27, randomwalk,randomwalk,Bruno Le Floch,https://github.com/blefloch/latex-randomwalk,https://github.com/blefloch/latex-randomwalk.git,https://github.com/blefloch/latex-randomwalk/issues,2013-03-16,2015-09-22, recursion,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2018-05-12,2018-05-12, regex,l3kernel,The LaTeX3 Project,https://www.latex-project.org/latex3.html,https://github.com/latex3/latex3.git,https://github.com/latex3/latex3/issues,2012-09-27,2018-04-06, diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf index fe9b65c217c..9b9fc68466d 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3prefixes.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf b/Master/texmf-dist/doc/latex/l3kernel/l3styleguide.pdf index 73d3f8840b0..575770b6c87 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 915534ed114..0d2028f2c23 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 2020-06-18} +\date{Released 2020-07-17} \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 15c831eb553..76dc0f00c98 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 4e280f75d2b..58824c3b4b8 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 2020-06-18} +\date{Released 2020-07-17} \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 index 1a6beba13f3..5826dda2530 100644 Binary files a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf and b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.pdf differ diff --git a/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex b/Master/texmf-dist/doc/latex/l3kernel/l3term-glossary.tex index 99464b67c97..90e2c3c768e 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 2020-06-18} +\date{Released 2020-07-17} \newcommand{\TF}{\textit{(TF)}} @@ -53,7 +53,98 @@ beginning of a line. \section{Structure of tokens} -Copy there the section ``Description of all possible tokens'' from \texttt{l3token}. +We refer to the documentation of \texttt{l3token} for a complete +description of all \TeX{} tokens. We distinguish the meaning of the +token, which controls the expansion of the token and its effect on +\TeX{}'s state, and its shape, which is used when comparing token lists +such as for delimited arguments. At any given time two tokens of the +same shape automatically have the same meaning, but the converse does +not hold, and the meaning associated with a given shape change when +doing assignments. + +Apart from a few exceptions, a token has one of the following shapes. +\begin{itemize} + \item A control sequence, characterized by the sequence of characters + that constitute its name: for instance, \cs{use:n} is a five-letter + control sequence. + \item An active character token, characterized by its character code + (between $0$ and $1114111$ for \LuaTeX{} and \XeTeX{} and less for + other engines) and category code~$13$. + \item A character token such as |A| or |#|, characterized by its + character code and category code (one of $1$, $2$, $3$, $4$, $6$, + $7$, $8$, $10$, $11$ or~$12$ whose meaning is described below). +\end{itemize} + +The meaning of a (non-active) character token is fixed by its category +code (and character code) and cannot be changed. We call these tokens +\emph{explicit} character tokens. Category codes that a character token +can have are listed below by giving a sample output of the \TeX{} +primitive \tn{meaning}, together with their \LaTeX3 names and most +common example: +\begin{itemize} + \item[1] begin-group character (|group_begin|, often |{|), + \item[2] end-group character (|group_end|, often |}|), + \item[3] math shift character (|math_toggle|, often |$|), % $ + \item[4] alignment tab character (|alignment|, often |&|), + \item[6] macro parameter character (|parameter|, often |#|), + \item[7] superscript character (|math_superscript|, often |^|), + \item[8] subscript character (|math_subscript|, often |_|), + \item[10] blank space (|space|, often character code~$32$), + \item[11] the letter (|letter|, such as |A|), + \item[12] the character (|other|, such as |0|). +\end{itemize} +Category code~$13$ (|active|) is discussed below. Input characters can +also have several other category codes which do not lead to character +tokens for later processing: $0$~(|escape|), $5$~(|end_line|), +$9$~(|ignore|), $14$~(|comment|), and $15$~(|invalid|). + +The meaning of a control sequence or active character can be identical +to that of any character token listed above (with any character code), +and we call such tokens \emph{implicit} character tokens. The meaning +is otherwise in the following list: +\begin{itemize} + \item a macro, used in \LaTeX3 for most functions and some variables + (|tl|, |fp|, |seq|, \ldots{}), + \item a primitive such as \tn{def} or \tn{topmark}, used in \LaTeX3 + for some functions, + \item a register such as \tn{count}|123|, used in \LaTeX3{} for the + implementation of some variables (|int|, |dim|, \ldots{}), + \item a constant integer such as \tn{char}|"56| or + \tn{mathchar}|"121|, used when defining a constant using + \cs{int_const:Nn}, + \item a font selection command, + \item undefined. +\end{itemize} +Macros can be \tn{protected} or not, \tn{long} or not (the opposite of +what \LaTeX3 calls |nopar|), and \tn{outer} or not (unused in \LaTeX3). +Their \tn{meaning} takes the form +\begin{quote} + \meta{prefix} |macro:|\meta{argument}|->|\meta{replacement} +\end{quote} +where \meta{prefix} is among \tn{protected}\tn{long}\tn{outer}, +\meta{argument} describes parameters that the macro expects, such as +|#1#2#3|, and \meta{replacement} describes how the parameters are +manipulated, such as~|\int_eval:n{#2+#1*#3}|. This information can be +accessed by \cs{cs_prefix_spec:N}, \cs{cs_argument_spec:N}, +\cs{cs_replacement_spec:N}. + +When a macro takes an undelimited argument, explicit space characters +(with character code $32$ and category code $10$) are ignored. If the +following token is an explicit character token with category code $1$ +(begin-group) and an arbitrary character code, then \TeX{} scans ahead +to obtain an equal number of explicit character tokens with category +code $1$ (begin-group) and $2$ (end-group), and the resulting list of +tokens (with outer braces removed) becomes the argument. Otherwise, a +single token is taken as the argument for the macro: we call such single +tokens \enquote{N-type}, as they are suitable to be used as an argument +for a function with the signature~\texttt{:N}. + +When a macro takes a delimited argument \TeX{} scans ahead until finding +the delimiter (outside any pairs of begin-group/end-group explicit +characters), and the resulting list of tokens (with outer braces +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{Quantities and expressions} diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3.pdf b/Master/texmf-dist/doc/latex/l3kernel/source3.pdf index 4ea4120d6de..01a6f88ddf8 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 985adb77b5f..e9381760fcd 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 2020-06-18} +\date{Released 2020-07-17} \pagenumbering{roman} \maketitle diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex index 83203e64278..5586d73799c 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex @@ -476,6 +476,7 @@ used on top of \LaTeXe{} if \cs{outer} tokens are used in the arguments. \ExplSyntaxOff \DocInput{l3fparray.dtx} +\DocInput{l3cctab.dtx} \DocInput{l3sort.dtx} \DocInput{l3tl-analysis.dtx} \DocInput{l3regex.dtx} -- cgit v1.2.3