diff options
author | Norbert Preining <norbert@preining.info> | 2024-01-10 03:03:23 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2024-01-10 03:03:23 +0000 |
commit | cdb8117b8f1ac752d1927b82759c5be9f0ec0ab5 (patch) | |
tree | ebd07d36ab12076de3523b744cc87f975747f3e0 /macros/latex/contrib/l3build | |
parent | 140e2f7f1509acd423172e2895d0d7839e5b88c6 (diff) |
CTAN sync 202401100303
Diffstat (limited to 'macros/latex/contrib/l3build')
-rw-r--r-- | macros/latex/contrib/l3build/CHANGELOG.md | 10 | ||||
-rw-r--r-- | macros/latex/contrib/l3build/README.md | 2 | ||||
-rw-r--r-- | macros/latex/contrib/l3build/l3build-check.lua | 2 | ||||
-rw-r--r-- | macros/latex/contrib/l3build/l3build.1 | 38 | ||||
-rw-r--r-- | macros/latex/contrib/l3build/l3build.dtx | 19 | ||||
-rwxr-xr-x | macros/latex/contrib/l3build/l3build.lua | 2 | ||||
-rw-r--r-- | macros/latex/contrib/l3build/l3build.pdf | bin | 747742 -> 749004 bytes |
7 files changed, 55 insertions, 18 deletions
diff --git a/macros/latex/contrib/l3build/CHANGELOG.md b/macros/latex/contrib/l3build/CHANGELOG.md index c06b9a380f..02ad0179e1 100644 --- a/macros/latex/contrib/l3build/CHANGELOG.md +++ b/macros/latex/contrib/l3build/CHANGELOG.md @@ -7,6 +7,13 @@ this project uses date-based 'snapshot' version identifiers. ## [Unreleased] +## [2024-01-09] + +### Fixed +- Type of return value of `runtest_tasks()` in doc +- Print failures correctly when these occur in multiple configurations + including the core (`build`) one + ## [2024-01-04] ### Changed @@ -753,7 +760,8 @@ this project uses date-based 'snapshot' version identifiers. - Rationalise short option names: removed `-d`, `-E`, `-r` - Target `cmdcheck`: specific to LaTeX kernel work -[Unreleased]: https://github.com/latex3/l3build/compare/2024-01-04...HEAD +[Unreleased]: https://github.com/latex3/l3build/compare/2024-01-09...HEAD +[2024-01-09]: https://github.com/latex3/l3build/compare/2024-01-04...2024-01-09 [2024-01-04]: https://github.com/latex3/l3build/compare/2023-12-15...2024-01-04 [2023-12-15]: https://github.com/latex3/l3build/compare/2023-12-13-2...2023-12-15 [2023-12-13-2]: https://github.com/latex3/l3build/compare/2023-12-13...2023-12-13-2 diff --git a/macros/latex/contrib/l3build/README.md b/macros/latex/contrib/l3build/README.md index c2bba6cc5b..1196dc6d42 100644 --- a/macros/latex/contrib/l3build/README.md +++ b/macros/latex/contrib/l3build/README.md @@ -1,7 +1,7 @@ l3build: a testing and building system for LaTeX ================================================= -Release 2024-01-04 +Release 2024-01-09 Overview -------- diff --git a/macros/latex/contrib/l3build/l3build-check.lua b/macros/latex/contrib/l3build/l3build-check.lua index 1f2b04ce5a..2a50c590db 100644 --- a/macros/latex/contrib/l3build/l3build-check.lua +++ b/macros/latex/contrib/l3build/l3build-check.lua @@ -1058,7 +1058,7 @@ end -- A short auxiliary to print the list of differences for check function checkdiff(config) local testdir = testdir - if config then + if config and config ~= "build" then testdir = testdir .. "-" .. config end local diff_files = ordered_filelist(testdir, "*" .. os_diffext) diff --git a/macros/latex/contrib/l3build/l3build.1 b/macros/latex/contrib/l3build/l3build.1 index e6d604b560..47462ae7a4 100644 --- a/macros/latex/contrib/l3build/l3build.1 +++ b/macros/latex/contrib/l3build/l3build.1 @@ -1,4 +1,4 @@ -.TH l3build 1 "2024-01-04" +.TH l3build 1 "2024-01-09" .SH NAME l3build \- Checking and building packages .SH SYNOPSIS @@ -10,53 +10,77 @@ can be used by any modern TeX distribution with the texlua interpreter. A package for building with l3build can be written in any TeX dialect; its defaults are set up for LaTeX packages written in the DocStrip style. .PP -The most commonly used l3build targets are: +The standard l3build targets are: .IP check Run all automated tests .IP clean Clean out directory tree +.IP ctan +Create CTAN-ready archive .IP doc Typesets all documentation files .IP install Installs files into the local texmf tree +.IP manifest +Creates a manifest file .IP save Saves test validation log .IP tag -Update release tags in files +Updates release tags in files .IP uninstall Uninstalls files from the local texmf tree .IP unpack Unpacks the source files into the build tree +.IP upload +Send archive to CTAN for public release .SH OPTIONS -Various options apply +Various options apply .IP --config|-c Sets the config(s) used for running tests .IP --date Sets the date to insert into sources +.IP --debug +Runs target in debug mode +.IP --dirty +Skip cleaning up the test area .IP --dry-run -Dry run for install +Dry run for install or upload +.IP --email +Email address of CTAN uploader .IP --engine|-e Sets the engine(s) to use for running test .IP --epoch Sets the epoch for tests and typesetting +.IP --file|-F +Take the upload announcement from the given file .IP --first Name of first test to run .IP --force|-f Force tests to run if engine is not set up +.IP --full +Install all files .IP --halt-on-error|-H Stops running tests after the first failure +.IP --help|-h +Print help message and exit .IP --last Name of last test to run -.IP --pdf|-p -Check/save PDF files +.IP --message|-m +Text for upload announcement message .IP --quiet|-q Suppresses TeX output when unpacking .IP --rerun Skip setup: simply rerun tests +.IP --show-log-on-error +Show the full log of the failure with 'halt-on-error' +.IP --show-saves|-S +Show the invocation to update failing .tlg files .IP --shuffle Shuffle order of tests .IP --texmfhome Location of user texmf tree +.IP --version +Print version information and exit .SH BUGS .SH AUTHOR The LaTeX Project (latex-team@latex-project.org) diff --git a/macros/latex/contrib/l3build/l3build.dtx b/macros/latex/contrib/l3build/l3build.dtx index 047f43f4df..e02dfd6f53 100644 --- a/macros/latex/contrib/l3build/l3build.dtx +++ b/macros/latex/contrib/l3build/l3build.dtx @@ -251,7 +251,7 @@ % }^^A % } % -% \date{Released 2024-01-04} +% \date{Released 2024-01-09} % % \maketitle % \tableofcontents @@ -713,24 +713,28 @@ % % For example, for the core \LaTeXe{} tests the main test files are contained % in a directory |testfiles|. To test font loading for \XeTeX{} and \LuaTeX{} -% there are a second set of tests in |testfiles-TU| which use the short -% |config-TU.lua| file shown in Listing~\vref{lst:configs}. To run both sets of -% tests, the main |build.lua| file contains the setting +% there are a second set of tests in |testfiles-TU| which use a short +% |config-TU.lua| file similar to the one shown in Listing~\vref{lst:configs}. +% To run both sets of tests, the main |build.lua| file contains the setting % |checkconfigs = {"build", "config-TU"}|. This will cause \pkg{l3build} to run % first using no additional settings (\emph{i.e.}~reading the normal % |build.lua| file alone), then running \emph{also} loading the settings from % |config-TU.lua|. % \begin{floating-listing}[caption={Example of using additional (or overriding) settings for configuring tests in a different subdirectory.},label={lst:configs}] % -- Special config for these tests -% checksearch = true +% stdengine = "xetex" % checkengines = {"xetex","luatex"} +% checksearch = true % testfiledir = "testfiles-TU" % \end{floating-listing} % % To allow selection of one or more configurations, and to allow saving of % |.tlg| files in non-standard configurations, the |--config| (|-c|) option may % be used. This works in the same way as |--engine|: it takes a comma list of -% configurations to apply, overriding \var{checkconfigs}. +% configurations to apply, overriding \var{checkconfigs}. For example, in the +% directory containing |config-TU.lua|, you can use +% |l3build check -cconfig-TU <name(s)>| and |l3build save -cconfig-TU <name(s)>| +% to check and save tests in |testfiles-TU| directory. % % \subsection{Dependencies} % @@ -1157,7 +1161,8 @@ % of the current test (this is equivalent to \TeX{}'s \cs{jobname}, % \emph{i.e.}~it lacks an extension) and the current run number. % The function |runtest_tasks| is run after the main call to the -% engine for a test cycle. It should return an errorlevel value. +% engine for a test cycle. It should return a string consists of task(s), +% i.e., the CLI command(s) to execute. % If more than one task is required, these should be separated % by use of |os_concat|, a string variable defined by \pkg{l3build} as the % correct concatenation marker for the system. An example of |runtest_tasks| diff --git a/macros/latex/contrib/l3build/l3build.lua b/macros/latex/contrib/l3build/l3build.lua index 995eefe533..8b0dcbda6f 100755 --- a/macros/latex/contrib/l3build/l3build.lua +++ b/macros/latex/contrib/l3build/l3build.lua @@ -25,7 +25,7 @@ for those people who are interested. --]] -- Version information -release_date = "2024-01-04" +release_date = "2024-01-09" -- File operations are aided by the LuaFileSystem module local lfs = require("lfs") diff --git a/macros/latex/contrib/l3build/l3build.pdf b/macros/latex/contrib/l3build/l3build.pdf Binary files differindex 763d37dc2d..8883e78d95 100644 --- a/macros/latex/contrib/l3build/l3build.pdf +++ b/macros/latex/contrib/l3build/l3build.pdf |