summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/l3build/l3build.1
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-01-10 03:03:23 +0000
committerNorbert Preining <norbert@preining.info>2024-01-10 03:03:23 +0000
commitcdb8117b8f1ac752d1927b82759c5be9f0ec0ab5 (patch)
treeebd07d36ab12076de3523b744cc87f975747f3e0 /macros/latex/contrib/l3build/l3build.1
parent140e2f7f1509acd423172e2895d0d7839e5b88c6 (diff)
CTAN sync 202401100303
Diffstat (limited to 'macros/latex/contrib/l3build/l3build.1')
-rw-r--r--macros/latex/contrib/l3build/l3build.138
1 files changed, 31 insertions, 7 deletions
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)