texlive[73848] trunk: tl25 man(ual) updates
commits+karl at tug.org
commits+karl at tug.org
Mon Feb 10 19:36:40 CET 2025
Revision: 73848
https://tug.org/svn/texlive?view=revision&revision=73848
Author: karl
Date: 2025-02-10 19:36:39 +0100 (Mon, 10 Feb 2025)
Log Message:
-----------
tl25 man(ual) updates
Modified Paths:
--------------
trunk/Build/source/README.1prerequisites
trunk/Build/source/README.2building
trunk/Build/source/README.3installing
trunk/Build/source/README.4layout
trunk/Build/source/README.5configure
trunk/Build/source/doc/tlbuild-incl/install-tl.texi
trunk/Build/source/doc/tlbuild-incl/tlmgr.texi
trunk/Build/source/doc/tlbuild.info
trunk/Build/source/texk/texlive/tl_support/ChangeLog
trunk/Build/source/texk/texlive/tl_support/Makefile.am
trunk/Build/source/texk/texlive/tl_support/Makefile.in
trunk/Build/source/texk/texlive/tl_support/fmtutil.1
trunk/Build/source/texk/texlive/tl_support/updmap.1
trunk/Master/texmf-dist/doc/dvipng/dvipng.html
trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
trunk/Master/texmf-dist/doc/dvips/dvips.html
trunk/Master/texmf-dist/doc/dvips/dvips.pdf
trunk/Master/texmf-dist/doc/info/dvipng.info
trunk/Master/texmf-dist/doc/info/dvips.info
trunk/Master/texmf-dist/doc/info/kpathsea.info
trunk/Master/texmf-dist/doc/info/tlbuild.info
trunk/Master/texmf-dist/doc/info/web2c.info
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.pdf
trunk/Master/texmf-dist/doc/man/man1/aleph.1
trunk/Master/texmf-dist/doc/man/man1/aleph.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/amstex.1
trunk/Master/texmf-dist/doc/man/man1/amstex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/bibtex.1
trunk/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctie.1
trunk/Master/texmf-dist/doc/man/man1/ctie.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctwill-proofsort.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ctwill.1
trunk/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/cweave.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/cweb.1
trunk/Master/texmf-dist/doc/man/man1/cweb.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvicopy.1
trunk/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvipng.1
trunk/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvisvgm.1
trunk/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvitomp.1
trunk/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/dvitype.1
trunk/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/eptex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/euptex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/gftodvi.1
trunk/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/gftopk.1
trunk/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/gftype.1
trunk/Master/texmf-dist/doc/man/man1/gftype.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/inimf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/initex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/kpseaccess.1
trunk/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.1
trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/kpsestat.1
trunk/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/kpsewhich.1
trunk/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/latex-dev.1
trunk/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/latex.1
trunk/Master/texmf-dist/doc/man/man1/latex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/luatex.1
trunk/Master/texmf-dist/doc/man/man1/luatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mf.1
trunk/Master/texmf-dist/doc/man/man1/mf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mft.1
trunk/Master/texmf-dist/doc/man/man1/mft.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mpost.1
trunk/Master/texmf-dist/doc/man/man1/mpost.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ofm2opl.1
trunk/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/opl2ofm.1
trunk/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/otangle.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.1
trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.1
trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/patgen.1
trunk/Master/texmf-dist/doc/man/man1/patgen.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pbibtex.1
trunk/Master/texmf-dist/doc/man/man1/pbibtex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pdfetex.1
trunk/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pdftex.1
trunk/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pdftosrc.1
trunk/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pktogf.1
trunk/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pktype.1
trunk/Master/texmf-dist/doc/man/man1/pktype.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/platex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pltotf.1
trunk/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/pooltype.1
trunk/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ppltotf.1
trunk/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ptex.1
trunk/Master/texmf-dist/doc/man/man1/ptex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ptftopl.1
trunk/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/tangle.1
trunk/Master/texmf-dist/doc/man/man1/tangle.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/tex.1
trunk/Master/texmf-dist/doc/man/man1/tex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/texlua.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/texluac.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/tftopl.1
trunk/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/tie.1
trunk/Master/texmf-dist/doc/man/man1/tie.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/ttf2afm.1
trunk/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/twill-refsort.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/twill.1
trunk/Master/texmf-dist/doc/man/man1/twill.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/upbibtex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/uptex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/vftovp.1
trunk/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/vptovf.1
trunk/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/weave.1
trunk/Master/texmf-dist/doc/man/man1/weave.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/xetex.1
trunk/Master/texmf-dist/doc/man/man1/xetex.man1.pdf
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
trunk/Master/texmf-dist/doc/web2c/web2c.html
trunk/Master/texmf-dist/doc/web2c/web2c.pdf
trunk/Master/tlpkg/bin/tl-update-asy
trunk/Master/tlpkg/doc/releng.txt
trunk/Master/tlpkg/libexec/ctan2tds
Added Paths:
-----------
trunk/Master/texmf-dist/doc/man/man1/mflua.1
trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/texprof.1
trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/texprofile.1
trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf
Modified: trunk/Build/source/README.1prerequisites
===================================================================
--- trunk/Build/source/README.1prerequisites 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/README.1prerequisites 2025-02-10 18:36:39 UTC (rev 73848)
@@ -19,8 +19,8 @@
* A C++11 compiler is similarly required because of the third-party
libraries ICU and HarfBuzz (at least); the program 'dvisvgm' also
requires C++11. It is possible to build what remains with older
- compilers, but you have to remove the C++11-dependent sources.
- *Note Build one package::.
+ compilers, but you have to remove the C++11-dependent sources. See
+ Build one package.
* Python is required by ICU tests. (If you know how to disable these
tests and thus eliminate the requirement, please write.)
@@ -63,14 +63,13 @@
GNU Autoconf, GNU Automake, and GNU Libtool to update the generated
files. Furthermore, to reliably reproduce the build files, the
original GNU releases of these tools must be used, not any distro
- packaging of them. *Note Build system tools::, for more
- discussion.
+ packaging of them. See Build system tools, for more discussion.
If you haven't modified any source files, and infrastructure tools
such as 'autoconf' or 'makeinfo' are still being run, check your
timestamps--notably, 'use-commit-times' must be set to 'yes' in your
-Subversion configuration (*note Build system tools::). No
-infrastructure tools are needed to do a normal build (barring bugs).
+Subversion configuration (see Build system tools). No infrastructure
+tools are needed to do a normal build (barring bugs).
---------- Footnotes ----------
Modified: trunk/Build/source/README.2building
===================================================================
--- trunk/Build/source/README.2building 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/README.2building 2025-02-10 18:36:39 UTC (rev 73848)
@@ -61,21 +61,26 @@
4.3 Build distribution
======================
-Running 'make dist' at the top level creates a tarball
-'tex-live-YYYY-MM-DD.tar.xz' from the TL source tree. Running 'make
-distcheck' also verifies that this tarball suffices to build and install
-all of TL.
+Running 'make dist' or related targets at the top level outputs an error
+message and fails. We no longer try to keep 'make dist' working,
+although it could be restored if there is some use for it.
- This is useful for checking consistency of the source tree and
-Makefiles, but the result is not a complete or even usable TeX system,
-since all the support files are lacking; *note Installing::. We do not
-actually distribute any such tarball, and have no plans to do so.
+ The 'dist' target used to create a tarball
+'tex-live-YYYY-MM-DD.tar.xz' from the TL source tree, and 'distcheck'
+also verifies that this tarball suffices to build and install all of TL.
+ However, the result was not a complete or even usable TeX system,
+since all the support files are lacking. We do not actually distribute
+any such tarball, and have no plans to do so.
+
+ See Installing, for more information on what to do with the results
+of a build.
+
4.4 Build one package
=====================
To build one package, the basic idea is to use the 'configure' option
-'--disable-all-pkgs' (*note --disable-all-pkgs::). Then all program and
+'--disable-all-pkgs' (see --disable-all-pkgs). Then all program and
library modules are configured but none are made. However, the
'Makefile's still contain all build rules and dependencies and can be
invoked to build an individual program or library, first building any
@@ -164,9 +169,9 @@
Also, even with '--disable-all-pkgs', dependencies are (currently)
checked. One notable case: if a (non-MacOS) system does not have
-'fontconfig', XeTeX cannot be built (*note Prerequisites::), and
-'configure' will terminate even with '--disable-xetex'. To proceed
-without such dependencies, specify '--enable-missing' also.
+'fontconfig', XeTeX cannot be built (see Prerequisites), and 'configure'
+will terminate even with '--disable-xetex'. To proceed without such
+dependencies, specify '--enable-missing' also.
As of 2022, HarfBuzz also requires C++11. Therefore even more would
have to be disabled and removed, notably including 'luahbtex', the
@@ -185,7 +190,7 @@
====================
Unfortunately, there is one common case where the steps in the preceding
-section to build one package (*note Build one package::) do not suffice:
+section to build one package (see Build one package) do not suffice:
wanting to build one, or a subset, of the TeX engines (or other Web2c
programs).
@@ -261,7 +266,7 @@
cases it suffices to specify suitable compiler flags. It might be
useful to add the configure option '--build=HOST' to get the correct
canonical host name, but note that this should _not_ be '--host=HOST'
-(*note (autoconf)Hosts and Cross-Compilation::).
+(see (autoconf)Hosts and Cross-Compilation).
In order to build, e.g., 32-bit binaries with 'clang' on a 64-bit
MacOS system one could use:
Modified: trunk/Build/source/README.3installing
===================================================================
--- trunk/Build/source/README.3installing 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/README.3installing 2025-02-10 18:36:39 UTC (rev 73848)
@@ -16,7 +16,8 @@
not present in the TL source tree. The best basis for dealing with them
is the TeX Live (plain text) database in 'Master/tlpkg/texlive.tlpdb',
and/or the TeX Live installer, 'install-tl'. More information is under
-'Master/tlpkg' and at <https://tug.org/texlive/distro.html>.
+'Master/tlpkg' and at <https://tug.org/texlive/distro.html> and
+<https://tug.org/texlive/build.html#deploy>.
5.1 Installation directories
============================
@@ -23,7 +24,7 @@
Running 'make install' (or 'make install-strip') installs executables in
'BINDIR', libraries in 'LIBDIR', headers in 'INCLUDEDIR', general data
-(including "linked scripts", *note Linked scripts::) in
+(including "linked scripts", see Linked scripts) in
'DATAROOTDIR/texmf-dist', man pages in 'MANDIR', and Info files in
'INFODIR'.
@@ -63,31 +64,58 @@
5.2 Linked scripts
==================
-Quite a few executables are architecture-independent shell, Perl, or
-other interpreted scripts, rather than compiled binaries. A few are
-maintained as part of the TL source tree, but most are maintained
-elsewhere with copies under 'texk/texlive/linked_scripts'.
+Quite a few of the executables in TeX Live are architecture-independent
+shell, Perl, or other interpreted scripts, rather than compiled
+binaries. A few are maintained as part of the TL source tree, but most
+are maintained independently in their own packages, with copies under
+'texk/texlive/linked_scripts'.
These so-called "linked scripts" are installed under
'DATAROOTDIR/texmf-dist/scripts'; for Unix-like systems a symbolic link
-is made in 'BINDIR'. For example, a symlink points from 'BINDIR/ps2eps'
-to 'DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl'. For Windows, a
-standard wrapper binary (copied to, e.g., 'BINDIR/ps2eps.exe') serves
-the same purpose. The source for the wrapper is in
-'texk/texlive/windows_wrapper'.
+is made in 'BINDIR'. For example, a symlink points from
+'BINDIR/fmtutil' to 'DATAROOTDIR/texmf-dist/scripts/texlive/fmtutil.pl'.
+The symlink is relative, so the installation root can be anywhere.
- One reason for this is to avoid having many copies of the same
+ For Windows, we cannot portably use symlinks, so a standard wrapper
+binary (copied to, e.g., 'BINDIR/fmtutil.exe') serves the same purpose
+(the source for the wrapper is in 'texk/texlive/windows_wrapper').
+
+ One reason for all this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
- Most important of all, we want the 'BINDIR' resulting from the build
-to be as close as possible to what is in the TL distribution. At
-present, there are a few exceptions--Asymptote, Biber, Xindy--and each
-one creates considerable extra work. We don't want to add more. (See
+ Most important of all, we want the 'BINDIR' resulting from 'make
+install' in the TL source tree to be as close as possible to what's in
+thej TL distribution. At present, there are a few
+exceptions--Asymptote, Biber, Xindy--and each one creates considerable
+extra work. We don't want to add more. (See
<https://tug.org/texlive/build.html> for information about building
those exceptions, as well as the 'xz' and 'wget' programs that are used
in the TL infrastructure.)
+ As part of the 'make install' in the 'linked_scripts' directory, a
+file 'scripts-targets.lst' is created to record all the links that are
+created this way, so that distros and others can reproduce them. The
+file has one line per link. The first word is the target of the link
+(e.g., 'texmf-dist/scripts/texlive/fmtutil.pl'), and the second word is
+the name of the link to be placed in the bindir (e.g., 'fmtutil').
+Determining the relative link target (how many '../'s) is left to the
+users of this file, since it varies among distributions. It can be
+assumed there is no whitespace in these filenames.
+
+ A few links are within bindir; in that case, the first word of the
+line is just a base name, e.g., the file 'fmtutil mktexfmt' means that
+doing the equivalent of 'ln -s fmtutil mktexfmt' in the bindir.
+
+ Be aware that although extensions are usually stripped (as with
+'fmtutil'), there are exceptions, such as 'memoize-extract.pl' and
+'listings-ext.sh'.
+
+ The 'scripts-targets.lst' file started being created as of the
+TeX Live 2025 release. Historically, another file 'scripts.lst' has
+been (and still is) created, containing only the link targets, and using
+a Bourne shell syntax.
+
5.3 Distro builds
=================
@@ -139,10 +167,10 @@
'--libdir=\${exec_prefix}/lib64'
May be needed for 64-bit bi-architecture (GNU/Linux) systems.
- You will need to take care of the support files mentioned above
-(*note Installing::), and many other issues, such as font maps,
-languages, and formats, independently of the build. Norbert Preining
-has written a detailed article on adapting TL for distros:
+ You will need to take care of the support files mentioned above (see
+Installing), and many other issues, such as font maps, languages, and
+formats, independently of the build. Norbert Preining has written a
+detailed article on adapting TL for distros:
<https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf>. (If the
article needs updating in the future, perhaps we will merge it into this
document.)
Modified: trunk/Build/source/README.4layout
===================================================================
--- trunk/Build/source/README.4layout 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/README.4layout 2025-02-10 18:36:39 UTC (rev 73848)
@@ -13,7 +13,7 @@
6.1 Build system tools
======================
-As mentioned above (*note Prerequisites::), a normal build has few
+As mentioned above (see Prerequisites), a normal build has few
requirements. On the other hand, if you want to modify the TeX Live
infrastructure sources, such as 'configure.ac' or 'Makefile.am' files,
you will need to have several additional tools installed.
@@ -28,12 +28,12 @@
Currently the versions we use are:
autoconf (GNU Autoconf) 2.72
- automake (GNU automake) 1.16.5
+ automake (GNU automake) 1.17
bison (GNU Bison) 3.8.2
flex 2.6.0
- ltmain.sh (GNU libtool) 2.4.7
+ ltmain.sh (GNU libtool) 2.5.4
m4 (GNU M4) 1.4.19
- makeinfo (GNU texinfo) 7.1
+ makeinfo (GNU texinfo) 7.2
These versions should be used to update the generated files (e.g.,
'configure' or 'Makefile.in') in all or parts of the TL tree after their
@@ -62,8 +62,8 @@
Here is a brief description of the top-level directories in the TeX Live
source tree.
- As mentioned at the beginning of *note Overview of build system::,
-the main source directories are 'texk/' (TeX-specific programs and
+ As mentioned at the beginning of see Overview of build system, the
+main source directories are 'texk/' (TeX-specific programs and
libraries), 'utils/' (additional programs), and 'libs/' (generic
libraries).
@@ -105,8 +105,8 @@
modules--many more are defined in the sources; see the top-level 'm4/'
directory. These general macros are supplemented by module-specific
macros in directories such as 'texk/dvipng/m4/'; some of those are
-described in following sections (*note Library modules:: and *note
-Program modules::).
+described in following sections (see Library modules and Program
+modules).
6.3.1 General setup macros
--------------------------
@@ -169,9 +169,10 @@
-- Macro: KPSE_COMPILER_VISIBILITY
When using the C or C++ compiler, try to set
'VISIBILITY_C[XX]FLAGS' to flags to hide external symbols. Call
- 'AC_SUBST' for this variable. At present this only tests for the
- compiler option '-fvisibility=hidden', but could be extended if
- necessary.
+ 'AC_SUBST' for this variable. This tests for the compiler option
+ '-fvisibility=hidden' and, except for C,
+ '-fvisibility-inlines-hidden'. Reports or patches for additional
+ tests are welcome.
This macro caches its results in the 'kpse_cv_visibility_cflags' or
'kpse_cv_visibility_cxxflags' variable.
@@ -265,7 +266,7 @@
'WIN32_WRAP' ('true' if the standard Windows wrapper
('texk/texlive/windows_wrapper/runscript.exe') exists. This
wrapper is used on Windows instead of symlinks for the "linked
- scripts" (*note Linked scripts::).
+ scripts" (see Linked scripts).
-- Macro: KPSE_WIN32_CALL
Call 'KPSE_COND_WIN32' and check if the file
@@ -361,14 +362,14 @@
-----------------------------------------------
This is one of the TeX-specific libraries that are maintained as part of
-TeX Live (*note (kpathsea)::); the other is 'ptexenc'. These TeX
-libraries are Libtool libraries (static and/or shared) and are installed
-by 'make install' together with the programs. They are, however, not
-part of the TL DVD as distributed by TeX user groups, and have never
-been officially released for standalone use.
+TeX Live (see (kpathsea)); the other is 'ptexenc'. These TeX libraries
+are Libtool libraries (static and/or shared) and are installed by 'make
+install' together with the programs. They are, however, not part of the
+TL DVD as distributed by TeX user groups, and have never been officially
+released for standalone use.
- It is possible, and probably useful for distro builds (*note Distro
-builds::), to specify the configure option '--with-system-kpathsea' in
+ It is possible, and probably useful for distro builds (see Distro
+builds), to specify the configure option '--with-system-kpathsea' in
order to use a system version of the library. Programs outside the TL
tree should use 'pkg-config' for the required flags.
@@ -385,8 +386,8 @@
6.5 Program modules
===================
-As with libraries (*note Library modules::), here we discuss the details
-for a few of the programs in TL.
+As with libraries (see Library modules), here we discuss the details for
+a few of the programs in TL.
6.5.1 The 't1utils' package in 'utils/t1utils'
----------------------------------------------
@@ -542,8 +543,8 @@
Record all TL-specific changes, now and in the future.
After populating the new TL source directory ('.../newprog/', in the
-above), run GNU 'autoreconf' there (*note Build system tools::). Once
-that works, if you are the one who's eventually going to commit the new
+above), run GNU 'autoreconf' there (see Build system tools). Once that
+works, if you are the one who's eventually going to commit the new
package, 'svn add' the necessary files, including the generated
'Makefile.in aclocal.m4 configure', and 'svn:ignore' the Automake cache
'autom4te.cache'. (This is so people checking out the TL source tree do
@@ -600,8 +601,8 @@
fragment inserted with an Automake 'include'. This means that, for
instance, '$(srcdir)' is '.../web2c', not '.../webdir/enginedir'. It is
a difficult setup to come to terms with, but the alternative is to
-recurse into each engine subdirectory, and that would be far worse
-(*note (automake)Directories::).
+recurse into each engine subdirectory, and that would be far worse (see
+(automake)Directories).
6.6.3 Adding a new generic library module
-----------------------------------------
Modified: trunk/Build/source/README.5configure
===================================================================
--- trunk/Build/source/README.5configure 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/README.5configure 2025-02-10 18:36:39 UTC (rev 73848)
@@ -20,8 +20,8 @@
on the command line.
The './Build' script used to make the binaries shipped with TeX Live
-invokes the top-level 'configure' with a few additional options (*note
-Building::). The defaults discussed below are those for the actual
+invokes the top-level 'configure' with a few additional options (see
+Building). The defaults discussed below are those for the actual
'configure' script; invoking 'configure' via './Build' yields different
results.
@@ -43,8 +43,8 @@
are explicitly disabled), and enforces '--disable-shared'.
If building TL for a GNU/Linux or other distribution, this should be
-disabled and system versions of most libraries should be used (*note
-Distro builds::).
+disabled and system versions of most libraries should be used (see
+Distro builds).
A related option, '--enable-texlive-build', is automatically passed
to all subdirectories (and cannot be disabled). Subdirectories that can
@@ -56,11 +56,11 @@
---------------------------------
These standard Autoconf options specify various installation directories
-as usual. For the complete list, *note Installation directories::.
+as usual. For the complete list, see Installation directories.
Also as usual, all values are prefixed by the value of 'DESTDIR', if
-set, on the 'make' command line (*note Installation in a temporary
-location: (automake)Staged Installs.).
+set, on the 'make' command line (see Installation in a temporary
+location: (automake)Staged Installs).
7.1.3 '--disable-largefile'
---------------------------
@@ -95,7 +95,7 @@
If enabled (as it is for the native TL build), when using 'g++', try to
statically link with 'libstdc++', thus improving portability of the
-resulting binary. *Note Macros for compilers::.
+resulting binary. See Macros for compilers.
7.1.7 '--enable-maintainer-mode'
--------------------------------
@@ -102,9 +102,9 @@
Enable 'make' rules and dependencies not useful (and sometimes
confusing) to the casual user. This requires current versions of the
-GNU build tools (*note Build system tools::), as it automatically
-rebuilds infrastructure files as needed. *Note 'missing' and
-'AM_MAINTAINER_MODE': (automake)maintainer-mode.
+GNU build tools (see Build system tools), as it automatically rebuilds
+infrastructure files as needed. See 'missing' and 'AM_MAINTAINER_MODE':
+(automake)maintainer-mode.
7.1.8 '--enable-multiplatform'
------------------------------
@@ -161,7 +161,7 @@
program, which is specified with an additional '--enable' option, e.g.,
'--enable-dvipdfm-x'. It's still simplest to check out and configure
the whole source tree, but at least only the program you are interested
-in, and its dependencies, are built. *Note Build one package::.
+in, and its dependencies, are built. See Build one package.
Without this option, all modules are built except those that are
explicitly disabled or specify 'disable' in their 'ac/withenable.ac'
@@ -280,8 +280,8 @@
------------------------------------------
'--disable-linked-scripts'
-Do not install the "linked scripts" (*note Linked scripts::), except for
-the TL scripts required to run 'texlinks'.
+Do not install the "linked scripts" (see Linked scripts), except for the
+TL scripts required to run 'texlinks'.
7.2.8 Configure options for 'texk/xdvik'
----------------------------------------
@@ -358,7 +358,7 @@
(TFM file)
to generate the specified type of file dynamically. The default can be
-overridden by the user in any case (*note kpathsea library::).
+overridden by the user in any case (see kpathsea library).
7.4 Variables for configure
===========================
@@ -372,7 +372,7 @@
'CPPFLAGS'
And plenty more. As usual with Autoconf, these variables specify
the name (or full path) of compilers, preprocessor flags, and
- similar. *Note (autoconf)Preset Output Variables::.
+ similar. See (autoconf)Preset Output Variables.
'CLISP'
Name (or full path) of the 'clisp' executable, used to build
Modified: trunk/Build/source/doc/tlbuild-incl/install-tl.texi
===================================================================
--- trunk/Build/source/doc/tlbuild-incl/install-tl.texi 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/doc/tlbuild-incl/install-tl.texi 2025-02-10 18:36:39 UTC (rev 73848)
@@ -660,8 +660,11 @@
@item @code{TL_DOWNLOAD_ARGS}
@anchor{install-tl @code{TL_DOWNLOAD_ARGS}}
-These override the normal choice of a download program; see the @code{tlmgr}
-documentation, e.g.,
+ at item @code{TEXLIVE_PREFER_OWN}
+ at anchor{install-tl @code{TEXLIVE_PREFER_OWN}}
+
+These override the normal choice of the download and other utility
+programs; see the @code{tlmgr} documentation, e.g.,
@url{https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES}.
@item @code{TEXLIVE_INSTALL_ENV_NOCHECK}
@@ -803,5 +806,5 @@
distribution (@url{https://tug.org/texlive}) and both are licensed under the
GNU General Public License Version 2 or later.
-$Id: install-tl 69711 2024-02-05 17:23:27Z karl $
+$Id: install-tl 73024 2024-12-03 17:12:38Z karl $
Modified: trunk/Build/source/doc/tlbuild-incl/tlmgr.texi
===================================================================
--- trunk/Build/source/doc/tlbuild-incl/tlmgr.texi 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/doc/tlbuild-incl/tlmgr.texi 2025-02-10 18:36:39 UTC (rev 73848)
@@ -418,8 +418,8 @@
as any substring, and outputs bug-reporting and other information for
the package selected from the results.
-The search is equivalent to @code{tlmgr search --word --file @emph{search-string}.
-Thus, @emph{search-string} is interpreted as a (Perl) regular expression.}
+The search is equivalent to @code{tlmgr search --word --file} @emph{search-string}.
+Thus, @emph{search-string} is interpreted as a (Perl) regular expression.
@node tlmgr candidates @emph{pkg}
@appendixsubsec candidates @emph{pkg}
@@ -586,7 +586,7 @@
@anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json}}
Instead of dumping the actual content, the database is dumped as
-JSON. For the format of JSON output see @code{tlpkg/doc/JSON-formats.txt},
+JSON. For the format of JSON output see @code{tlpkg/doc/json-formats.txt},
format definition @code{TLPDB}.
@end table
@@ -625,7 +625,7 @@
The @code{generate} action overwrites any manual changes made in the
respective files: it recreates them from scratch based on the
-information of the installed packages, plus local adaptions.
+information of the installed packages, plus local adaptations.
The TeX Live installer and @code{tlmgr} routinely call @code{generate} for
all of these files.
@@ -789,6 +789,13 @@
When given with schemes and collections, @code{--list} outputs their
dependencies in a similar way.
+ at item @strong{@asis{}- at asis{}- at asis{}only-files}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}only-files}}
+
+If this option is given, only the files for a given package are listed,
+no further information. If more than one package name is given, each
+file list is preceded by the package name.
+
@item @strong{@asis{}- at asis{}- at asis{}only-installed}
@anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}only-installed}}
@@ -832,11 +839,11 @@
@item @strong{@asis{}- at asis{}- at asis{}json}
@anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json} 1}
-In case @code{--json} is specified, the output is a JSON encoded array where
-each array element is the JSON representation of a single @code{TLPOBJ} but
-with additional information. For details see
- at code{tlpkg/doc/JSON-formats.txt}, format definition: @code{TLPOBJINFO}. If both
- at code{--json} and @code{--data} are given, @code{--json} takes precedence.
+If @code{--json} is specified, the output is a JSON encoded array where each
+array element is the JSON representation of a single @code{TLPOBJ} but with
+additional information. For details see @code{tlpkg/doc/json-formats.txt},
+format definition: @code{TLPOBJINFO}. If both @code{--json} and @code{--data} are
+given, @code{--json} takes precedence.
@end table
@@ -989,7 +996,7 @@
Both @code{show...} forms take an option @code{--json}, which dumps the option
information in JSON format. In this case, both forms dump the same
data. For the format of the JSON output see
- at code{tlpkg/doc/JSON-formats.txt}, format definition @code{TLOPTION}.
+ at code{tlpkg/doc/json-formats.txt}, format definition @code{TLOPTION}.
In the third form, with @emph{key}, if @emph{value} is not given, the setting
for @emph{key} is displayed. If @emph{value} is present, @emph{key} is set to
@@ -1075,7 +1082,7 @@
@code{desktop_integration} is set, then some packages will install items in
a sub-folder of the Start menu for @code{tlmgr gui}, documentation, etc. If
@code{fileassocs} is set, Windows file associations are made (see also the
- at code{postaction} action). Finally, if @code{multiuser} is set, then adaptions
+ at code{postaction} action). Finally, if @code{multiuser} is set, then changes
to the registry and the menus are done for all users on the system
instead of only the current user. All three options are on by default.
@@ -1114,7 +1121,7 @@
If @code{--json} is specified without other options, the paper setup is
dumped in JSON format. For the format of JSON output see
- at code{tlpkg/doc/JSON-formats.txt}, format definition @code{TLPAPER}.
+ at code{tlpkg/doc/json-formats.txt}, format definition @code{TLPAPER}.
Incidentally, this syntax of having a specific program name before the
@code{paper} keyword is unusual. It is inherited from the longstanding
@@ -1380,7 +1387,9 @@
@item @strong{repository status}
@anchor{tlmgr @strong{repository status}}
-This action manages the list of repositories. See @ref{,,, MULTIPLE_REPOSITORIES} below for detailed explanations.
+This action manages the list of repositories. See @url{https://metacpan.org/pod/MULTIPLE
+REPOSITORIES, MULTIPLE
+REPOSITORIES} below for detailed explanations.
The first form, @code{repository list}, lists all configured repositories
and the respective tags if set. If a path, url, or tag is given after
@@ -1478,10 +1487,11 @@
@item @strong{@asis{}- at asis{}- at asis{}json}
@anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json} 2}
-When listing backups, the option @code{--json} turn on JSON output.
-The format is an array of JSON objects (@code{name}, @code{rev}, @code{date}).
-For details see @code{tlpkg/doc/JSON-formats.txt}, format definition: @code{TLBACKUPS}.
-If both @code{--json} and @code{--data} are given, @code{--json} takes precedence.
+When listing backups, the option @code{--json} writes JSON output. The
+format is an array of JSON objects (@code{name}, @code{rev}, @code{date}). For
+details see @code{tlpkg/doc/json-formats.txt}, format definition:
+ at code{TLBACKUPS}. If both @code{--json} and @code{--data} are given, @code{--json} takes
+precedence.
@end table
@@ -1531,6 +1541,13 @@
@code{table} with this option will not output packages containing the word
@code{tables} (unless they also contain the word @code{table} on its own).
+ at item @strong{@asis{}- at asis{}- at asis{}json}
+ at anchor{tlmgr @strong{@asis{}- at asis{}- at asis{}json} 3}
+
+Output search results as a JSON hash with two keys: @strong{files} and
+ at strong{packages}. For the format of the JSON output see
+ at code{tlpkg/doc/json-formats.txt}, format definition @code{TLSEARCH}.
+
@end table
@end table
@@ -2700,18 +2717,5 @@
distribution (@url{https://tug.org/texlive}) and both are licensed under the
GNU General Public License Version 2 or later.
-$Id: tlmgr.pl 70001 2024-02-19 23:17:07Z karl $
+$Id: tlmgr.pl 73493 2025-01-17 22:28:29Z karl $
- at node tlmgr POD ERRORS
- at appendixsec POD ERRORS
-
-Hey! @strong{The above document had some coding errors, which are explained below:}
-
- at table @asis
- at item Around line 8454:
- at anchor{tlmgr Around line 8454 at asis{:}}
-
-Unterminated C<...> sequence
-
- at end table
-
Modified: trunk/Build/source/doc/tlbuild.info
===================================================================
(Binary files differ)
Modified: trunk/Build/source/texk/texlive/tl_support/ChangeLog
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/ChangeLog 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/texk/texlive/tl_support/ChangeLog 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,10 @@
+2025-02-10 Karl Berry <karl at tug.org>
+
+ * Makefile.am (xmflua.1): new target.
+ (xmans): add xmflua.1.
+
2022-03-08 Karl Berry <karl at freefriends.org>
- *
* e2pall.1,
* fmtutil.cnf.5,
* fontinst.1,
Modified: trunk/Build/source/texk/texlive/tl_support/Makefile.am
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/Makefile.am 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/texk/texlive/tl_support/Makefile.am 2025-02-10 18:36:39 UTC (rev 73848)
@@ -56,8 +56,8 @@
## since we don't want to require help2man for an install. Leave that
## to be done by hand (see tlpkg/doc/releng.txt).
EXTRA_DIST = updmap.help2man fmtutil.help2man
-.PHONY: xmans xupdmap.1 xfmtutil.1
-xmans: xupdmap.1 xfmtutil.1
+.PHONY: xmans xupdmap.1 xfmtutil.1 xmflua.1
+xmans: xupdmap.1 xfmtutil.1 xmflua.1
Master_dir = $(top_srcdir)/../../../../Master
tl_scripts_dir = $(Master_dir)/texmf-dist/scripts/texlive
#
@@ -70,6 +70,11 @@
help2man --include=$< --source="TeX Live" --no-info \
$(tl_scripts_dir)/fmtutil.pl >/tmp/$@
groff -mandoc -Thtml /tmp/$@ >/tmp/$@.html
+#
+xmflua.1:
+ help2man --source="TeX Live" --no-info \
+ mflua >/tmp/$@
+ groff -mandoc -Thtml /tmp/$@ >/tmp/$@.html
##
## This target is invoked by the top-level make,
Modified: trunk/Build/source/texk/texlive/tl_support/Makefile.in
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/Makefile.in 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/texk/texlive/tl_support/Makefile.in 2025-02-10 18:36:39 UTC (rev 73848)
@@ -687,8 +687,8 @@
link=`echo $$s | sed 's,.*:,,'`; \
rm -f $(DESTDIR)$(man1dir)/$$link.1; \
done
-.PHONY: xmans xupdmap.1 xfmtutil.1
-xmans: xupdmap.1 xfmtutil.1
+.PHONY: xmans xupdmap.1 xfmtutil.1 xmflua.1
+xmans: xupdmap.1 xfmtutil.1 xmflua.1
#
xupdmap.1: updmap.help2man $(tl_scripts_dir)/updmap.pl
help2man --include=$< --source="TeX Live" --no-info \
@@ -699,6 +699,11 @@
help2man --include=$< --source="TeX Live" --no-info \
$(tl_scripts_dir)/fmtutil.pl >/tmp/$@
groff -mandoc -Thtml /tmp/$@ >/tmp/$@.html
+#
+xmflua.1:
+ help2man --source="TeX Live" --no-info \
+ mflua >/tmp/$@
+ groff -mandoc -Thtml /tmp/$@ >/tmp/$@.html
.PHONY: run-texlinks
#
Modified: trunk/Build/source/texk/texlive/tl_support/fmtutil.1
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/fmtutil.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/texk/texlive/tl_support/fmtutil.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
-.TH FMTUTIL "1" "February 2024" "TeX Live" "User Commands"
+.TH FMTUTIL "1" "February 2025" "TeX Live" "User Commands"
.SH NAME
fmtutil \- manage TeX formats and Metafont bases, per-user
.br
@@ -19,7 +19,7 @@
.B mktexfmt
\fI\,FORMAT.fmt|BASE.base|FMTNAME\/\fR
.SH DESCRIPTION
-fmtutil version r68962 (2023\-11\-25 00:01:43 +0100)
+fmtutil version r71424 (2024\-06\-04 12:25:53 +0200)
.PP
Rebuild and manage TeX fmts and Metafont bases, collectively called
"formats" here. (MetaPost no longer uses the past\-equivalent "mems".)
Modified: trunk/Build/source/texk/texlive/tl_support/updmap.1
===================================================================
--- trunk/Build/source/texk/texlive/tl_support/updmap.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Build/source/texk/texlive/tl_support/updmap.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,5 +1,5 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
-.TH UPDMAP "1" "February 2024" "TeX Live" "User Commands"
+.TH UPDMAP "1" "February 2025" "TeX Live" "User Commands"
.SH NAME
updmap \- manage TeX font maps
.br
@@ -16,7 +16,7 @@
.B updmap-sys
[\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR]
.SH DESCRIPTION
-updmap version r65932 (2023\-02\-19 21:49:48 +0100)
+updmap version r70707 (2024\-03\-19 23:03:22 +0100)
.PP
Update the default font map files used by pdftex and dvipdfm(x)
(pdftex.map), dvips (psfonts.map), and optionally pxdvi, as determined
@@ -27,6 +27,10 @@
should be used as bitmaps and which as outlines, and to determine which
font files are included, typically subsetted, in the PDF or PostScript output.
.PP
+These maps are for fonts installed within the TeX hierarchy, and are not
+related to any system font lookups. They are primarily used for Type 1
+fonts, though a few OpenType and TrueType fonts are involved also.
+.PP
updmap\-sys (or updmap \fB\-sys\fR) is intended to affect the system\-wide
configuration, while updmap\-user (or updmap \fB\-user\fR) affects personal
configuration files only, overriding the system files.
@@ -36,7 +40,8 @@
warning about this, since it is rarely desirable.
See https://tug.org/texlive/scripts\-sys\-user.html for details.
.PP
-By default, the TeX filename database (ls\-R) is also updated.
+By default, the TeX filename database (ls\-R) is also updated; use
+\fB\-\-nohash\fR to skip that step.
.PP
The updmap system is regrettably complicated, for both inherent and
historical reasons. A general overview:
@@ -48,8 +53,8 @@
.PP
\- updmap reads the updmap.cfg files and then concatenates the
.IP
-contents of those .map files into the main output files: psfonts.map
-for dvips and pdftex.map for pdftex and dvipdfmx.
+contents of those .map files into the main output files, generically
+named: psfonts.map for dvips, and pdftex.map for pdftex and dvipdfmx.
.PP
\- The updmap.cfg files themselves are created and updated at package
.IP
@@ -77,8 +82,9 @@
\fB\-\-outputdir\fR DIR
specify output directory (for all files)
.TP
-\fB\-\-copy\fR
-cp generic files rather than using symlinks
+\fB\-\-[no\-]copy\fR
+create generic files as copies (default);
+with \fB\-no\-copy\fR, create symlinks
.TP
\fB\-\-force\fR
recreate files even if config hasn't changed
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>A DVI-to-PNG translator</title>
@@ -65,46 +65,46 @@
-<div class="element-contents" id="SEC_Contents">
+<div class="region-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="toc-numbered-mark">
- <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
+ <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Installation" href="#Installation">2 Installation</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Prerequisites-1" href="#Prerequisites">2.1 Prerequisites</a></li>
- <li><a id="toc-Configure-1" href="#Configure">2.2 Configure</a></li>
- <li><a id="toc-Build_002finstall-1" href="#Build_002finstall">2.3 Build/install</a></li>
- <li><a id="toc-Installation-outside-the-texmf-tree-1" href="#Installation-outside-the-texmf-tree">2.4 Installation outside the texmf tree</a></li>
+ <li><a id="toc-Prerequisites" href="#Prerequisites">2.1 Prerequisites</a></li>
+ <li><a id="toc-Configure" href="#Configure">2.2 Configure</a></li>
+ <li><a id="toc-Build_002finstall" href="#Build_002finstall">2.3 Build/install</a></li>
+ <li><a id="toc-Installation-outside-the-texmf-tree" href="#Installation-outside-the-texmf-tree">2.4 Installation outside the texmf tree</a></li>
<li><a id="toc-Installation-for-non_002dprivileged-users" href="#Advice-for-non_002dprivileged-users">2.5 Installation for non-privileged users</a></li>
</ul></li>
<li><a id="toc-Basic-usage-of-dvipng" href="#Basic-usage">3 Basic usage of dvipng</a></li>
- <li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">4 Command-line options</a>
+ <li><a id="toc-Command_002dline-options" href="#Command_002dline-options">4 Command-line options</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Option-summary-1" href="#Option-summary">4.1 Option summary</a></li>
- <li><a id="toc-Option-details-1" href="#Option-details">4.2 Option details</a></li>
+ <li><a id="toc-Option-summary" href="#Option-summary">4.1 Option summary</a></li>
+ <li><a id="toc-Option-details" href="#Option-details">4.2 Option details</a></li>
</ul></li>
- <li><a id="toc-Graphics-1" href="#Graphics">5 Graphics</a>
+ <li><a id="toc-Graphics" href="#Graphics">5 Graphics</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Encapsulated-PostScript-1" href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a></li>
- <li><a id="toc-Bitmapped-graphics-1" href="#Bitmapped-graphics">5.2 Bitmapped graphics</a></li>
- <li><a id="toc-Raw-PostScript-1" href="#Raw-PostScript">5.3 Raw PostScript</a></li>
+ <li><a id="toc-Encapsulated-PostScript" href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a></li>
+ <li><a id="toc-Bitmapped-graphics" href="#Bitmapped-graphics">5.2 Bitmapped graphics</a></li>
+ <li><a id="toc-Raw-PostScript" href="#Raw-PostScript">5.3 Raw PostScript</a></li>
</ul></li>
- <li><a id="toc-Color-1" href="#Color">6 Color</a>
+ <li><a id="toc-Color" href="#Color">6 Color</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Color-specifications-1" href="#Color-specifications">6.1 Color specifications</a></li>
- <li><a id="toc-Color-specials-1" href="#Color-specials">6.2 Color specials</a></li>
+ <li><a id="toc-Color-specifications" href="#Color-specifications">6.1 Color specifications</a></li>
+ <li><a id="toc-Color-specials" href="#Color-specials">6.2 Color specials</a></li>
</ul></li>
- <li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">7 Diagnosing problems</a>
+ <li><a id="toc-Diagnosing-problems" href="#Diagnosing-problems">7 Diagnosing problems</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Contact-information-1" href="#Contact-information">7.1 Contact information</a></li>
- <li><a id="toc-Debug-options-1" href="#Debug-options">7.2 Debug options</a></li>
+ <li><a id="toc-Contact-information" href="#Contact-information">7.1 Contact information</a></li>
+ <li><a id="toc-Debug-options" href="#Debug-options">7.2 Debug options</a></li>
</ul></li>
- <li><a id="toc-Credits-1" href="#Credits">8 Credits</a></li>
- <li><a id="toc-Copying-1" href="#Copying">9 Copying</a></li>
- <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
+ <li><a id="toc-Credits" href="#Credits">8 Credits</a></li>
+ <li><a id="toc-Copying" href="#Copying">9 Copying</a></li>
+ <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
</ul>
</div>
</div>
@@ -133,16 +133,11 @@
within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs
buffer, see <a class="url" href="http://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</a>.
</p>
-<p>Another example is WeBWorK, an internet-based method for delivering
-homework problems to students over the internet, giving students
-instant feedback as to whether or not their answers are correct, see
-<a class="url" href="http://webwork.math.rochester.edu">http://webwork.math.rochester.edu</a>.
+<p>It is also used in MediaWiki, the software behind Wikipedia and many
+other wikis out there. Dvipng is used to render mathematical formulae
+(in image mode) from version 1.8.0 of MediaWiki, see
+<a class="url" href="http://www.mediawiki.org">http://www.mediawiki.org</a>.
</p>
-<p>A more recent addition to the dvipng-using applications out there is
-MediaWiki, the software behind Wikipedia and many other wikis out
-there. Dvipng is used to render mathematical formulae from version
-1.8.0 of MediaWiki, see <a class="url" href="http://www.mediawiki.org">http://www.mediawiki.org</a>.
-</p>
<p>Other applications may also benefit, like web applications as latex2html
and WYSIWYG editors like LyX.
</p>
@@ -461,7 +456,7 @@
dvipng with no arguments or with the standard ‘<samp class="samp">--help</samp>’ option.
</p>
<div class="example">
-<pre class="example-preformatted">This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson
+<pre class="example-preformatted">This is ./dvipng 1.18 Copyright 2002-2015, 2019 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -1340,7 +1335,7 @@
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
</td></tr></table>
-<table class="cp-entries-printindex" border="0">
+<table class="cp-entries-printindex">
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th></tr>
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvips/dvips.html 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/dvips/dvips.html 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,10 +1,10 @@
<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<!-- This manual documents Dvips version 2024.1
-(February 2024), a program to translate a DVI file into
+<!-- This manual documents Dvips version 2025.1
+(January 2025), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file. -->
<title>Dvips: A DVI-to-PostScript translator</title>
@@ -58,29 +58,29 @@
</div>
<h1 class="top" id="Dvips"><span>Dvips<a class="copiable-link" href="#Dvips"> ¶</a></span></h1>
-<p>This manual documents Dvips version 2024.1
-(February 2024), a program to translate a DVI file into
+<p>This manual documents Dvips version 2025.1
+(January 2025), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
</p>
-<div class="element-shortcontents" id="SEC_Shortcontents">
+<div class="region-shortcontents" id="SEC_Shortcontents">
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="toc-numbered-mark">
<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li>
-<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li>
-<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li>
+<li><a id="stoc-Installation" href="#toc-Installation">2 Installation</a></li>
+<li><a id="stoc-Invoking-Dvips" href="#toc-Invoking-Dvips">3 Invoking Dvips</a></li>
<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li>
-<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li>
-<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li>
-<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li>
-<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li>
+<li><a id="stoc-Interaction-with-PostScript" href="#toc-Interaction-with-PostScript">5 Interaction with PostScript</a></li>
+<li><a id="stoc-PostScript-fonts" href="#toc-PostScript-fonts">6 PostScript fonts</a></li>
+<li><a id="stoc-Color" href="#toc-Color">7 Color</a></li>
+<li><a id="stoc-Index" href="#toc-Index" rel="index">Index</a></li>
</ul>
</div>
</div>
-<div class="element-contents" id="SEC_Contents">
+<div class="region-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -87,118 +87,118 @@
<ul class="toc-numbered-mark">
<li><a id="toc-Why-use-Dvips_003f" href="#Why-Dvips">1 Why use Dvips?</a></li>
- <li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
+ <li><a id="toc-Installation" href="#Installation">2 Installation</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-config_002eps-installation-1" href="#config_002eps-installation">2.1 <samp class="file">config.ps</samp> installation</a></li>
- <li><a id="toc-PostScript-font-installation-1" href="#PostScript-font-installation">2.2 PostScript font installation</a></li>
- <li><a id="toc-Ghostscript-installation-1" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li>
- <li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">2.4 Diagnosing problems</a>
+ <li><a id="toc-config_002eps-installation" href="#config_002eps-installation">2.1 <samp class="file">config.ps</samp> installation</a></li>
+ <li><a id="toc-PostScript-font-installation" href="#PostScript-font-installation">2.2 PostScript font installation</a></li>
+ <li><a id="toc-Ghostscript-installation" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li>
+ <li><a id="toc-Diagnosing-problems" href="#Diagnosing-problems">2.4 Diagnosing problems</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Debug-options-1" href="#Debug-options">2.4.1 Debug options</a></li>
+ <li><a id="toc-Debug-options" href="#Debug-options">2.4.1 Debug options</a></li>
<li><a id="toc-No-output-at-all" href="#No-output">2.4.2 No output at all</a></li>
<li><a id="toc-Output-too-small-or-inverted" href="#Small-or-inverted">2.4.3 Output too small or inverted</a></li>
<li><a id="toc-Error-messages-from-printer" href="#Printer-errors">2.4.4 Error messages from printer</a></li>
<li><a id="toc-Long-documents-fail-to-print" href="#Long-documents-fail">2.4.5 Long documents fail to print</a></li>
- <li><a id="toc-Including-graphics-fails-1" href="#Including-graphics-fails">2.4.6 Including graphics fails</a></li>
+ <li><a id="toc-Including-graphics-fails" href="#Including-graphics-fails">2.4.6 Including graphics fails</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Invoking-Dvips-1" href="#Invoking-Dvips">3 Invoking Dvips</a>
+ <li><a id="toc-Invoking-Dvips" href="#Invoking-Dvips">3 Invoking Dvips</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Basic-usage-of-Dvips" href="#Basic-usage">3.1 Basic usage of Dvips</a></li>
- <li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">3.2 Command-line options</a>
+ <li><a id="toc-Command_002dline-options" href="#Command_002dline-options">3.2 Command-line options</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Option-summary-1" href="#Option-summary">3.2.1 Option summary</a></li>
- <li><a id="toc-Option-details-1" href="#Option-details">3.2.2 Option details</a></li>
+ <li><a id="toc-Option-summary" href="#Option-summary">3.2.1 Option summary</a></li>
+ <li><a id="toc-Option-details" href="#Option-details">3.2.2 Option details</a></li>
</ul></li>
- <li><a id="toc-Environment-variables-1" href="#Environment-variables">3.3 Environment variables</a></li>
+ <li><a id="toc-Environment-variables" href="#Environment-variables">3.3 Environment variables</a></li>
<li><a id="toc-Dvips-configuration-files" href="#Config-files">3.4 Dvips configuration files</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Configuration-file-searching-1" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li>
- <li><a id="toc-Configuration-file-commands-1" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li>
+ <li><a id="toc-Configuration-file-searching" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li>
+ <li><a id="toc-Configuration-file-commands" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Paper-size-and-landscape-orientation" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-papersize-special-1" href="#papersize-special">4.1 ‘<samp class="samp">papersize</samp>’ special</a></li>
+ <li><a id="toc-papersize-special" href="#papersize-special">4.1 ‘<samp class="samp">papersize</samp>’ special</a></li>
<li><a id="toc-Configuration-file-paper-size-command" href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a></li>
- <li><a id="toc-Paper-trays-1" href="#Paper-trays">4.3 Paper trays</a></li>
+ <li><a id="toc-Paper-trays" href="#Paper-trays">4.3 Paper trays</a></li>
</ul></li>
- <li><a id="toc-Interaction-with-PostScript-1" href="#Interaction-with-PostScript">5 Interaction with PostScript</a>
+ <li><a id="toc-Interaction-with-PostScript" href="#Interaction-with-PostScript">5 Interaction with PostScript</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-PostScript-figures-1" href="#PostScript-figures">5.1 PostScript figures</a>
+ <li><a id="toc-PostScript-figures" href="#PostScript-figures">5.1 PostScript figures</a>
<ul class="toc-numbered-mark">
<li><a id="toc-The-bounding-box-comment" href="#Bounding-box">5.1.1 The bounding box comment</a></li>
<li><a id="toc-The-_005cincludegraphics-macro-for-LaTeX" href="#g_t_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a></li>
<li><a id="toc-Using-the-EPSF-macros" href="#EPSF-macros">5.1.3 Using the EPSF macros</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-EPSF-scaling-1" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li>
- <li><a id="toc-EPSF-clipping-1" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li>
+ <li><a id="toc-EPSF-scaling" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li>
+ <li><a id="toc-EPSF-clipping" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li>
</ul></li>
- <li><a id="toc-psfile-special-1" href="#psfile-special">5.1.4 ‘<samp class="samp">psfile</samp>’ special</a></li>
+ <li><a id="toc-psfile-special" href="#psfile-special">5.1.4 ‘<samp class="samp">psfile</samp>’ special</a></li>
<li><a id="toc-Dynamic-creation-of-PostScript-graphics-files" href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a></li>
- <li><a id="toc-Fonts-in-figures-1" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li>
+ <li><a id="toc-Fonts-in-figures" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li>
</ul></li>
<li><a id="toc-PostScript-header-files" href="#Header-files">5.2 PostScript header files</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Including-headers-from-TeX-1" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li>
- <li><a id="toc-Including-headers-from-the-command-line-1" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li>
- <li><a id="toc-Headers-and-memory-usage-1" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li>
+ <li><a id="toc-Including-headers-from-TeX" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li>
+ <li><a id="toc-Including-headers-from-the-command-line" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li>
+ <li><a id="toc-Headers-and-memory-usage" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li>
</ul></li>
<li><a id="toc-Literal-PostScript" href="#Literal-PS">5.3 Literal PostScript</a>
<ul class="toc-numbered-mark">
<li><a id="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code class="code">"</code> special: Literal PostScript</a></li>
- <li><a id="toc-ps-special-1" href="#ps-special">5.3.2 ‘<samp class="samp">ps</samp>’ special</a></li>
+ <li><a id="toc-ps-special" href="#ps-special">5.3.2 ‘<samp class="samp">ps</samp>’ special</a></li>
<li><a id="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp class="samp">!</samp>’ <code class="code">\special</code></a></li>
- <li><a id="toc-PostScript-hooks-1" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li>
- <li><a id="toc-Literal-examples-1" href="#Literal-examples">5.3.5 Literal examples</a></li>
+ <li><a id="toc-PostScript-hooks" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li>
+ <li><a id="toc-Literal-examples" href="#Literal-examples">5.3.5 Literal examples</a></li>
</ul></li>
<li><a id="toc-HyperTeXt" href="#Hypertext">5.4 HyperTeXt</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Hypertext-caveats-1" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li>
- <li><a id="toc-Hypertext-specials-1" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li>
+ <li><a id="toc-Hypertext-caveats" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li>
+ <li><a id="toc-Hypertext-specials" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-PostScript-fonts-1" href="#PostScript-fonts">6 PostScript fonts</a>
+ <li><a id="toc-PostScript-fonts" href="#PostScript-fonts">6 PostScript fonts</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Font-concepts-1" href="#Font-concepts">6.1 Font concepts</a>
+ <li><a id="toc-Font-concepts" href="#Font-concepts">6.1 Font concepts</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Metric-files-1" href="#Metric-files">6.1.1 Metric files</a></li>
- <li><a id="toc-Glyph-files-1" href="#Glyph-files">6.1.2 Glyph files</a></li>
- <li><a id="toc-Virtual-fonts-1" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li>
- <li><a id="toc-Encodings-1" href="#Encodings">6.1.4 Encodings</a></li>
- <li><a id="toc-Bitmap-font-encodings-1" href="#Bitmap-font-encodings">6.1.5 Bitmap font encodings</a></li>
+ <li><a id="toc-Metric-files" href="#Metric-files">6.1.1 Metric files</a></li>
+ <li><a id="toc-Glyph-files" href="#Glyph-files">6.1.2 Glyph files</a></li>
+ <li><a id="toc-Virtual-fonts" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li>
+ <li><a id="toc-Encodings" href="#Encodings">6.1.4 Encodings</a></li>
+ <li><a id="toc-Bitmap-font-encodings" href="#Bitmap-font-encodings">6.1.5 Bitmap font encodings</a></li>
<li><a id="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.6 How PostScript typesets a character</a></li>
</ul></li>
<li><a id="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li>
<li><a id="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Changing-font-encodings-1" href="#Changing-font-encodings">6.3.1 Changing font encodings</a>
+ <li><a id="toc-Changing-font-encodings" href="#Changing-font-encodings">6.3.1 Changing font encodings</a>
<ul class="toc-numbered-mark">
<li><a id="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp class="samp">-t</samp>’: Changing TeX encodings</a></li>
<li><a id="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp class="samp">-p</samp>’: Changing PostScript encodings</a></li>
<li><a id="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp class="samp">-T</samp>’: Changing both TeX and PostScript encodings</a></li>
- <li><a id="toc-Reencoding-with-Afm2tfm-1" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li>
- <li><a id="toc-Encoding-file-format-1" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li>
+ <li><a id="toc-Reencoding-with-Afm2tfm" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li>
+ <li><a id="toc-Encoding-file-format" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li>
</ul></li>
- <li><a id="toc-Special-font-effects-1" href="#Special-font-effects">6.3.2 Special font effects</a></li>
- <li><a id="toc-Afm2tfm-options-1" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li>
+ <li><a id="toc-Special-font-effects" href="#Special-font-effects">6.3.2 Special font effects</a></li>
+ <li><a id="toc-Afm2tfm-options" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li>
</ul></li>
<li><a id="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp class="file">psfonts.map</samp>: PostScript font catalog</a></li>
</ul></li>
- <li><a id="toc-Color-1" href="#Color">7 Color</a>
+ <li><a id="toc-Color" href="#Color">7 Color</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Color-macro-files-1" href="#Color-macro-files">7.1 Color macro files</a></li>
- <li><a id="toc-User_002ddefinable-colors-1" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li>
- <li><a id="toc-Color-subtleties-1" href="#Color-subtleties">7.3 Color subtleties</a></li>
+ <li><a id="toc-Color-macro-files" href="#Color-macro-files">7.1 Color macro files</a></li>
+ <li><a id="toc-User_002ddefinable-colors" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li>
+ <li><a id="toc-Color-subtleties" href="#Color-subtleties">7.3 Color subtleties</a></li>
<li><a id="toc-Printing-in-black_002fwhite-after-colorizing" href="#Ted-Turner">7.4 Printing in black/white after colorizing</a></li>
- <li><a id="toc-Color-device-configuration-1" href="#Color-device-configuration">7.5 Color device configuration</a></li>
- <li><a id="toc-Color-support-details-1" href="#Color-support-details">7.6 Color support details</a>
+ <li><a id="toc-Color-device-configuration" href="#Color-device-configuration">7.5 Color device configuration</a></li>
+ <li><a id="toc-Color-support-details" href="#Color-support-details">7.6 Color support details</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Color-specifications-1" href="#Color-specifications">7.6.1 Color specifications</a></li>
- <li><a id="toc-Color-specials-1" href="#Color-specials">7.6.2 Color specials</a></li>
+ <li><a id="toc-Color-specifications" href="#Color-specifications">7.6.1 Color specifications</a></li>
+ <li><a id="toc-Color-specials" href="#Color-specials">7.6.2 Color specials</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
+ <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
</ul>
</div>
</div>
@@ -5448,7 +5448,7 @@
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
</td></tr></table>
-<table class="cp-entries-printindex" border="0">
+<table class="cp-entries-printindex">
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th></tr>
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/info/dvipng.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/dvipng.info 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/info/dvipng.info 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-This is dvipng.info, produced by makeinfo version 5.1 from dvipng.texi.
+This is dvipng.info, produced by makeinfo version 6.7 from dvipng.texi.
INFO-DIR-SECTION TeX
START-INFO-DIR-ENTRY
@@ -19,7 +19,7 @@
Corrections or perhaps rewrites of sections are _very welcome_.
- Jan-AAke Larsson
+ Jan-Åke Larsson
* Menu:
@@ -53,16 +53,11 @@
within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs
buffer, see <http://www.gnu.org/software/auctex/preview-latex.html>.
- Another example is WeBWorK, an internet-based method for delivering
-homework problems to students over the internet, giving students instant
-feedback as to whether or not their answers are correct, see
-<http://webwork.math.rochester.edu>.
+ It is also used in MediaWiki, the software behind Wikipedia and many
+other wikis out there. Dvipng is used to render mathematical formulae
+(in image mode) from version 1.8.0 of MediaWiki, see
+<http://www.mediawiki.org>.
- A more recent addition to the dvipng-using applications out there is
-MediaWiki, the software behind Wikipedia and many other wikis out there.
-Dvipng is used to render mathematical formulae from version 1.8.0 of
-MediaWiki, see <http://www.mediawiki.org>.
-
Other applications may also benefit, like web applications as
latex2html and WYSIWYG editors like LyX.
@@ -315,7 +310,7 @@
Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard '--help' option.
- This is ./dvipng 1.17 Copyright 2002-2015, 2019 Jan-Ake Larsson
+ This is ./dvipng 1.18 Copyright 2002-2015, 2019 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -358,6 +353,7 @@
# = number f = file s = string * = suffix, '0' to turn off
c = comma-separated dimension pair (e.g., 3.2in,-32.1cm)
+
File: dvipng.info, Node: Option details, Prev: Option summary, Up: Command-line options
@@ -959,7 +955,7 @@
Alcock, Adam Buchbinder, Svend Tollak Munkejord, James Longstreet,
Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer, Brian V.
Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson, Christian
-Ridderstro"m, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald
+Ridderström, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald
Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard
Kotucha, Takeshi Abe, Waldeck Schutzer, Ahzo, and Andy Nguyen.
@@ -985,7 +981,7 @@
-Copyright (C) 2002-2015, 2019 Jan-AAke Larsson
+Copyright (C) 2002-2015, 2019 Jan-Åke Larsson
File: dvipng.info, Node: Index, Prev: Copying, Up: Top
@@ -997,8 +993,8 @@
* Menu:
* -dSAFER: Option details. (line 167)
-* absolute page number, and '-l': Option details. (line 141)
-* absolute page number, and '-p': Option details. (line 194)
+* absolute page number, and -l: Option details. (line 141)
+* absolute page number, and -p: Option details. (line 194)
* antialiasing levels, number of: Option details. (line 247)
* background color (option): Option details. (line 40)
* base resolution, setting: Option details. (line 33)
@@ -1048,8 +1044,8 @@
* page range: Option details. (line 225)
* page, first printed: Option details. (line 194)
* page, last printed: Option details. (line 141)
-* physical page number, and '-l': Option details. (line 141)
-* physical page number, and '-p': Option details. (line 194)
+* physical page number, and -l: Option details. (line 141)
+* physical page number, and -p: Option details. (line 194)
* PNG image format: Option details. (line 221)
* PostScript inclusion problems: Encapsulated PostScript.
(line 21)
@@ -1074,28 +1070,33 @@
Tag Table:
Node: Top296
Node: Introduction1191
-Node: Installation3436
-Node: Prerequisites3783
-Node: Configure5822
-Node: Build/install7869
-Node: Installation outside the texmf tree8337
-Node: Advice for non-privileged users9047
-Node: Basic usage10058
-Node: Command-line options11202
-Node: Option summary11625
-Node: Option details13993
-Node: Graphics29167
-Node: Encapsulated PostScript29922
-Node: Bitmapped graphics31272
-Node: Raw PostScript32500
-Node: Color34753
-Node: Color specifications35142
-Node: Color specials36245
-Node: Diagnosing problems37662
-Node: Contact information38146
-Node: Debug options38874
-Node: Credits39863
-Node: Copying41088
-Node: Index41875
+Node: Installation3160
+Node: Prerequisites3507
+Node: Configure5546
+Node: Build/install7593
+Node: Installation outside the texmf tree8061
+Node: Advice for non-privileged users8771
+Node: Basic usage9782
+Node: Command-line options10926
+Node: Option summary11349
+Node: Option details13718
+Node: Graphics28892
+Node: Encapsulated PostScript29647
+Node: Bitmapped graphics30997
+Node: Raw PostScript32225
+Node: Color34478
+Node: Color specifications34867
+Node: Color specials35970
+Node: Diagnosing problems37387
+Node: Contact information37871
+Node: Debug options38599
+Node: Credits39588
+Node: Copying40813
+Node: Index41600
End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End:
Modified: trunk/Master/texmf-dist/doc/info/dvips.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/dvips.info 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/info/dvips.info 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,6 @@
-This is dvips.info, produced by makeinfo version 6.5 from dvips.texi.
+This is dvips.info, produced by makeinfo version 6.7 from dvips.texi.
-This manual documents Dvips version 2024.1 (February 2024), a program to
+This manual documents Dvips version 2025.1 (January 2025), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
INFO-DIR-SECTION TeX
@@ -16,7 +16,7 @@
Dvips
*****
-This manual documents Dvips version 2024.1 (February 2024), a program to
+This manual documents Dvips version 2025.1 (January 2025), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
@@ -4754,83 +4754,88 @@
Tag Table:
-Node: Top521
-Node: Why Dvips1271
-Node: Installation3854
-Node: config.ps installation4789
-Node: PostScript font installation7396
-Node: Ghostscript installation8316
-Node: Diagnosing problems9255
-Node: Debug options10346
-Node: No output11350
-Node: Small or inverted12816
-Node: Printer errors13534
-Node: Long documents fail14866
-Node: Including graphics fails15207
-Node: Invoking Dvips16446
-Node: Basic usage17037
-Node: Command-line options18035
-Node: Option summary18483
-Node: Option details20758
-Node: Environment variables41581
-Node: Config files44442
-Node: Configuration file searching45112
-Node: Configuration file commands48309
-Node: Paper size and landscape56514
-Node: papersize special58139
-Node: Config file paper sizes59846
-Node: Paper trays64869
-Node: Interaction with PostScript66203
-Node: PostScript figures66856
-Node: Bounding box67582
-Node: \includegraphics70954
-Node: EPSF macros73246
-Node: EPSF scaling75214
-Node: EPSF clipping77784
-Node: psfile special78426
-Node: Dynamic creation of graphics80818
-Node: Fonts in figures82136
-Node: Header files83786
-Node: Including headers from TeX84992
-Node: Including headers from the command line87030
-Node: Headers and memory usage88129
-Node: Literal PS89340
-Node: " special89922
-Node: ps special90663
-Node: Literal headers92161
-Node: PostScript hooks92870
-Node: Literal examples94966
-Node: Hypertext96420
-Node: Hypertext caveats97594
-Node: Hypertext specials101722
-Node: PostScript fonts104356
-Node: Font concepts105473
-Node: Metric files106703
-Node: Glyph files109483
-Node: Virtual fonts111842
-Node: Encodings113997
-Node: Bitmap font encodings116399
-Node: PostScript typesetting118929
-Node: Making a font available122026
-Node: Invoking afm2tfm127060
-Node: Changing font encodings128080
-Node: Changing TeX encodings128871
-Node: Changing PostScript encodings129973
-Node: Changing both encodings131317
-Node: Reencoding with Afm2tfm131991
-Node: Encoding file format135094
-Node: Special font effects139298
-Node: Afm2tfm options141558
-Node: psfonts.map145083
-Node: Color149813
-Node: Color macro files150857
-Node: User-definable colors154067
-Node: Color subtleties155343
-Node: Ted Turner156995
-Node: Color device configuration158220
-Node: Color support details160664
-Node: Color specifications161042
-Node: Color specials162446
-Node: Index164575
+Node: Top520
+Node: Why Dvips1269
+Node: Installation3852
+Node: config.ps installation4787
+Node: PostScript font installation7394
+Node: Ghostscript installation8314
+Node: Diagnosing problems9253
+Node: Debug options10344
+Node: No output11348
+Node: Small or inverted12814
+Node: Printer errors13532
+Node: Long documents fail14864
+Node: Including graphics fails15205
+Node: Invoking Dvips16444
+Node: Basic usage17035
+Node: Command-line options18033
+Node: Option summary18481
+Node: Option details20756
+Node: Environment variables41579
+Node: Config files44440
+Node: Configuration file searching45110
+Node: Configuration file commands48307
+Node: Paper size and landscape56512
+Node: papersize special58137
+Node: Config file paper sizes59844
+Node: Paper trays64867
+Node: Interaction with PostScript66201
+Node: PostScript figures66854
+Node: Bounding box67580
+Node: \includegraphics70952
+Node: EPSF macros73244
+Node: EPSF scaling75212
+Node: EPSF clipping77782
+Node: psfile special78424
+Node: Dynamic creation of graphics80816
+Node: Fonts in figures82134
+Node: Header files83784
+Node: Including headers from TeX84990
+Node: Including headers from the command line87028
+Node: Headers and memory usage88127
+Node: Literal PS89338
+Node: " special89920
+Node: ps special90661
+Node: Literal headers92159
+Node: PostScript hooks92868
+Node: Literal examples94964
+Node: Hypertext96418
+Node: Hypertext caveats97592
+Node: Hypertext specials101720
+Node: PostScript fonts104354
+Node: Font concepts105471
+Node: Metric files106701
+Node: Glyph files109481
+Node: Virtual fonts111840
+Node: Encodings113995
+Node: Bitmap font encodings116397
+Node: PostScript typesetting118927
+Node: Making a font available122024
+Node: Invoking afm2tfm127058
+Node: Changing font encodings128078
+Node: Changing TeX encodings128869
+Node: Changing PostScript encodings129971
+Node: Changing both encodings131315
+Node: Reencoding with Afm2tfm131989
+Node: Encoding file format135092
+Node: Special font effects139296
+Node: Afm2tfm options141556
+Node: psfonts.map145081
+Node: Color149811
+Node: Color macro files150855
+Node: User-definable colors154065
+Node: Color subtleties155341
+Node: Ted Turner156993
+Node: Color device configuration158218
+Node: Color support details160662
+Node: Color specifications161040
+Node: Color specials162444
+Node: Index164573
End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End:
Modified: trunk/Master/texmf-dist/doc/info/kpathsea.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/kpathsea.info 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/info/kpathsea.info 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,9 +1,9 @@
-This is kpathsea.info, produced by makeinfo version 7.1 from
+This is kpathsea.info, produced by makeinfo version 7.2 from
kpathsea.texi.
This file documents the Kpathsea library for path searching.
- Copyright © 1996-2024 Karl Berry & Olaf Weber.
+ Copyright © 1996-2025 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -37,7 +37,7 @@
****************
This manual documents the Kpathsea library for path searching. It
-corresponds to version 6.4.0, released in January 2024.
+corresponds to version 6.4.0, released in January 2025.
* Menu:
@@ -62,7 +62,7 @@
**************
This manual corresponds to version 6.4.0 of the Kpathsea library,
-released in January 2024.
+released in January 2025.
The library's fundamental purpose is to return a filename from a list
of directories specified by the user, similar to what shells do when
@@ -72,9 +72,9 @@
this library:
• Dviljk (see the ‘dvilj’ man page)
- • Dvipsk (*note (dvips)::)
- • GNU font utilities (*note (fontu)::)
- • Web2c (*note (web2c)::)
+ • Dvipsk (*note (dvips)Top::)
+ • GNU font utilities (*note (fontu)Top::)
+ • Web2c (*note (web2c)Top::)
• Xdvik (see the ‘xdvi’ man page)
Other software that we do not maintain also uses it.
@@ -82,7 +82,7 @@
Kpathsea is now maintained as part of the TeX Live distribution
(<https://tug.org/texlive>), which includes several more Kpathsea-using
programs. For information on configuration, building, installing, and
-more, *note (tlbuild)::.
+more, *note (tlbuild)Top::.
The library is still actively maintained. If you have comments or
suggestions, please send along (*note Reporting bugs::).
@@ -1219,8 +1219,16 @@
can start with either ‘-’ or ‘--’, and any unambiguous abbreviation is
accepted.
+ Kpsewhich looks up each non-option argument on the command line as a
+filename, and outputs (by default) the first file found to standard
+output. If a file is not found, and more than FILENAME is given, a
+blank line is output for that file. See examples below.
+
+ The exit status is zero if all files were found, nonzero otherwise.
+
* Menu:
+* kpsewhich examples:: Simple examples of running kpsewhich.
* Path searching options:: Changing the mode, resolution, etc.
* Specially-recognized files:: Default formats for texmf.cnf, etc.
* Auxiliary tasks:: Path and variable expansion, etc.
@@ -1227,16 +1235,40 @@
* Standard options:: ‘--help’ and ‘--version’.
-File: kpathsea.info, Node: Path searching options, Next: Specially-recognized files, Up: Invoking kpsewhich
+File: kpathsea.info, Node: kpsewhich examples, Next: Path searching options, Up: Invoking kpsewhich
-5.6.1 Path searching options
+5.6.1 ‘kpsewhich’ examples
+--------------------------
+
+Some examples of running ‘kpsewhich’ with a typical TeX tree. A basic
+successful search (exit status 0):
+
+ $ kpsewhich plain.tex
+ /usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
+
+ Searching for multiple files, one of which is not found (exit status
+is 1 for this):
+
+ $ kpsewhich plain.tex foobar plain.mf
+ /usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
+
+ /usr/local/texlive/2024/texmf-dist/metafont/base/plain.mf
+
+ Using ‘--all’ to see all files by the same name (exit status 0):
+
+ $ kpsewhich --all language.dat
+ /usr/local/texlive/2024/texmf-dist/tex/generic/config/language.dat
+ /usr/local/texlive/2024/texmf-dist/lambda/generic/config/language.dat
+
+
+File: kpathsea.info, Node: Path searching options, Next: Specially-recognized files, Prev: kpsewhich examples, Up: Invoking kpsewhich
+
+5.6.2 Path searching options
----------------------------
-Kpsewhich looks up each non-option argument on the command line as a
-filename, and returns the first file found.
+Various options alter the path searching behavior. Options apply to all
+lookups.
- Various options alter the path searching behavior:
-
‘--all’
Report all matches found, one per line. By default, if there is
more than one match, just one will be reported (chosen effectively
@@ -1243,6 +1275,11 @@
at random). Exception: with the glyph formats (‘pk’, ‘gf’), this
option has no effect and only the first match is returned.
+ With both ‘-all’ and multiple input files, there's no easy way to
+ discern which matches belong to which files; you have to check the
+ basename of the output. This could be improved, if there is any
+ demand.
+
‘--casefold-search’
‘--no-casefold-search’
Explicitly enable or disable the fallback to a case-insensitive
@@ -1475,7 +1512,7 @@
File: kpathsea.info, Node: Specially-recognized files, Next: Auxiliary tasks, Prev: Path searching options, Up: Invoking kpsewhich
-5.6.2 Specially-recognized files for ‘kpsewhich’
+5.6.3 Specially-recognized files for ‘kpsewhich’
------------------------------------------------
‘kpsewhich’ recognizes a few special filenames on the command line and
@@ -1525,7 +1562,7 @@
File: kpathsea.info, Node: Auxiliary tasks, Next: Standard options, Prev: Specially-recognized files, Up: Invoking kpsewhich
-5.6.3 Auxiliary tasks
+5.6.4 Auxiliary tasks
---------------------
Kpsewhich provides some features in addition to path lookup as such:
@@ -1619,7 +1656,7 @@
File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invoking kpsewhich
-5.6.4 Standard options
+5.6.5 Standard options
----------------------
Kpsewhich accepts the standard GNU options:
@@ -2084,7 +2121,7 @@
Fontmaps are implemented in the file ‘kpathsea/fontmap.c’. The
Fontname distribution has much more information on font naming (*note
-(fontname)::).
+(fontname)Top::).
File: kpathsea.info, Node: Fallback font, Prev: Fontmap, Up: Glyph lookup
@@ -2574,7 +2611,7 @@
• When set to ‘a’ (for "any"), no restrictions are imposed.
• When is set to ‘r’ (for "restricted"), filenames beginning with ‘.’
- are disallowed (except ‘.tex’, because LaTeX needs it).
+ are disallowed.
• When set to ‘p’ (for "paranoid"), additional restrictions are
imposed.
@@ -3154,41 +3191,41 @@
* Menu:
* --all: Path searching options.
- (line 12)
+ (line 10)
* --casefold-search: Path searching options.
- (line 19)
+ (line 22)
* --cnf-line: Path searching options.
- (line 28)
+ (line 31)
* --cnf-line, source for path: Path sources. (line 9)
* --color=tty: ls-R. (line 25)
* --debug=NUM: Auxiliary tasks. (line 9)
* --dpi=NUM: Path searching options.
- (line 49)
+ (line 52)
* --engine=NAME: Path searching options.
- (line 53)
+ (line 56)
* --expand-braces=STRING: Auxiliary tasks. (line 12)
* --expand-path=STRING: Auxiliary tasks. (line 16)
* --expand-var=STRING: Auxiliary tasks. (line 34)
* --format=NAME: Path searching options.
- (line 70)
+ (line 73)
* --help: Standard options. (line 8)
* --help-formats: Auxiliary tasks. (line 42)
* --interactive: Path searching options.
- (line 152)
+ (line 155)
* --mktex=FILETYPE: Path searching options.
- (line 157)
+ (line 160)
* --mode=STRING: Path searching options.
- (line 163)
+ (line 166)
* --must-exist: Path searching options.
- (line 168)
+ (line 171)
* --no-casefold-search: Path searching options.
- (line 19)
+ (line 22)
* --no-mktex=FILETYPE: Path searching options.
- (line 157)
+ (line 160)
* --path=STRING: Path searching options.
- (line 173)
+ (line 176)
* --progname=NAME: Path searching options.
- (line 181)
+ (line 184)
* --safe-extended-in-name=NAME: Auxiliary tasks. (line 48)
* --safe-extended-out-name=NAME: Auxiliary tasks. (line 48)
* --safe-in-name=NAME: Auxiliary tasks. (line 54)
@@ -3195,7 +3232,7 @@
* --safe-out-name=NAME: Auxiliary tasks. (line 54)
* --show-path=NAME: Auxiliary tasks. (line 60)
* --subdir=STRING: Path searching options.
- (line 186)
+ (line 189)
* --var-brace-value=VARIABLE: Auxiliary tasks. (line 66)
* --var-value=VARIABLE: Auxiliary tasks. (line 80)
* --version: Standard options. (line 11)
@@ -3209,7 +3246,7 @@
* -1 debugging value: Debugging. (line 23)
* -A option to ls: ls-R. (line 39)
* -D NUM: Path searching options.
- (line 49)
+ (line 52)
* -iname, find predicate: Casefolding examples.
(line 78)
* -L option to ls: ls-R. (line 44)
@@ -3366,7 +3403,7 @@
* all: Suppressing warnings.
(line 13)
* all matches, finding: Path searching options.
- (line 12)
+ (line 10)
* alphabetical order, not: Subdirectory expansion.
(line 6)
* announcement mailing list: Mailing lists. (line 6)
@@ -3514,7 +3551,7 @@
* ENCFONTS: Supported file formats.
(line 61)
* engine name: Path searching options.
- (line 53)
+ (line 56)
* environment variable, source for path: Path sources. (line 12)
* environment variables for TeX: Supported file formats.
(line 6)
@@ -3525,6 +3562,7 @@
* error message macros: Calling sequence. (line 22)
* examples, of casefolding searches: Casefolding examples.
(line 6)
+* examples, of running kpsewhich: kpsewhich examples. (line 6)
* excessive startup time: Slow path searching. (line 6)
* expand.c: Brace expansion. (line 26)
* expanding symlinks: Calling sequence. (line 31)
@@ -3625,7 +3663,7 @@
(line 84)
* input lines, reading: Calling sequence. (line 91)
* interactive query: Path searching options.
- (line 152)
+ (line 155)
* interface, not frozen: Introduction. (line 29)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -3679,6 +3717,7 @@
* kpse->invocation_short_name: Calling sequence. (line 22)
* kpse->program_name: Calling sequence. (line 22)
* kpsewhich: Invoking kpsewhich. (line 6)
+* kpsewhich examples: kpsewhich examples. (line 6)
* Kpsewhich, and debugging: Debugging. (line 31)
* last-resort font: Fallback font. (line 6)
* lcircle10: Fontmap. (line 19)
@@ -3865,7 +3904,7 @@
* reporting bugs: Reporting bugs. (line 6)
* resident.c: Calling sequence. (line 47)
* resolution, setting: Path searching options.
- (line 49)
+ (line 52)
* resolutions, last-resort: Fallback font. (line 6)
* restricted mode, for output files: Safe filenames. (line 15)
* retrieving TeX: unixtex.ftp. (line 6)
@@ -4121,69 +4160,69 @@
* XDVISIZES: Fallback font. (line 6)
* zuhn, david: History. (line 50)
-
Tag Table:
Node: Top1479
Node: Introduction2261
-Node: History4352
-Node: unixtex.ftp8972
-Node: Security10454
-Node: Global font cache and security13167
-Node: TeX directory structure15158
-Node: Path searching19333
-Node: Searching overview20291
-Node: Path sources24198
-Node: Config files25468
-Node: Path expansion30516
-Node: Default expansion31485
-Node: Variable expansion33607
-Node: Tilde expansion35076
-Node: Brace expansion36124
-Node: KPSE_DOT expansion37119
-Node: Subdirectory expansion37644
-Node: Casefolding search40084
-Node: Casefolding rationale40861
-Node: Casefolding examples42219
-Node: Filename database47441
-Node: ls-R48455
-Node: Filename aliases52327
-Node: Database format53569
-Node: Invoking kpsewhich54618
-Node: Path searching options55601
-Node: Specially-recognized files65603
-Node: Auxiliary tasks67078
-Node: Standard options71222
-Node: TeX support71590
-Node: Supported file formats72948
-Node: File lookup81699
-Node: Glyph lookup83504
-Node: Basic glyph lookup84652
-Node: Fontmap85560
-Node: Fallback font88168
-Node: Suppressing warnings89104
-Node: mktex scripts90267
-Node: mktex configuration91510
-Node: mktex script names97603
-Node: mktex script arguments99286
-Node: Programming100201
-Node: Programming overview100844
-Node: Calling sequence103755
-Node: Safe filenames109092
-Ref: openout_any109251
-Node: Program-specific files113104
-Node: Programming with config files114157
-Node: Reporting bugs115804
-Node: Bug checklist116482
-Node: Mailing lists120039
-Node: Debugging120716
-Node: Logging125973
-Node: Common problems127880
-Node: Unable to find files128357
-Node: Slow path searching130813
-Node: Unable to generate fonts132208
-Node: TeX or Metafont failing134744
-Node: Index135946
+Node: History4364
+Node: unixtex.ftp8984
+Node: Security10466
+Node: Global font cache and security13179
+Node: TeX directory structure15170
+Node: Path searching19345
+Node: Searching overview20303
+Node: Path sources24210
+Node: Config files25480
+Node: Path expansion30528
+Node: Default expansion31497
+Node: Variable expansion33619
+Node: Tilde expansion35088
+Node: Brace expansion36136
+Node: KPSE_DOT expansion37131
+Node: Subdirectory expansion37656
+Node: Casefolding search40096
+Node: Casefolding rationale40873
+Node: Casefolding examples42231
+Node: Filename database47453
+Node: ls-R48467
+Node: Filename aliases52339
+Node: Database format53581
+Node: Invoking kpsewhich54630
+Node: kpsewhich examples56021
+Node: Path searching options56909
+Node: Specially-recognized files67083
+Node: Auxiliary tasks68558
+Node: Standard options72702
+Node: TeX support73070
+Node: Supported file formats74428
+Node: File lookup83179
+Node: Glyph lookup84984
+Node: Basic glyph lookup86132
+Node: Fontmap87040
+Node: Fallback font89651
+Node: Suppressing warnings90587
+Node: mktex scripts91750
+Node: mktex configuration92993
+Node: mktex script names99086
+Node: mktex script arguments100769
+Node: Programming101684
+Node: Programming overview102327
+Node: Calling sequence105238
+Node: Safe filenames110575
+Ref: openout_any110734
+Node: Program-specific files114543
+Node: Programming with config files115596
+Node: Reporting bugs117243
+Node: Bug checklist117921
+Node: Mailing lists121478
+Node: Debugging122155
+Node: Logging127412
+Node: Common problems129319
+Node: Unable to find files129796
+Node: Slow path searching132252
+Node: Unable to generate fonts133647
+Node: TeX or Metafont failing136183
+Node: Index137385
End Tag Table
Modified: trunk/Master/texmf-dist/doc/info/tlbuild.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/tlbuild.info 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/info/tlbuild.info 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,9 +1,9 @@
-This is tlbuild.info, produced by makeinfo version 7.1 from
+This is tlbuild.info, produced by makeinfo version 7.2 from
tlbuild.texi.
This file documents the TeX Live build system and more.
-Copyright (C) 2016-2024 Karl Berry.
+Copyright (C) 2016-2025 Karl Berry.
Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
Permission is granted to make and distribute verbatim copies of this
@@ -33,7 +33,7 @@
File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir)
-Building TeX Live (2024)
+Building TeX Live (2025)
************************
For an overview of this manual, *note Introduction::.
@@ -59,7 +59,8 @@
1 Introduction
**************
-This manual (dated March 2024) corresponds to the TeX Live 2024 release.
+This manual (dated January 2025) corresponds to the TeX Live 2025
+release.
This manual is aimed at system installers and programmers, and
focuses on how to configure, build, and develop the TeX Live (TL)
@@ -86,9 +87,9 @@
* The TeX Live user manual: <https://tug.org/texlive/doc.html>, or
run 'texdoc texlive'.
- * Other TeX-related Texinfo manuals (*note (web2c)::, *note
- (kpathsea)::, etc.): <https://tug.org/texinfohtml/>, or check the
- 'TeX' category in the GNU Info system.
+ * Other TeX-related Texinfo manuals (*note (web2c)Top::, *note
+ (kpathsea)Top::, etc.): <https://tug.org/texinfohtml/>, or check
+ the 'TeX' category in the GNU Info system.
* Package documentation:
<https://tug.org/texlive/Contents/live/doc.html>, or the 'doc.html'
@@ -257,7 +258,7 @@
* Build iteration:: What 'configure' and 'make' do in TL.
* Build in parallel:: Simultaneous 'make' processes.
-* Build distribution:: Making a distribution tarball.
+* Build distribution:: (Not) making a distribution tarball.
* Build one package:: Example of working on just one program.
* Build one engine:: Example of building just one TeX engine.
* Cross compilation:: Building on host X for target Y.
@@ -312,16 +313,21 @@
4.3 Build distribution
======================
-Running 'make dist' at the top level creates a tarball
-'tex-live-YYYY-MM-DD.tar.xz' from the TL source tree. Running 'make
-distcheck' also verifies that this tarball suffices to build and install
-all of TL.
+Running 'make dist' or related targets at the top level outputs an error
+message and fails. We no longer try to keep 'make dist' working,
+although it could be restored if there is some use for it.
- This is useful for checking consistency of the source tree and
-Makefiles, but the result is not a complete or even usable TeX system,
-since all the support files are lacking; *note Installing::. We do not
-actually distribute any such tarball, and have no plans to do so.
+ The 'dist' target used to create a tarball
+'tex-live-YYYY-MM-DD.tar.xz' from the TL source tree, and 'distcheck'
+also verifies that this tarball suffices to build and install all of TL.
+ However, the result was not a complete or even usable TeX system,
+since all the support files are lacking. We do not actually distribute
+any such tarball, and have no plans to do so.
+
+ *Note Installing::, for more information on what to do with the
+results of a build.
+
File: tlbuild.info, Node: Build one package, Next: Build one engine, Prev: Build distribution, Up: Building
@@ -638,7 +644,8 @@
not present in the TL source tree. The best basis for dealing with them
is the TeX Live (plain text) database in 'Master/tlpkg/texlive.tlpdb',
and/or the TeX Live installer, 'install-tl'. More information is under
-'Master/tlpkg' and at <https://tug.org/texlive/distro.html>.
+'Master/tlpkg' and at <https://tug.org/texlive/distro.html> and
+<https://tug.org/texlive/build.html#deploy>.
* Menu:
@@ -697,31 +704,58 @@
5.2 Linked scripts
==================
-Quite a few executables are architecture-independent shell, Perl, or
-other interpreted scripts, rather than compiled binaries. A few are
-maintained as part of the TL source tree, but most are maintained
-elsewhere with copies under 'texk/texlive/linked_scripts'.
+Quite a few of the executables in TeX Live are architecture-independent
+shell, Perl, or other interpreted scripts, rather than compiled
+binaries. A few are maintained as part of the TL source tree, but most
+are maintained independently in their own packages, with copies under
+'texk/texlive/linked_scripts'.
These so-called "linked scripts" are installed under
'DATAROOTDIR/texmf-dist/scripts'; for Unix-like systems a symbolic link
-is made in 'BINDIR'. For example, a symlink points from 'BINDIR/ps2eps'
-to 'DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl'. For Windows, a
-standard wrapper binary (copied to, e.g., 'BINDIR/ps2eps.exe') serves
-the same purpose. The source for the wrapper is in
-'texk/texlive/windows_wrapper'.
+is made in 'BINDIR'. For example, a symlink points from
+'BINDIR/fmtutil' to 'DATAROOTDIR/texmf-dist/scripts/texlive/fmtutil.pl'.
+The symlink is relative, so the installation root can be anywhere.
- One reason for this is to avoid having many copies of the same
+ For Windows, we cannot portably use symlinks, so a standard wrapper
+binary (copied to, e.g., 'BINDIR/fmtutil.exe') serves the same purpose
+(the source for the wrapper is in 'texk/texlive/windows_wrapper').
+
+ One reason for all this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
- Most important of all, we want the 'BINDIR' resulting from the build
-to be as close as possible to what is in the TL distribution. At
-present, there are a few exceptions--Asymptote, Biber, Xindy--and each
-one creates considerable extra work. We don't want to add more. (See
+ Most important of all, we want the 'BINDIR' resulting from 'make
+install' in the TL source tree to be as close as possible to what's in
+thej TL distribution. At present, there are a few
+exceptions--Asymptote, Biber, Xindy--and each one creates considerable
+extra work. We don't want to add more. (See
<https://tug.org/texlive/build.html> for information about building
those exceptions, as well as the 'xz' and 'wget' programs that are used
in the TL infrastructure.)
+ As part of the 'make install' in the 'linked_scripts' directory, a
+file 'scripts-targets.lst' is created to record all the links that are
+created this way, so that distros and others can reproduce them. The
+file has one line per link. The first word is the target of the link
+(e.g., 'texmf-dist/scripts/texlive/fmtutil.pl'), and the second word is
+the name of the link to be placed in the bindir (e.g., 'fmtutil').
+Determining the relative link target (how many '../'s) is left to the
+users of this file, since it varies among distributions. It can be
+assumed there is no whitespace in these filenames.
+
+ A few links are within bindir; in that case, the first word of the
+line is just a base name, e.g., the file 'fmtutil mktexfmt' means that
+doing the equivalent of 'ln -s fmtutil mktexfmt' in the bindir.
+
+ Be aware that although extensions are usually stripped (as with
+'fmtutil'), there are exceptions, such as 'memoize-extract.pl' and
+'listings-ext.sh'.
+
+ The 'scripts-targets.lst' file started being created as of the
+TeX Live 2025 release. Historically, another file 'scripts.lst' has
+been (and still is) created, containing only the link targets, and using
+a Bourne shell syntax.
+
File: tlbuild.info, Node: Distro builds, Prev: Linked scripts, Up: Installing
@@ -825,12 +859,12 @@
Currently the versions we use are:
autoconf (GNU Autoconf) 2.72
- automake (GNU automake) 1.16.5
+ automake (GNU automake) 1.17
bison (GNU Bison) 3.8.2
flex 2.6.0
- ltmain.sh (GNU libtool) 2.4.7
+ ltmain.sh (GNU libtool) 2.5.4
m4 (GNU M4) 1.4.19
- makeinfo (GNU texinfo) 7.1
+ makeinfo (GNU texinfo) 7.2
These versions should be used to update the generated files (e.g.,
'configure' or 'Makefile.in') in all or parts of the TL tree after their
@@ -990,9 +1024,10 @@
-- Macro: KPSE_COMPILER_VISIBILITY
When using the C or C++ compiler, try to set
'VISIBILITY_C[XX]FLAGS' to flags to hide external symbols. Call
- 'AC_SUBST' for this variable. At present this only tests for the
- compiler option '-fvisibility=hidden', but could be extended if
- necessary.
+ 'AC_SUBST' for this variable. This tests for the compiler option
+ '-fvisibility=hidden' and, except for C,
+ '-fvisibility-inlines-hidden'. Reports or patches for additional
+ tests are welcome.
This macro caches its results in the 'kpse_cv_visibility_cflags' or
'kpse_cv_visibility_cxxflags' variable.
@@ -1213,7 +1248,7 @@
-----------------------------------------------
This is one of the TeX-specific libraries that are maintained as part of
-TeX Live (*note (kpathsea)::); the other is 'ptexenc'. These TeX
+TeX Live (*note (kpathsea)Top::); the other is 'ptexenc'. These TeX
libraries are Libtool libraries (static and/or shared) and are installed
by 'make install' together with the programs. They are, however, not
part of the TL DVD as distributed by TeX user groups, and have never
@@ -2935,8 +2970,10 @@
'TL_DOWNLOAD_ARGS'
- These override the normal choice of a download program; see the
- 'tlmgr' documentation, e.g.,
+'TEXLIVE_PREFER_OWN'
+
+ These override the normal choice of the download and other utility
+ programs; see the 'tlmgr' documentation, e.g.,
<https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES>.
'TEXLIVE_INSTALL_ENV_NOCHECK'
@@ -3073,7 +3110,7 @@
distribution (<https://tug.org/texlive>) and both are licensed under the
GNU General Public License Version 2 or later.
- $Id: install-tl 69711 2024-02-05 17:23:27Z karl $
+ $Id: install-tl 73024 2024-12-03 17:12:38Z karl $
File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top
@@ -3097,7 +3134,6 @@
* tlmgr MACHINE-READABLE OUTPUT::
* tlmgr ENVIRONMENT VARIABLES::
* tlmgr AUTHORS AND COPYRIGHT::
-* tlmgr POD ERRORS::
File: tlbuild.info, Node: tlmgr NAME, Next: tlmgr SYNOPSIS, Up: tlmgr
@@ -3536,9 +3572,9 @@
as any substring, and outputs bug-reporting and other information for
the package selected from the results.
- The search is equivalent to 'tlmgr search --word --file
-_search-string_. Thus, _search-string_ is interpreted as a (Perl)
-regular expression.'
+ The search is equivalent to 'tlmgr search --word --file'
+_search-string_. Thus, _search-string_ is interpreted as a (Perl)
+regular expression.
File: tlbuild.info, Node: tlmgr candidates _pkg_, Next: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all], Prev: tlmgr bug [_search-string_], Up: tlmgr ACTIONS
@@ -3686,8 +3722,8 @@
*--json*
Instead of dumping the actual content, the database is dumped as
- JSON. For the format of JSON output see
- 'tlpkg/doc/JSON-formats.txt', format definition 'TLPDB'.
+ JSON. For the format of JSON output see
+ 'tlpkg/doc/json-formats.txt', format definition 'TLPDB'.
Exactly one of '--local' and '--remote' must be given.
@@ -3718,7 +3754,7 @@
The 'generate' action overwrites any manual changes made in the
respective files: it recreates them from scratch based on the
-information of the installed packages, plus local adaptions. The TeX
+information of the installed packages, plus local adaptations. The TeX
Live installer and 'tlmgr' routinely call 'generate' for all of these
files.
@@ -3868,6 +3904,12 @@
collections, '--list' outputs their dependencies in a similar
way.
+ *--only-files*
+
+ If this option is given, only the files for a given package
+ are listed, no further information. If more than one package
+ name is given, each file list is preceded by the package name.
+
*--only-installed*
If this option is given, the installation source will not be
@@ -3910,10 +3952,10 @@
*--json*
- In case '--json' is specified, the output is a JSON encoded
- array where each array element is the JSON representation of a
+ If '--json' is specified, the output is a JSON encoded array
+ where each array element is the JSON representation of a
single 'TLPOBJ' but with additional information. For details
- see 'tlpkg/doc/JSON-formats.txt', format definition:
+ see 'tlpkg/doc/json-formats.txt', format definition:
'TLPOBJINFO'. If both '--json' and '--data' are given,
'--json' takes precedence.
@@ -4056,7 +4098,7 @@
Both 'show...' forms take an option '--json', which dumps the option
information in JSON format. In this case, both forms dump the same
data. For the format of the JSON output see
-'tlpkg/doc/JSON-formats.txt', format definition 'TLOPTION'.
+'tlpkg/doc/json-formats.txt', format definition 'TLOPTION'.
In the third form, with _key_, if _value_ is not given, the setting
for _key_ is displayed. If _value_ is present, _key_ is set to _value_.
@@ -4135,7 +4177,7 @@
'desktop_integration' is set, then some packages will install items in a
sub-folder of the Start menu for 'tlmgr gui', documentation, etc. If
'fileassocs' is set, Windows file associations are made (see also the
-'postaction' action). Finally, if 'multiuser' is set, then adaptions to
+'postaction' action). Finally, if 'multiuser' is set, then changes to
the registry and the menus are done for all users on the system instead
of only the current user. All three options are on by default.
@@ -4171,7 +4213,7 @@
If '--json' is specified without other options, the paper setup is
dumped in JSON format. For the format of JSON output see
-'tlpkg/doc/JSON-formats.txt', format definition 'TLPAPER'.
+'tlpkg/doc/json-formats.txt', format definition 'TLPAPER'.
Incidentally, this syntax of having a specific program name before
the 'paper' keyword is unusual. It is inherited from the longstanding
@@ -4421,8 +4463,9 @@
*repository status*
- This action manages the list of repositories. See *note
- (MULTIPLE_REPOSITORIES):: below for detailed explanations.
+ This action manages the list of repositories. See MULTIPLE
+ REPOSITORIES (https://metacpan.org/pod/MULTIPLE REPOSITORIES) below
+ for detailed explanations.
The first form, 'repository list', lists all configured
repositories and the respective tags if set. If a path, url, or
@@ -4512,9 +4555,9 @@
*--json*
- When listing backups, the option '--json' turn on JSON output.
+ When listing backups, the option '--json' writes JSON output.
The format is an array of JSON objects ('name', 'rev',
- 'date'). For details see 'tlpkg/doc/JSON-formats.txt', format
+ 'date'). For details see 'tlpkg/doc/json-formats.txt', format
definition: 'TLBACKUPS'. If both '--json' and '--data' are
given, '--json' takes precedence.
@@ -4557,6 +4600,12 @@
containing the word 'tables' (unless they also contain the
word 'table' on its own).
+ *--json*
+
+ Output search results as a JSON hash with two keys: *files*
+ and *packages*. For the format of the JSON output see
+ 'tlpkg/doc/json-formats.txt', format definition 'TLSEARCH'.
+
File: tlbuild.info, Node: tlmgr shell, Next: tlmgr show, Prev: tlmgr search, Up: tlmgr ACTIONS
@@ -5701,7 +5750,7 @@
used, regardless of any setting.
-File: tlbuild.info, Node: tlmgr AUTHORS AND COPYRIGHT, Next: tlmgr POD ERRORS, Prev: tlmgr ENVIRONMENT VARIABLES, Up: tlmgr
+File: tlbuild.info, Node: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr ENVIRONMENT VARIABLES, Up: tlmgr
B.14 AUTHORS AND COPYRIGHT
==========================
@@ -5710,22 +5759,9 @@
distribution (<https://tug.org/texlive>) and both are licensed under the
GNU General Public License Version 2 or later.
- $Id: tlmgr.pl 70001 2024-02-19 23:17:07Z karl $
+ $Id: tlmgr.pl 73493 2025-01-17 22:28:29Z karl $
-File: tlbuild.info, Node: tlmgr POD ERRORS, Prev: tlmgr AUTHORS AND COPYRIGHT, Up: tlmgr
-
-B.15 POD ERRORS
-===============
-
-Hey! *The above document had some coding errors, which are explained
-below:*
-
-Around line 8454:
-
- Unterminated C<...> sequence
-
-
File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top
Index
@@ -5778,7 +5814,7 @@
* --enable-compiler-warnings=LEVEL: --enable-compiler-warnings=LEVEL.
(line 6)
* --enable-cxx-runtime-hack: Macros for compilers.
- (line 29)
+ (line 30)
* --enable-etex: Configure options for texk/web2c.
(line 37)
* --enable-libtool-hack: Configure options for texk/web2c.
@@ -5842,6 +5878,10 @@
* --without-ln-s: --without-ln-s. (line 6)
* --without-x: --without-x. (line 6)
* -C configure option: Build in parallel. (line 15)
+* -fvisibility-inlines-hidden: Macros for compilers.
+ (line 19)
+* -fvisibility=hidden: Macros for compilers.
+ (line 19)
* -j make option: Build in parallel. (line 6)
* $@ target in normal make rules: Prerequisites. (line 13)
* ac/withenable.ac: Adding a new program module.
@@ -5861,7 +5901,7 @@
(line 6)
* ApplicationServices Mac framework, required by xetex: Prerequisites.
(line 40)
-* asymptote: Linked scripts. (line 23)
+* asymptote: Linked scripts. (line 26)
* asymptote <1>: asymptote. (line 6)
* Autoconf: Overview of build system.
(line 6)
@@ -5870,7 +5910,7 @@
(line 6)
* autoreconf, for new program: Adding a new program module.
(line 76)
-* biber: Linked scripts. (line 23)
+* biber: Linked scripts. (line 26)
* bibtex-x: Configure options for texk/bibtex-x.
(line 6)
* bibtex8: Configure options for texk/bibtex-x.
@@ -6066,14 +6106,14 @@
* KPSE_COND_WIN32: Macros for Windows. (line 15)
* KPSE_COND_WIN32_WRAP: Macros for Windows. (line 24)
* kpse_cv_cxx_hack: Macros for compilers.
- (line 33)
+ (line 34)
* kpse_cv_have_win32: Macros for Windows. (line 10)
* kpse_cv_visibility_c[xx]flags: Macros for compilers.
- (line 25)
+ (line 26)
* kpse_cv_warning_cflags: Macros for compilers.
(line 15)
* KPSE_CXX_HACK: Macros for compilers.
- (line 28)
+ (line 29)
* KPSE_ENABLE_PROG: Adding a new program module.
(line 14)
* KPSE_LARGEFILE: Macros for libraries.
@@ -6140,7 +6180,7 @@
(line 6)
* libsigsegv, required by xindy: Prerequisites. (line 44)
* libstc++, statically linking: Macros for compilers.
- (line 29)
+ (line 30)
* Libtool: Overview of build system.
(line 6)
* libtool, hack for avoiding excessive linking: Configure options for texk/web2c.
@@ -6149,7 +6189,7 @@
(line 22)
* linked scripts: Linked scripts. (line 6)
* linking C++ libraries statically: Macros for compilers.
- (line 29)
+ (line 30)
* lisp.run, lisp.exe: Configure options for utils/xindy.
(line 14)
* LittleEndian architectures: Configure options for texk/web2c.
@@ -6224,6 +6264,7 @@
* removing build directories: Build one package. (line 106)
* requirements for building: Prerequisites. (line 6)
* runscript.exe: Macros for Windows. (line 25)
+* scripts-targets.lst: Linked scripts. (line 35)
* scripts, linked and not maintained: Linked scripts. (line 6)
* scrolling, smooth: Configure options for texk/xdvik.
(line 13)
@@ -6244,11 +6285,12 @@
* static functions: Declarations and definitions.
(line 35)
* static linking for C++: Macros for compilers.
- (line 29)
+ (line 30)
* stpcpy: Declarations and definitions.
(line 18)
* Subversion repository: Build system tools. (line 38)
* support files, separate from build: Installing. (line 8)
+* symbolic links, used for scripts: Linked scripts. (line 6)
* symlinks, used for scripts: Linked scripts. (line 6)
* synctex: Configure options for texk/web2c.
(line 59)
@@ -6291,7 +6333,7 @@
* web2c program: Cross problems. (line 13)
* web2c.ac: Configure options for texk/web2c.
(line 37)
-* wget: Linked scripts. (line 23)
+* wget: Linked scripts. (line 26)
* WIN32_WRAP, Automake conditional: Macros for Windows. (line 25)
* WIN32, Automake conditional: Macros for Windows. (line 16)
* Windows, invoking scripts on: Linked scripts. (line 6)
@@ -6302,6 +6344,7 @@
(line 39)
* wrapper binary for scripts on Windows: Linked scripts. (line 6)
* wrapper build system: freetype library. (line 6)
+* wrapper for scripts, on Windows: Linked scripts. (line 18)
* X toolkit: Configure options for texk/web2c.
(line 22)
* X11 development, required by X clients: Prerequisites. (line 36)
@@ -6314,7 +6357,7 @@
(line 6)
* xdvipdfmx: Configure options for texk/dvipdfm-x.
(line 6)
-* xindy: Linked scripts. (line 23)
+* xindy: Linked scripts. (line 26)
* xindy <1>: xindy package. (line 6)
* xindy <2>: Configure options for utils/xindy.
(line 6)
@@ -6323,437 +6366,437 @@
(line 13)
* Xlib: Configure options for texk/web2c.
(line 22)
-* xz: Linked scripts. (line 23)
+* xz: Linked scripts. (line 26)
* zlib library: zlib library. (line 6)
-
Tag Table:
Node: Top1208
Node: Introduction2118
-Node: Overview of build system3943
-Node: Prerequisites5994
-Ref: Prerequisites-Footnote-18993
-Node: Building9296
-Node: Build iteration10638
-Node: Build in parallel11682
-Node: Build distribution12433
-Node: Build one package13081
-Node: Build one engine17794
-Node: Cross compilation20406
-Node: Cross configuring21685
-Node: Cross problems23362
-Node: Installing25024
-Node: Installation directories26044
-Node: Linked scripts27862
-Node: Distro builds29357
-Node: Layout and infrastructure31733
-Node: Build system tools32564
-Node: Top-level directories34781
-Node: Autoconf macros37017
-Node: General setup macros37779
-Node: Macros for programs38654
-Node: Macros for compilers39455
-Node: Macros for libraries40863
-Node: Macros for library and header flags41289
-Node: Macros for Windows43200
-Node: Library modules44795
-Node: png library45284
-Node: zlib library47632
-Node: freetype library48147
-Node: kpathsea library48843
-Node: Program modules50222
-Node: t1utils package50650
-Node: xindy package51195
-Node: xdvik package52311
-Node: asymptote53370
-Node: Extending TeX Live53874
-Node: Adding a new program module54681
-Node: Adding a new engine59444
-Node: Adding a new generic library module61229
-Node: Adding a new TeX-specific library module63450
-Node: Configure options64148
-Node: Global configure options65529
-Node: --disable-native-texlive-build66071
-Node: --prefix --bindir ...67033
-Node: --disable-largefile67573
-Node: --disable-missing68115
-Node: --enable-compiler-warnings=LEVEL68516
-Node: --enable-cxx-runtime-hack69172
-Node: --enable-maintainer-mode69592
-Node: --enable-multiplatform70121
-Node: --enable-shared70694
-Node: --enable-silent-rules71065
-Node: --without-ln-s71517
-Node: --without-x71864
-Node: Program-specific configure options72052
-Node: --enable-PROG --disable-PROG72695
-Node: --disable-all-pkgs72968
-Node: Configure options for texk/web2c73751
-Node: Configure options for texk/bibtex-x76289
-Node: Configure options for texk/dvipdfm-x76832
-Node: Configure options for texk/dvisvgm77608
-Node: Configure options for texk/texlive78489
-Node: Configure options for texk/xdvik78910
-Node: Configure options for utils/xindy79531
-Node: Library-specific configure options80421
-Node: Configure options for kpathsea81382
-Node: Variables for configure82086
-Node: Coding conventions83512
-Node: Declarations and definitions84227
-Node: Const86401
-Node: Continuous integration88265
-Node: Transfer from Subversion to Github88929
-Node: Automatic update of the Git mirror91091
-Node: CI testing on Travis-CI91673
-Node: Releases on Github92382
-Node: install-tl92822
-Node: install-tl NAME93266
-Node: install-tl SYNOPSIS93446
-Node: install-tl DESCRIPTION93684
-Node: install-tl REFERENCES94881
-Node: install-tl EXAMPLES95490
-Ref: install-tl install-tl --paper=letter95941
-Ref: install-tl install-tl --scheme _scheme_96077
-Ref: install-tl install-tl --no-interaction96232
-Ref: install-tl install-tl --profile _texlive.profile_96384
-Node: install-tl OPTIONS96652
-Ref: install-tl *-gui* [[=]_module_]97149
-Ref: install-tl *-no-gui*97160
-Ref: install-tl text97368
-Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)97553
-Ref: install-tl *-lang* _llcode_98185
-Ref: install-tl *-repository* _url|path_98809
-Ref: install-tl *-select-repository*99703
-Ref: install-tl *-all-options*100121
-Ref: install-tl *-custom-bin* _path_100376
-Ref: install-tl *-debug-fakenet*101208
-Ref: install-tl *-debug-setup-vars*101422
-Ref: install-tl *-debug-translation*101570
-Ref: install-tl *-force-platform* _platform_101846
-Ref: install-tl *-help*, *--help*, *-?*102104
-Ref: install-tl *-in-place*102517
-Ref: install-tl *-init-from-profile* _profile_file_103062
-Ref: install-tl *-logfile* _file_103331
-Ref: install-tl *-no-cls*103682
-Ref: install-tl *-no-continue*103809
-Ref: install-tl *-no-doc-install*104380
-Ref: install-tl *-no-src-install*104399
-Ref: install-tl *-no-installation*105190
-Ref: install-tl *-no-interaction*105341
-Ref: install-tl *-no-persistent-downloads*105598
-Ref: install-tl *-persistent-downloads*105623
-Ref: install-tl *-no-verify-downloads*106230
-Ref: install-tl *-non-admin*106593
-Ref: install-tl *-paper* a4*|*letter106699
-Ref: install-tl *-portable*106895
-Ref: install-tl *-print-platform*107032
-Ref: install-tl *-profile* _profile_file_107230
-Ref: install-tl *-q*107451
-Ref: install-tl *-scheme* _scheme_107513
-Ref: install-tl *-texdir* _dir_107914
-Ref: install-tl *-texuserdir* _dir_108519
-Ref: install-tl *-texmflocal* _dir_108808
-Ref: install-tl *-texmfhome* _dir_109433
-Ref: install-tl *-texmfsysconfig* _dir_109742
-Ref: install-tl *-texmfsysvar* _dir_109764
-Ref: install-tl *-texmfconfig* _dir_109859
-Ref: install-tl *-texmfvar* _dir_109878
-Ref: install-tl *-v*110086
-Ref: install-tl *-version*, *--version*110242
-Node: install-tl PROFILES110376
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)113392
-Ref: install-tl instopt_adjustrepo (default 1)113468
-Ref: install-tl instopt_letter (default 0)113605
-Ref: install-tl instopt_portable (default 0)113696
-Ref: install-tl instopt_write18_restricted (default 1)114235
-Node: install-tl ENVIRONMENT VARIABLES115574
-Ref: install-tl NOPERLDOC115937
-Ref: install-tl TEXLIVE_DOWNLOADER116022
-Ref: install-tl TL_DOWNLOAD_PROGRAM116045
-Ref: install-tl TL_DOWNLOAD_ARGS116065
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK116269
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE116471
-Ref: install-tl TEXLIVE_INSTALL_NO_DISKCHECK116583
-Ref: install-tl TEXLIVE_INSTALL_NO_RESUME116999
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME117151
-Ref: install-tl TEXLIVE_INSTALL_PAPER117272
-Ref: install-tl TEXLIVE_INSTALL_PREFIX117418
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG117449
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR117477
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME117506
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL117536
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG117570
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR117601
-Node: install-tl DIRECTORY TREES118039
-Node: install-tl BUGS120623
-Node: install-tl AUTHORS AND COPYRIGHT121503
-Node: tlmgr121901
-Node: tlmgr NAME122407
-Node: tlmgr SYNOPSIS122551
-Node: tlmgr DESCRIPTION122753
-Node: tlmgr EXAMPLES123864
-Ref: tlmgr tlmgr option repository ctan124127
-Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet124200
-Ref: tlmgr tlmgr update --list124805
-Ref: tlmgr tlmgr update --all124898
-Ref: tlmgr tlmgr info _what_125055
-Ref: tlmgr tlmgr bug _what_125233
-Node: tlmgr OPTIONS125428
-Ref: tlmgr *--repository* _url|path_125961
-Ref: tlmgr /some/local/dir127147
-Ref: tlmgr file:/some/local/dir127176
-Ref: tlmgr ctan127249
-Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet127303
-Ref: tlmgr http://server/path/to/tlnet127644
-Ref: tlmgr https://server/path/to/tlnet128025
-Ref: tlmgr ftp://server/path/to/tlnet128493
-Ref: tlmgr user at machine:/path/to/tlnet128625
-Ref: tlmgr scp://user@machine/path/to/tlnet128666
-Ref: tlmgr ssh://user@machine/path/to/tlnet128707
-Ref: tlmgr *--gui* [_action_]129101
-Ref: tlmgr *--gui-lang* _llcode_129915
-Ref: tlmgr *--command-logfile* _file_130657
-Ref: tlmgr *--debug-translation*130924
-Ref: tlmgr *--machine-readable*131128
-Ref: tlmgr *--no-execute-actions*131397
-Ref: tlmgr *--package-logfile* _file_131591
-Ref: tlmgr *--pause*131846
-Ref: tlmgr *--persistent-downloads*132002
-Ref: tlmgr *--no-persistent-downloads*132031
-Ref: tlmgr *--pin-file*132526
-Ref: tlmgr *--usermode*132745
-Ref: tlmgr *--usertree* _dir_132866
-Ref: tlmgr *--verify-repo=[none|main|all]*132993
-Node: tlmgr ACTIONS133892
-Node: tlmgr help134785
-Node: tlmgr version135262
-Node: tlmgr backup135525
-Ref: tlmgr *backup [_option_...] --all*135702
-Ref: tlmgr *backup [_option_...] _pkg_...*135735
-Ref: tlmgr *--backupdir* _directory_136802
-Ref: tlmgr *--all*137020
-Ref: tlmgr *--clean*[=_N_]137273
-Ref: tlmgr *--dry-run*137601
-Node: tlmgr bug [_search-string_]137731
-Node: tlmgr candidates _pkg_138317
-Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]138687
-Ref: tlmgr *depends*139201
-Ref: tlmgr *executes*139543
-Ref: tlmgr *files*139658
-Ref: tlmgr *runfiles*139794
-Ref: tlmgr *texmfdbs*139931
-Ref: tlmgr - all items in TEXMFDBS have the !! prefix.140161
-Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).140237
-Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.140302
-Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.140377
-Ref: tlmgr *--use-svn*140403
-Node: tlmgr conf140544
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*140834
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*140899
-Node: tlmgr dump-tlpdb [_option_...] [--json]143315
-Ref: tlmgr *--local*143751
-Ref: tlmgr *--remote*143791
-Ref: tlmgr *--json*143830
-Node: tlmgr generate144401
-Ref: tlmgr *generate [_option_...] language*144597
-Ref: tlmgr *generate [_option_...] language.dat*144636
-Ref: tlmgr *generate [_option_...] language.def*144675
-Ref: tlmgr *generate [_option_...] language.dat.lua*144718
-Ref: tlmgr *--dest* _output_file_147046
-Ref: tlmgr *--localcfg* _local_conf_file_147623
-Ref: tlmgr *--rebuild-sys*147747
-Node: tlmgr gui148562
-Node: tlmgr info148742
-Ref: tlmgr *info [_option_...] _pkg_...*148904
-Ref: tlmgr *info [_option_...] collections*148938
-Ref: tlmgr *info [_option_...] schemes*148968
-Ref: tlmgr *--list*150499
-Ref: tlmgr *--only-installed*150814
-Ref: tlmgr *--only-remote*151003
-Ref: tlmgr *--data item1,item2,...*151308
-Ref: tlmgr *--json* 1152681
-Node: tlmgr init-usertree153064
-Node: tlmgr install [_option_...] _pkg_...153445
-Ref: tlmgr *--dry-run* 1153954
-Ref: tlmgr *--file*154072
-Ref: tlmgr *--force*154295
-Ref: tlmgr *--no-depends*154516
-Ref: tlmgr *--no-depends-at-all*154676
-Ref: tlmgr *--reinstall*155077
-Ref: tlmgr *--with-doc*155456
-Ref: tlmgr *--with-src*155470
-Node: tlmgr key156198
-Ref: tlmgr *key list*156356
-Ref: tlmgr *key add _file_*156374
-Ref: tlmgr *key remove _keyid_*156396
-Node: tlmgr list156990
-Node: tlmgr option157152
-Ref: tlmgr *option [--json] [show]*157308
-Ref: tlmgr *option [--json] showall|help*157340
-Ref: tlmgr *option _key_ [_value_]*157366
-Node: tlmgr paper161945
-Ref: tlmgr *paper [a4|letter]*162094
-Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>162171
-Ref: tlmgr *paper --json*162187
-Node: tlmgr path163402
-Ref: tlmgr *path [--windowsmode=user|admin] add*163568
-Ref: tlmgr *path [--windowsmode=user|admin] remove*163610
-Node: tlmgr pinning165125
-Ref: tlmgr pinning show165366
-Ref: tlmgr pinning add _repo_ _pkgglob_...165439
-Ref: tlmgr pinning remove _repo_ _pkgglob_...165558
-Ref: tlmgr pinning remove _repo_ --all165711
-Node: tlmgr platform165765
-Ref: tlmgr *platform list|add|remove _platform_...*165951
-Ref: tlmgr *platform set _platform_*165978
-Ref: tlmgr *platform set auto*165999
-Ref: tlmgr *--dry-run* 2166877
-Node: tlmgr postaction166996
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*167226
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*167300
-Ref: tlmgr *--windowsmode=[user|admin]*167620
-Ref: tlmgr *--fileassocmode=[1|2]*168045
-Ref: tlmgr *--all* 1168331
-Node: tlmgr print-platform168386
-Node: tlmgr print-platform-info168717
-Node: tlmgr remove [_option_...] _pkg_...169017
-Ref: tlmgr *--all* 2169502
-Ref: tlmgr *--backup*169613
-Ref: tlmgr *--backupdir* _directory_ 1169640
-Ref: tlmgr *--no-depends* 1170045
-Ref: tlmgr *--no-depends-at-all* 1170108
-Ref: tlmgr *--force* 1170215
-Ref: tlmgr *--dry-run* 3170689
-Node: tlmgr repository171066
-Ref: tlmgr *repository list*171254
-Ref: tlmgr *repository list _path|url|tag_*171288
-Ref: tlmgr *repository add _path_ [_tag_]*171321
-Ref: tlmgr *repository remove _path|tag_*171353
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*171407
-Ref: tlmgr *repository status*171428
-Ref: tlmgr The tag (which can be the same as the url);172655
-Node: tlmgr restore173133
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*173312
-Ref: tlmgr *restore [_option_...] --all*173343
-Ref: tlmgr *--all* 3174044
-Ref: tlmgr *--backupdir* _directory_ 2174259
-Ref: tlmgr *--dry-run* 4174441
-Ref: tlmgr *--force* 2174574
-Ref: tlmgr *--json* 2174621
-Node: tlmgr search174948
-Ref: tlmgr *search [_option_...] _what_*175112
-Ref: tlmgr *search [_option_...] --file _what_*175150
-Ref: tlmgr *search [_option_...] --all _what_*175187
-Ref: tlmgr *--file* 1175408
-Ref: tlmgr *--all* 4175471
-Ref: tlmgr *--global*175561
-Ref: tlmgr *--word*175689
-Node: tlmgr shell176004
-Ref: tlmgr protocol176739
-Ref: tlmgr help 1176803
-Ref: tlmgr version 1176856
-Ref: tlmgr quit, end, bye, byebye, EOF176924
-Ref: tlmgr restart176945
-Ref: tlmgr load [local|remote]177068
-Ref: tlmgr save177138
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]177261
-Node: tlmgr show177862
-Node: tlmgr uninstall178029
-Node: tlmgr update [_option_...] [_pkg_...]178261
-Ref: tlmgr *--all* 5178633
-Ref: tlmgr *--self*180813
-Ref: tlmgr *--dry-run* 5181578
-Ref: tlmgr *--list* [_pkg_]181756
-Ref: tlmgr *--exclude* _pkg_182446
-Ref: tlmgr *--no-auto-remove* [_pkg_...]183247
-Ref: tlmgr *--no-auto-install* [_pkg_...]183732
-Ref: tlmgr *--reinstall-forcibly-removed*184495
-Ref: tlmgr *--backup* 1185031
-Ref: tlmgr *--backupdir* _directory_ 3185058
-Ref: tlmgr *--no-depends* 2186225
-Ref: tlmgr *--no-depends-at-all* 2186429
-Ref: tlmgr *--force* 3186536
-Node: tlmgr CONFIGURATION FILE FOR TLMGR187527
-Ref: tlmgr auto-remove = 0 or 1 (default 1), same as command-line option.188529
-Ref: tlmgr gui-expertmode = 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.188661
-Ref: tlmgr gui-lang = _llcode_, with a language code value as with the command-line option.188745
-Ref: tlmgr no-checksums = 0 or 1 (default 0, see below).188794
-Ref: tlmgr persistent-downloads = 0 or 1 (default 1), same as command-line option.188869
-Ref: tlmgr require-verification = 0 or 1 (default 0), same as command-line option.188944
-Ref: tlmgr tkfontscale = _floating-point number_ (default 1.0); scaling factor for fonts in the Tk-based frontends.189052
-Ref: tlmgr update-exclude = _comma-separated list of packages_ (no spaces allowed). Same as the command line option --exclude for the update action.189197
-Ref: tlmgr verify-downloads = 0 or 1 (default 1), same as command-line option.189268
-Ref: tlmgr allowed-actions = _action1_[,_action2_,...] The value is a comma-separated list (no spaces) of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode). This allows distributors to include tlmgr in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn't make sense to set this.189785
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION190617
-Node: tlmgr Configuration of GnuPG invocation192790
-Node: tlmgr USER MODE193428
-Node: tlmgr User mode install196299
-Node: tlmgr User mode backup, restore, remove, update197445
-Node: tlmgr User mode generate, option, paper197891
-Node: tlmgr User mode logs198258
-Node: tlmgr MULTIPLE REPOSITORIES198556
-Node: tlmgr Pinning200285
-Node: tlmgr GUI FOR TLMGR202208
-Node: tlmgr Main display203857
-Node: tlmgr Display configuration area204109
-Ref: tlmgr Status204470
-Ref: tlmgr Category204634
-Ref: tlmgr Match204820
-Ref: tlmgr Selection205001
-Ref: tlmgr Display configuration buttons205205
-Node: tlmgr Package list area205388
-Ref: tlmgr a checkbox205972
-Ref: tlmgr package name206108
-Ref: tlmgr local revision (and version)206207
-Ref: tlmgr remote revision (and version)206582
-Ref: tlmgr short description206879
-Node: tlmgr Main display action buttons206924
-Ref: tlmgr Update all installed207190
-Ref: tlmgr Update207562
-Ref: tlmgr Install207612
-Ref: tlmgr Remove207798
-Ref: tlmgr Backup207976
-Node: tlmgr Menu bar208133
-Ref: tlmgr tlmgr menu208356
-Ref: tlmgr Options menu208664
-Ref: tlmgr Actions menu209747
-Ref: tlmgr Help menu210175
-Node: tlmgr GUI options210309
-Ref: tlmgr -background _color_210555
-Ref: tlmgr -font " _fontname_ _fontsize_ "210620
-Ref: tlmgr -foreground _color_210778
-Ref: tlmgr -geometry _geomspec_210830
-Ref: tlmgr -xrm _xresource_211022
-Node: tlmgr MACHINE-READABLE OUTPUT211291
-Node: tlmgr Machine-readable update and install output212105
-Ref: tlmgr location-url _location_213381
-Ref: tlmgr total-bytes _count_213597
-Ref: tlmgr _pkgname_214007
-Ref: tlmgr _status_214217
-Ref: tlmgr d214295
-Ref: tlmgr f214355
-Ref: tlmgr u214534
-Ref: tlmgr r214580
-Ref: tlmgr a214703
-Ref: tlmgr i214881
-Ref: tlmgr I215000
-Ref: tlmgr _localrev_215102
-Ref: tlmgr _serverrev_215209
-Ref: tlmgr _size_215321
-Ref: tlmgr _runtime_215490
-Ref: tlmgr _esttot_215560
-Node: tlmgr Machine-readable option output215593
-Node: tlmgr ENVIRONMENT VARIABLES216105
-Ref: tlmgr TEXLIVE_COMPRESSOR216616
-Ref: tlmgr TEXLIVE_DOWNLOADER217464
-Ref: tlmgr TL_DOWNLOAD_PROGRAM217487
-Ref: tlmgr TL_DOWNLOAD_ARGS217507
-Ref: tlmgr TEXLIVE_PREFER_OWN218533
-Node: tlmgr AUTHORS AND COPYRIGHT219357
-Node: tlmgr POD ERRORS219780
-Ref: tlmgr Around line 8454:220005
-Node: Index220041
+Node: Overview of build system3951
+Node: Prerequisites6002
+Ref: Prerequisites-Footnote-19001
+Node: Building9304
+Node: Build iteration10652
+Node: Build in parallel11696
+Node: Build distribution12447
+Node: Build one package13275
+Node: Build one engine17988
+Node: Cross compilation20600
+Node: Cross configuring21879
+Node: Cross problems23556
+Node: Installing25218
+Node: Installation directories26286
+Node: Linked scripts28104
+Node: Distro builds30988
+Node: Layout and infrastructure33364
+Node: Build system tools34195
+Node: Top-level directories36410
+Node: Autoconf macros38646
+Node: General setup macros39408
+Node: Macros for programs40283
+Node: Macros for compilers41084
+Node: Macros for libraries42548
+Node: Macros for library and header flags42974
+Node: Macros for Windows44885
+Node: Library modules46480
+Node: png library46969
+Node: zlib library49317
+Node: freetype library49832
+Node: kpathsea library50528
+Node: Program modules51910
+Node: t1utils package52338
+Node: xindy package52883
+Node: xdvik package53999
+Node: asymptote55058
+Node: Extending TeX Live55562
+Node: Adding a new program module56369
+Node: Adding a new engine61132
+Node: Adding a new generic library module62917
+Node: Adding a new TeX-specific library module65138
+Node: Configure options65836
+Node: Global configure options67217
+Node: --disable-native-texlive-build67759
+Node: --prefix --bindir ...68721
+Node: --disable-largefile69261
+Node: --disable-missing69803
+Node: --enable-compiler-warnings=LEVEL70204
+Node: --enable-cxx-runtime-hack70860
+Node: --enable-maintainer-mode71280
+Node: --enable-multiplatform71809
+Node: --enable-shared72382
+Node: --enable-silent-rules72753
+Node: --without-ln-s73205
+Node: --without-x73552
+Node: Program-specific configure options73740
+Node: --enable-PROG --disable-PROG74383
+Node: --disable-all-pkgs74656
+Node: Configure options for texk/web2c75439
+Node: Configure options for texk/bibtex-x77977
+Node: Configure options for texk/dvipdfm-x78520
+Node: Configure options for texk/dvisvgm79296
+Node: Configure options for texk/texlive80177
+Node: Configure options for texk/xdvik80598
+Node: Configure options for utils/xindy81219
+Node: Library-specific configure options82109
+Node: Configure options for kpathsea83070
+Node: Variables for configure83774
+Node: Coding conventions85200
+Node: Declarations and definitions85915
+Node: Const88089
+Node: Continuous integration89953
+Node: Transfer from Subversion to Github90617
+Node: Automatic update of the Git mirror92779
+Node: CI testing on Travis-CI93361
+Node: Releases on Github94070
+Node: install-tl94510
+Node: install-tl NAME94954
+Node: install-tl SYNOPSIS95134
+Node: install-tl DESCRIPTION95372
+Node: install-tl REFERENCES96569
+Node: install-tl EXAMPLES97178
+Ref: install-tl install-tl --paper=letter97629
+Ref: install-tl install-tl --scheme _scheme_97765
+Ref: install-tl install-tl --no-interaction97920
+Ref: install-tl install-tl --profile _texlive.profile_98072
+Node: install-tl OPTIONS98340
+Ref: install-tl *-gui* [[=]_module_]98837
+Ref: install-tl *-no-gui*98848
+Ref: install-tl text99056
+Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)99241
+Ref: install-tl *-lang* _llcode_99873
+Ref: install-tl *-repository* _url|path_100497
+Ref: install-tl *-select-repository*101391
+Ref: install-tl *-all-options*101809
+Ref: install-tl *-custom-bin* _path_102064
+Ref: install-tl *-debug-fakenet*102896
+Ref: install-tl *-debug-setup-vars*103110
+Ref: install-tl *-debug-translation*103258
+Ref: install-tl *-force-platform* _platform_103534
+Ref: install-tl *-help*, *--help*, *-?*103792
+Ref: install-tl *-in-place*104205
+Ref: install-tl *-init-from-profile* _profile_file_104750
+Ref: install-tl *-logfile* _file_105019
+Ref: install-tl *-no-cls*105370
+Ref: install-tl *-no-continue*105497
+Ref: install-tl *-no-doc-install*106068
+Ref: install-tl *-no-src-install*106087
+Ref: install-tl *-no-installation*106878
+Ref: install-tl *-no-interaction*107029
+Ref: install-tl *-no-persistent-downloads*107286
+Ref: install-tl *-persistent-downloads*107311
+Ref: install-tl *-no-verify-downloads*107918
+Ref: install-tl *-non-admin*108281
+Ref: install-tl *-paper* a4*|*letter108387
+Ref: install-tl *-portable*108583
+Ref: install-tl *-print-platform*108720
+Ref: install-tl *-profile* _profile_file_108918
+Ref: install-tl *-q*109139
+Ref: install-tl *-scheme* _scheme_109201
+Ref: install-tl *-texdir* _dir_109602
+Ref: install-tl *-texuserdir* _dir_110207
+Ref: install-tl *-texmflocal* _dir_110496
+Ref: install-tl *-texmfhome* _dir_111121
+Ref: install-tl *-texmfsysconfig* _dir_111430
+Ref: install-tl *-texmfsysvar* _dir_111452
+Ref: install-tl *-texmfconfig* _dir_111547
+Ref: install-tl *-texmfvar* _dir_111566
+Ref: install-tl *-v*111774
+Ref: install-tl *-version*, *--version*111930
+Node: install-tl PROFILES112064
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)115080
+Ref: install-tl instopt_adjustrepo (default 1)115156
+Ref: install-tl instopt_letter (default 0)115293
+Ref: install-tl instopt_portable (default 0)115384
+Ref: install-tl instopt_write18_restricted (default 1)115923
+Node: install-tl ENVIRONMENT VARIABLES117262
+Ref: install-tl NOPERLDOC117625
+Ref: install-tl TEXLIVE_DOWNLOADER117710
+Ref: install-tl TL_DOWNLOAD_PROGRAM117733
+Ref: install-tl TL_DOWNLOAD_ARGS117753
+Ref: install-tl TEXLIVE_PREFER_OWN117775
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK118000
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE118202
+Ref: install-tl TEXLIVE_INSTALL_NO_DISKCHECK118314
+Ref: install-tl TEXLIVE_INSTALL_NO_RESUME118730
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME118882
+Ref: install-tl TEXLIVE_INSTALL_PAPER119003
+Ref: install-tl TEXLIVE_INSTALL_PREFIX119149
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG119180
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR119208
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME119237
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL119267
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG119301
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR119332
+Node: install-tl DIRECTORY TREES119770
+Node: install-tl BUGS122354
+Node: install-tl AUTHORS AND COPYRIGHT123234
+Node: tlmgr123632
+Node: tlmgr NAME124117
+Node: tlmgr SYNOPSIS124261
+Node: tlmgr DESCRIPTION124463
+Node: tlmgr EXAMPLES125574
+Ref: tlmgr tlmgr option repository ctan125837
+Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet125910
+Ref: tlmgr tlmgr update --list126515
+Ref: tlmgr tlmgr update --all126608
+Ref: tlmgr tlmgr info _what_126765
+Ref: tlmgr tlmgr bug _what_126943
+Node: tlmgr OPTIONS127138
+Ref: tlmgr *--repository* _url|path_127671
+Ref: tlmgr /some/local/dir128857
+Ref: tlmgr file:/some/local/dir128886
+Ref: tlmgr ctan128959
+Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet129013
+Ref: tlmgr http://server/path/to/tlnet129354
+Ref: tlmgr https://server/path/to/tlnet129735
+Ref: tlmgr ftp://server/path/to/tlnet130203
+Ref: tlmgr user at machine:/path/to/tlnet130335
+Ref: tlmgr scp://user@machine/path/to/tlnet130376
+Ref: tlmgr ssh://user@machine/path/to/tlnet130417
+Ref: tlmgr *--gui* [_action_]130811
+Ref: tlmgr *--gui-lang* _llcode_131625
+Ref: tlmgr *--command-logfile* _file_132367
+Ref: tlmgr *--debug-translation*132634
+Ref: tlmgr *--machine-readable*132838
+Ref: tlmgr *--no-execute-actions*133107
+Ref: tlmgr *--package-logfile* _file_133301
+Ref: tlmgr *--pause*133556
+Ref: tlmgr *--persistent-downloads*133712
+Ref: tlmgr *--no-persistent-downloads*133741
+Ref: tlmgr *--pin-file*134236
+Ref: tlmgr *--usermode*134455
+Ref: tlmgr *--usertree* _dir_134576
+Ref: tlmgr *--verify-repo=[none|main|all]*134703
+Node: tlmgr ACTIONS135602
+Node: tlmgr help136495
+Node: tlmgr version136972
+Node: tlmgr backup137235
+Ref: tlmgr *backup [_option_...] --all*137412
+Ref: tlmgr *backup [_option_...] _pkg_...*137445
+Ref: tlmgr *--backupdir* _directory_138512
+Ref: tlmgr *--all*138730
+Ref: tlmgr *--clean*[=_N_]138983
+Ref: tlmgr *--dry-run*139311
+Node: tlmgr bug [_search-string_]139441
+Node: tlmgr candidates _pkg_140028
+Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]140398
+Ref: tlmgr *depends*140912
+Ref: tlmgr *executes*141254
+Ref: tlmgr *files*141369
+Ref: tlmgr *runfiles*141505
+Ref: tlmgr *texmfdbs*141642
+Ref: tlmgr - all items in TEXMFDBS have the !! prefix.141872
+Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).141948
+Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.142013
+Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.142088
+Ref: tlmgr *--use-svn*142114
+Node: tlmgr conf142255
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*142545
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*142610
+Node: tlmgr dump-tlpdb [_option_...] [--json]145026
+Ref: tlmgr *--local*145462
+Ref: tlmgr *--remote*145502
+Ref: tlmgr *--json*145541
+Node: tlmgr generate146113
+Ref: tlmgr *generate [_option_...] language*146309
+Ref: tlmgr *generate [_option_...] language.dat*146348
+Ref: tlmgr *generate [_option_...] language.def*146387
+Ref: tlmgr *generate [_option_...] language.dat.lua*146430
+Ref: tlmgr *--dest* _output_file_148760
+Ref: tlmgr *--localcfg* _local_conf_file_149337
+Ref: tlmgr *--rebuild-sys*149461
+Node: tlmgr gui150276
+Node: tlmgr info150456
+Ref: tlmgr *info [_option_...] _pkg_...*150618
+Ref: tlmgr *info [_option_...] collections*150652
+Ref: tlmgr *info [_option_...] schemes*150682
+Ref: tlmgr *--list*152213
+Ref: tlmgr *--only-files*152524
+Ref: tlmgr *--only-installed*152765
+Ref: tlmgr *--only-remote*152954
+Ref: tlmgr *--data item1,item2,...*153259
+Ref: tlmgr *--json* 1154632
+Node: tlmgr init-usertree155010
+Node: tlmgr install [_option_...] _pkg_...155391
+Ref: tlmgr *--dry-run* 1155900
+Ref: tlmgr *--file*156018
+Ref: tlmgr *--force*156241
+Ref: tlmgr *--no-depends*156462
+Ref: tlmgr *--no-depends-at-all*156622
+Ref: tlmgr *--reinstall*157023
+Ref: tlmgr *--with-doc*157402
+Ref: tlmgr *--with-src*157416
+Node: tlmgr key158144
+Ref: tlmgr *key list*158302
+Ref: tlmgr *key add _file_*158320
+Ref: tlmgr *key remove _keyid_*158342
+Node: tlmgr list158936
+Node: tlmgr option159098
+Ref: tlmgr *option [--json] [show]*159254
+Ref: tlmgr *option [--json] showall|help*159286
+Ref: tlmgr *option _key_ [_value_]*159312
+Node: tlmgr paper163889
+Ref: tlmgr *paper [a4|letter]*164038
+Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>164115
+Ref: tlmgr *paper --json*164131
+Node: tlmgr path165346
+Ref: tlmgr *path [--windowsmode=user|admin] add*165512
+Ref: tlmgr *path [--windowsmode=user|admin] remove*165554
+Node: tlmgr pinning167069
+Ref: tlmgr pinning show167310
+Ref: tlmgr pinning add _repo_ _pkgglob_...167383
+Ref: tlmgr pinning remove _repo_ _pkgglob_...167502
+Ref: tlmgr pinning remove _repo_ --all167655
+Node: tlmgr platform167709
+Ref: tlmgr *platform list|add|remove _platform_...*167895
+Ref: tlmgr *platform set _platform_*167922
+Ref: tlmgr *platform set auto*167943
+Ref: tlmgr *--dry-run* 2168821
+Node: tlmgr postaction168940
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*169170
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*169244
+Ref: tlmgr *--windowsmode=[user|admin]*169564
+Ref: tlmgr *--fileassocmode=[1|2]*169989
+Ref: tlmgr *--all* 1170275
+Node: tlmgr print-platform170330
+Node: tlmgr print-platform-info170661
+Node: tlmgr remove [_option_...] _pkg_...170961
+Ref: tlmgr *--all* 2171446
+Ref: tlmgr *--backup*171557
+Ref: tlmgr *--backupdir* _directory_ 1171584
+Ref: tlmgr *--no-depends* 1171989
+Ref: tlmgr *--no-depends-at-all* 1172052
+Ref: tlmgr *--force* 1172159
+Ref: tlmgr *--dry-run* 3172633
+Node: tlmgr repository173010
+Ref: tlmgr *repository list*173198
+Ref: tlmgr *repository list _path|url|tag_*173232
+Ref: tlmgr *repository add _path_ [_tag_]*173265
+Ref: tlmgr *repository remove _path|tag_*173297
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*173351
+Ref: tlmgr *repository status*173372
+Ref: tlmgr The tag (which can be the same as the url);174643
+Node: tlmgr restore175121
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*175300
+Ref: tlmgr *restore [_option_...] --all*175331
+Ref: tlmgr *--all* 3176032
+Ref: tlmgr *--backupdir* _directory_ 2176247
+Ref: tlmgr *--dry-run* 4176429
+Ref: tlmgr *--force* 2176562
+Ref: tlmgr *--json* 2176609
+Node: tlmgr search176935
+Ref: tlmgr *search [_option_...] _what_*177099
+Ref: tlmgr *search [_option_...] --file _what_*177137
+Ref: tlmgr *search [_option_...] --all _what_*177174
+Ref: tlmgr *--file* 1177395
+Ref: tlmgr *--all* 4177458
+Ref: tlmgr *--global*177548
+Ref: tlmgr *--word*177676
+Ref: tlmgr *--json* 3178005
+Node: tlmgr shell178212
+Ref: tlmgr protocol178947
+Ref: tlmgr help 1179011
+Ref: tlmgr version 1179064
+Ref: tlmgr quit, end, bye, byebye, EOF179132
+Ref: tlmgr restart179153
+Ref: tlmgr load [local|remote]179276
+Ref: tlmgr save179346
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]179469
+Node: tlmgr show180070
+Node: tlmgr uninstall180237
+Node: tlmgr update [_option_...] [_pkg_...]180469
+Ref: tlmgr *--all* 5180841
+Ref: tlmgr *--self*183021
+Ref: tlmgr *--dry-run* 5183786
+Ref: tlmgr *--list* [_pkg_]183964
+Ref: tlmgr *--exclude* _pkg_184654
+Ref: tlmgr *--no-auto-remove* [_pkg_...]185455
+Ref: tlmgr *--no-auto-install* [_pkg_...]185940
+Ref: tlmgr *--reinstall-forcibly-removed*186703
+Ref: tlmgr *--backup* 1187239
+Ref: tlmgr *--backupdir* _directory_ 3187266
+Ref: tlmgr *--no-depends* 2188433
+Ref: tlmgr *--no-depends-at-all* 2188637
+Ref: tlmgr *--force* 3188744
+Node: tlmgr CONFIGURATION FILE FOR TLMGR189735
+Ref: tlmgr auto-remove = 0 or 1 (default 1), same as command-line option.190737
+Ref: tlmgr gui-expertmode = 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.190869
+Ref: tlmgr gui-lang = _llcode_, with a language code value as with the command-line option.190953
+Ref: tlmgr no-checksums = 0 or 1 (default 0, see below).191002
+Ref: tlmgr persistent-downloads = 0 or 1 (default 1), same as command-line option.191077
+Ref: tlmgr require-verification = 0 or 1 (default 0), same as command-line option.191152
+Ref: tlmgr tkfontscale = _floating-point number_ (default 1.0); scaling factor for fonts in the Tk-based frontends.191260
+Ref: tlmgr update-exclude = _comma-separated list of packages_ (no spaces allowed). Same as the command line option --exclude for the update action.191405
+Ref: tlmgr verify-downloads = 0 or 1 (default 1), same as command-line option.191476
+Ref: tlmgr allowed-actions = _action1_[,_action2_,...] The value is a comma-separated list (no spaces) of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode). This allows distributors to include tlmgr in their packaging, but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations, it doesn't make sense to set this.191993
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION192825
+Node: tlmgr Configuration of GnuPG invocation194998
+Node: tlmgr USER MODE195636
+Node: tlmgr User mode install198507
+Node: tlmgr User mode backup, restore, remove, update199653
+Node: tlmgr User mode generate, option, paper200099
+Node: tlmgr User mode logs200466
+Node: tlmgr MULTIPLE REPOSITORIES200764
+Node: tlmgr Pinning202493
+Node: tlmgr GUI FOR TLMGR204416
+Node: tlmgr Main display206065
+Node: tlmgr Display configuration area206317
+Ref: tlmgr Status206678
+Ref: tlmgr Category206842
+Ref: tlmgr Match207028
+Ref: tlmgr Selection207209
+Ref: tlmgr Display configuration buttons207413
+Node: tlmgr Package list area207596
+Ref: tlmgr a checkbox208180
+Ref: tlmgr package name208316
+Ref: tlmgr local revision (and version)208415
+Ref: tlmgr remote revision (and version)208790
+Ref: tlmgr short description209087
+Node: tlmgr Main display action buttons209132
+Ref: tlmgr Update all installed209398
+Ref: tlmgr Update209770
+Ref: tlmgr Install209820
+Ref: tlmgr Remove210006
+Ref: tlmgr Backup210184
+Node: tlmgr Menu bar210341
+Ref: tlmgr tlmgr menu210564
+Ref: tlmgr Options menu210872
+Ref: tlmgr Actions menu211955
+Ref: tlmgr Help menu212383
+Node: tlmgr GUI options212517
+Ref: tlmgr -background _color_212763
+Ref: tlmgr -font " _fontname_ _fontsize_ "212828
+Ref: tlmgr -foreground _color_212986
+Ref: tlmgr -geometry _geomspec_213038
+Ref: tlmgr -xrm _xresource_213230
+Node: tlmgr MACHINE-READABLE OUTPUT213499
+Node: tlmgr Machine-readable update and install output214313
+Ref: tlmgr location-url _location_215589
+Ref: tlmgr total-bytes _count_215805
+Ref: tlmgr _pkgname_216215
+Ref: tlmgr _status_216425
+Ref: tlmgr d216503
+Ref: tlmgr f216563
+Ref: tlmgr u216742
+Ref: tlmgr r216788
+Ref: tlmgr a216911
+Ref: tlmgr i217089
+Ref: tlmgr I217208
+Ref: tlmgr _localrev_217310
+Ref: tlmgr _serverrev_217417
+Ref: tlmgr _size_217529
+Ref: tlmgr _runtime_217698
+Ref: tlmgr _esttot_217768
+Node: tlmgr Machine-readable option output217801
+Node: tlmgr ENVIRONMENT VARIABLES218313
+Ref: tlmgr TEXLIVE_COMPRESSOR218824
+Ref: tlmgr TEXLIVE_DOWNLOADER219672
+Ref: tlmgr TL_DOWNLOAD_PROGRAM219695
+Ref: tlmgr TL_DOWNLOAD_ARGS219715
+Ref: tlmgr TEXLIVE_PREFER_OWN220741
+Node: tlmgr AUTHORS AND COPYRIGHT221565
+Node: Index221963
End Tag Table
Modified: trunk/Master/texmf-dist/doc/info/web2c.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/web2c.info 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/info/web2c.info 2025-02-10 18:36:39 UTC (rev 73848)
@@ -58,7 +58,7 @@
This document describes how to install and use the programs in the Web2c
implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 2024, released in March 2024.
+corresponds to Web2c version 2025, released in January 2025.
* Menu:
@@ -83,8 +83,8 @@
1 Introduction
**************
-This manual corresponds to version 2024 of Web2c, released in March
-2024.
+This manual corresponds to version 2025 of Web2c, released in January
+2025.
"Web2c" (also spelled Web2C) is the name of a TeX implementation,
originally for Unix, but now also running under Windows and other
@@ -4604,78 +4604,78 @@
Tag Table:
Node: Top2759
-Node: Introduction3831
-Node: Installation7587
-Node: configure options9631
-Node: Compile-time options11653
-Node: Additional targets12755
-Node: Triptrap14032
-Node: Commonalities15535
-Node: Option conventions16192
-Node: Common options17415
-Node: Path searching22121
-Node: Output file location23093
-Node: Three programs26218
-Node: Runtime options26925
-Node: Initial and virgin30066
-Node: Memory dumps31015
-Node: Creating memory dumps31467
-Node: Determining the memory dump to use32674
-Node: Hardware and memory dumps34251
-Node: Editor invocation37001
-Node: \input filenames37864
-Node: \input quoted filename39415
-Node: \input braced filename40192
-Node: \input filename caveats41122
-Node: TeX42636
-Node: tex invocation43804
-Node: Initial TeX50788
-Node: Formats52152
-Node: Languages and hyphenation54969
-Node: MLTeX55399
-Node: \charsubdef57027
-Node: \tracingcharsubdef59350
-Node: TCX files59925
-Node: patgen invocation65365
-Node: Shell escapes66072
-Node: IPC and TeX69840
-Node: TeX extensions70410
-Node: Metafont73191
-Node: mf invocation74479
-Node: Initial Metafont78316
-Node: Modes79946
-Node: Online Metafont graphics82196
-Node: gftodvi invocation85621
-Node: mft invocation88441
-Node: MetaPost92439
-Node: mpost invocation93275
-Node: Initial MetaPost98311
-Node: dvitomp invocation99233
-Node: BibTeX99898
-Node: bibtex invocation100259
-Node: Basic BibTeX style files102733
-Node: WEB104063
-Node: tangle invocation105272
-Node: weave invocation107396
-Node: pooltype invocation108803
-Node: DVI utilities109933
-Node: dvicopy invocation110867
-Node: dvitype invocation112152
-Node: dvitype output example114483
-Node: Font utilities117536
-Node: Font file formats118716
-Node: gftopk invocation121983
-Node: pktogf invocation123174
-Node: pktype invocation124340
-Node: gftype invocation127163
-Node: tftopl invocation131666
-Node: pltotf invocation136259
-Node: vftovp invocation137310
-Node: vptovf invocation139545
-Node: Font utilities available elsewhere140572
-Node: Legalisms142777
-Node: References144224
-Node: Index148357
+Node: Introduction3833
+Node: Installation7591
+Node: configure options9635
+Node: Compile-time options11657
+Node: Additional targets12759
+Node: Triptrap14036
+Node: Commonalities15539
+Node: Option conventions16196
+Node: Common options17419
+Node: Path searching22125
+Node: Output file location23097
+Node: Three programs26222
+Node: Runtime options26929
+Node: Initial and virgin30070
+Node: Memory dumps31019
+Node: Creating memory dumps31471
+Node: Determining the memory dump to use32678
+Node: Hardware and memory dumps34255
+Node: Editor invocation37005
+Node: \input filenames37868
+Node: \input quoted filename39419
+Node: \input braced filename40196
+Node: \input filename caveats41126
+Node: TeX42640
+Node: tex invocation43808
+Node: Initial TeX50792
+Node: Formats52156
+Node: Languages and hyphenation54973
+Node: MLTeX55403
+Node: \charsubdef57031
+Node: \tracingcharsubdef59354
+Node: TCX files59929
+Node: patgen invocation65369
+Node: Shell escapes66076
+Node: IPC and TeX69844
+Node: TeX extensions70414
+Node: Metafont73195
+Node: mf invocation74483
+Node: Initial Metafont78320
+Node: Modes79950
+Node: Online Metafont graphics82200
+Node: gftodvi invocation85625
+Node: mft invocation88445
+Node: MetaPost92443
+Node: mpost invocation93279
+Node: Initial MetaPost98315
+Node: dvitomp invocation99237
+Node: BibTeX99902
+Node: bibtex invocation100263
+Node: Basic BibTeX style files102737
+Node: WEB104067
+Node: tangle invocation105276
+Node: weave invocation107400
+Node: pooltype invocation108807
+Node: DVI utilities109937
+Node: dvicopy invocation110871
+Node: dvitype invocation112156
+Node: dvitype output example114487
+Node: Font utilities117540
+Node: Font file formats118720
+Node: gftopk invocation121987
+Node: pktogf invocation123178
+Node: pktype invocation124344
+Node: gftype invocation127167
+Node: tftopl invocation131670
+Node: pltotf invocation136263
+Node: vftovp invocation137314
+Node: vptovf invocation139549
+Node: Font utilities available elsewhere140576
+Node: Legalisms142781
+Node: References144228
+Node: Index148361
End Tag Table
Modified: trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html
===================================================================
--- trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,11 +1,11 @@
<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the Kpathsea library for path searching.
-Copyright © 1996-2024 Karl Berry & Olaf Weber.
+Copyright © 1996-2025 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -75,102 +75,103 @@
<p>This manual documents the Kpathsea library for path searching. It
corresponds to version 6.4.0, released in
-January 2024.
+January 2025.
</p>
-<div class="element-contents" id="SEC_Contents">
+<div class="region-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="toc-numbered-mark">
- <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a>
+ <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-History-1" href="#History">1.1 History</a></li>
+ <li><a id="toc-History" href="#History">1.1 History</a></li>
</ul></li>
<li><a id="toc-unixtex_002eftp_003a-Obtaining-TeX" href="#unixtex_002eftp">2 <samp class="file">unixtex.ftp</samp>: Obtaining TeX</a></li>
- <li><a id="toc-Security-1" href="#Security">3 Security</a>
+ <li><a id="toc-Security" href="#Security">3 Security</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Global-font-cache-and-security-1" href="#Global-font-cache-and-security">3.1 Global font cache and security</a></li>
+ <li><a id="toc-Global-font-cache-and-security" href="#Global-font-cache-and-security">3.1 Global font cache and security</a></li>
</ul></li>
- <li><a id="toc-TeX-directory-structure-1" href="#TeX-directory-structure">4 TeX directory structure</a></li>
- <li><a id="toc-Path-searching-1" href="#Path-searching">5 Path searching</a>
+ <li><a id="toc-TeX-directory-structure" href="#TeX-directory-structure">4 TeX directory structure</a></li>
+ <li><a id="toc-Path-searching" href="#Path-searching">5 Path searching</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Searching-overview-1" href="#Searching-overview">5.1 Searching overview</a></li>
- <li><a id="toc-Path-sources-1" href="#Path-sources">5.2 Path sources</a>
+ <li><a id="toc-Searching-overview" href="#Searching-overview">5.1 Searching overview</a></li>
+ <li><a id="toc-Path-sources" href="#Path-sources">5.2 Path sources</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Config-files-1" href="#Config-files">5.2.1 Config files</a></li>
+ <li><a id="toc-Config-files" href="#Config-files">5.2.1 Config files</a></li>
</ul></li>
- <li><a id="toc-Path-expansion-1" href="#Path-expansion">5.3 Path expansion</a>
+ <li><a id="toc-Path-expansion" href="#Path-expansion">5.3 Path expansion</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Default-expansion-1" href="#Default-expansion">5.3.1 Default expansion</a></li>
- <li><a id="toc-Variable-expansion-1" href="#Variable-expansion">5.3.2 Variable expansion</a></li>
- <li><a id="toc-Tilde-expansion-1" href="#Tilde-expansion">5.3.3 Tilde expansion</a></li>
- <li><a id="toc-Brace-expansion-1" href="#Brace-expansion">5.3.4 Brace expansion</a></li>
- <li><a id="toc-KPSE_005fDOT-expansion-1" href="#KPSE_005fDOT-expansion">5.3.5 <code class="code">KPSE_DOT</code> expansion</a></li>
- <li><a id="toc-Subdirectory-expansion-1" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li>
+ <li><a id="toc-Default-expansion" href="#Default-expansion">5.3.1 Default expansion</a></li>
+ <li><a id="toc-Variable-expansion" href="#Variable-expansion">5.3.2 Variable expansion</a></li>
+ <li><a id="toc-Tilde-expansion" href="#Tilde-expansion">5.3.3 Tilde expansion</a></li>
+ <li><a id="toc-Brace-expansion" href="#Brace-expansion">5.3.4 Brace expansion</a></li>
+ <li><a id="toc-KPSE_005fDOT-expansion" href="#KPSE_005fDOT-expansion">5.3.5 <code class="code">KPSE_DOT</code> expansion</a></li>
+ <li><a id="toc-Subdirectory-expansion" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li>
</ul></li>
- <li><a id="toc-Casefolding-search-1" href="#Casefolding-search">5.4 Casefolding search</a>
+ <li><a id="toc-Casefolding-search" href="#Casefolding-search">5.4 Casefolding search</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Casefolding-rationale-1" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li>
- <li><a id="toc-Casefolding-examples-1" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li>
+ <li><a id="toc-Casefolding-rationale" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li>
+ <li><a id="toc-Casefolding-examples" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li>
</ul></li>
<li><a id="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.5 Filename database (<code class="code">ls-R</code>)</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-ls_002dR-1" href="#ls_002dR">5.5.1 <samp class="file">ls-R</samp></a></li>
- <li><a id="toc-Filename-aliases-1" href="#Filename-aliases">5.5.2 Filename aliases</a></li>
- <li><a id="toc-Database-format-1" href="#Database-format">5.5.3 Database format</a></li>
+ <li><a id="toc-ls_002dR" href="#ls_002dR">5.5.1 <samp class="file">ls-R</samp></a></li>
+ <li><a id="toc-Filename-aliases" href="#Filename-aliases">5.5.2 Filename aliases</a></li>
+ <li><a id="toc-Database-format" href="#Database-format">5.5.3 Database format</a></li>
</ul></li>
<li><a id="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.6 <code class="code">kpsewhich</code>: Standalone path searching</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Path-searching-options-1" href="#Path-searching-options">5.6.1 Path searching options</a></li>
- <li><a id="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.2 Specially-recognized files for <code class="command">kpsewhich</code></a></li>
- <li><a id="toc-Auxiliary-tasks-1" href="#Auxiliary-tasks">5.6.3 Auxiliary tasks</a></li>
- <li><a id="toc-Standard-options-1" href="#Standard-options">5.6.4 Standard options</a></li>
+ <li><a id="toc-kpsewhich-examples" href="#kpsewhich-examples">5.6.1 <code class="code">kpsewhich</code> examples</a></li>
+ <li><a id="toc-Path-searching-options" href="#Path-searching-options">5.6.2 Path searching options</a></li>
+ <li><a id="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.3 Specially-recognized files for <code class="command">kpsewhich</code></a></li>
+ <li><a id="toc-Auxiliary-tasks" href="#Auxiliary-tasks">5.6.4 Auxiliary tasks</a></li>
+ <li><a id="toc-Standard-options" href="#Standard-options">5.6.5 Standard options</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-TeX-support-1" href="#TeX-support">6 TeX support</a>
+ <li><a id="toc-TeX-support" href="#TeX-support">6 TeX support</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Supported-file-formats-1" href="#Supported-file-formats">6.1 Supported file formats</a></li>
- <li><a id="toc-File-lookup-1" href="#File-lookup">6.2 File lookup</a></li>
- <li><a id="toc-Glyph-lookup-1" href="#Glyph-lookup">6.3 Glyph lookup</a>
+ <li><a id="toc-Supported-file-formats" href="#Supported-file-formats">6.1 Supported file formats</a></li>
+ <li><a id="toc-File-lookup" href="#File-lookup">6.2 File lookup</a></li>
+ <li><a id="toc-Glyph-lookup" href="#Glyph-lookup">6.3 Glyph lookup</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Basic-glyph-lookup-1" href="#Basic-glyph-lookup">6.3.1 Basic glyph lookup</a></li>
- <li><a id="toc-Fontmap-1" href="#Fontmap">6.3.2 Fontmap</a></li>
- <li><a id="toc-Fallback-font-1" href="#Fallback-font">6.3.3 Fallback font</a></li>
+ <li><a id="toc-Basic-glyph-lookup" href="#Basic-glyph-lookup">6.3.1 Basic glyph lookup</a></li>
+ <li><a id="toc-Fontmap" href="#Fontmap">6.3.2 Fontmap</a></li>
+ <li><a id="toc-Fallback-font" href="#Fallback-font">6.3.3 Fallback font</a></li>
</ul></li>
- <li><a id="toc-Suppressing-warnings-1" href="#Suppressing-warnings">6.4 Suppressing warnings</a></li>
- <li><a id="toc-mktex-scripts-1" href="#mktex-scripts">6.5 <samp class="file">mktex</samp> scripts</a>
+ <li><a id="toc-Suppressing-warnings" href="#Suppressing-warnings">6.4 Suppressing warnings</a></li>
+ <li><a id="toc-mktex-scripts" href="#mktex-scripts">6.5 <samp class="file">mktex</samp> scripts</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-mktex-configuration-1" href="#mktex-configuration">6.5.1 <samp class="file">mktex</samp> configuration</a></li>
- <li><a id="toc-mktex-script-names-1" href="#mktex-script-names">6.5.2 <samp class="file">mktex</samp> script names</a></li>
- <li><a id="toc-mktex-script-arguments-1" href="#mktex-script-arguments">6.5.3 <samp class="file">mktex</samp> script arguments</a></li>
+ <li><a id="toc-mktex-configuration" href="#mktex-configuration">6.5.1 <samp class="file">mktex</samp> configuration</a></li>
+ <li><a id="toc-mktex-script-names" href="#mktex-script-names">6.5.2 <samp class="file">mktex</samp> script names</a></li>
+ <li><a id="toc-mktex-script-arguments" href="#mktex-script-arguments">6.5.3 <samp class="file">mktex</samp> script arguments</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Programming-1" href="#Programming">7 Programming</a>
+ <li><a id="toc-Programming" href="#Programming">7 Programming</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Programming-overview-1" href="#Programming-overview">7.1 Programming overview</a></li>
- <li><a id="toc-Calling-sequence-1" href="#Calling-sequence">7.2 Calling sequence</a></li>
- <li><a id="toc-Safe-filenames-1" href="#Safe-filenames">7.3 Safe filenames</a></li>
- <li><a id="toc-Program_002dspecific-files-1" href="#Program_002dspecific-files">7.4 Program-specific files</a></li>
- <li><a id="toc-Programming-with-config-files-1" href="#Programming-with-config-files">7.5 Programming with config files</a></li>
+ <li><a id="toc-Programming-overview" href="#Programming-overview">7.1 Programming overview</a></li>
+ <li><a id="toc-Calling-sequence" href="#Calling-sequence">7.2 Calling sequence</a></li>
+ <li><a id="toc-Safe-filenames" href="#Safe-filenames">7.3 Safe filenames</a></li>
+ <li><a id="toc-Program_002dspecific-files" href="#Program_002dspecific-files">7.4 Program-specific files</a></li>
+ <li><a id="toc-Programming-with-config-files" href="#Programming-with-config-files">7.5 Programming with config files</a></li>
</ul></li>
- <li><a id="toc-Reporting-bugs-1" href="#Reporting-bugs">8 Reporting bugs</a>
+ <li><a id="toc-Reporting-bugs" href="#Reporting-bugs">8 Reporting bugs</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Bug-checklist-1" href="#Bug-checklist">8.1 Bug checklist</a></li>
- <li><a id="toc-Mailing-lists-1" href="#Mailing-lists">8.2 Mailing lists</a></li>
- <li><a id="toc-Debugging-1" href="#Debugging">8.3 Debugging</a></li>
- <li><a id="toc-Logging-1" href="#Logging">8.4 Logging</a></li>
- <li><a id="toc-Common-problems-1" href="#Common-problems">8.5 Common problems</a>
+ <li><a id="toc-Bug-checklist" href="#Bug-checklist">8.1 Bug checklist</a></li>
+ <li><a id="toc-Mailing-lists" href="#Mailing-lists">8.2 Mailing lists</a></li>
+ <li><a id="toc-Debugging" href="#Debugging">8.3 Debugging</a></li>
+ <li><a id="toc-Logging" href="#Logging">8.4 Logging</a></li>
+ <li><a id="toc-Common-problems" href="#Common-problems">8.5 Common problems</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Unable-to-find-files-1" href="#Unable-to-find-files">8.5.1 Unable to find files</a></li>
- <li><a id="toc-Slow-path-searching-1" href="#Slow-path-searching">8.5.2 Slow path searching</a></li>
- <li><a id="toc-Unable-to-generate-fonts-1" href="#Unable-to-generate-fonts">8.5.3 Unable to generate fonts</a></li>
- <li><a id="toc-TeX-or-Metafont-failing-1" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li>
+ <li><a id="toc-Unable-to-find-files" href="#Unable-to-find-files">8.5.1 Unable to find files</a></li>
+ <li><a id="toc-Slow-path-searching" href="#Slow-path-searching">8.5.2 Slow path searching</a></li>
+ <li><a id="toc-Unable-to-generate-fonts" href="#Unable-to-generate-fonts">8.5.3 Unable to generate fonts</a></li>
+ <li><a id="toc-TeX-or-Metafont-failing" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
+ <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
</ul>
</div>
</div>
@@ -186,7 +187,7 @@
<a class="index-entry-id" id="index-fundamental-purpose-of-Kpathsea"></a>
<p>This manual corresponds to version 6.4.0 of the Kpathsea
-library, released in January 2024.
+library, released in January 2025.
</p>
<p>The library’s fundamental purpose is to return a filename from a list of
directories specified by the user, similar to what shells do when
@@ -1745,29 +1746,73 @@
Options can start with either ‘<samp class="samp">-</samp>’ or ‘<samp class="samp">--</samp>’, and any unambiguous
abbreviation is accepted.
</p>
+<p>Kpsewhich looks up each non-option argument on the command line as a
+filename, and outputs (by default) the first file found to standard
+output. If a file is not found, and more than <var class="var">filename</var> is given,
+a blank line is output for that file. See examples below.
+</p>
+<p>The exit status is zero if all files were found, nonzero otherwise.
+</p>
<ul class="mini-toc">
-<li><a href="#Path-searching-options" accesskey="1">Path searching options</a></li>
-<li><a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files for <code class="command">kpsewhich</code></a></li>
-<li><a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></li>
-<li><a href="#Standard-options" accesskey="4">Standard options</a></li>
+<li><a href="#kpsewhich-examples" accesskey="1"><code class="code">kpsewhich</code> examples</a></li>
+<li><a href="#Path-searching-options" accesskey="2">Path searching options</a></li>
+<li><a href="#Specially_002drecognized-files" accesskey="3">Specially-recognized files for <code class="command">kpsewhich</code></a></li>
+<li><a href="#Auxiliary-tasks" accesskey="4">Auxiliary tasks</a></li>
+<li><a href="#Standard-options" accesskey="5">Standard options</a></li>
</ul>
<hr>
+<div class="subsection-level-extent" id="kpsewhich-examples">
+<div class="nav-panel">
+<p>
+Next: <a href="#Path-searching-options" accesskey="n" rel="next">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<h4 class="subsection" id="kpsewhich-examples-1"><span>5.6.1 <code class="code">kpsewhich</code> examples<a class="copiable-link" href="#kpsewhich-examples-1"> ¶</a></span></h4>
+
+<a class="index-entry-id" id="index-kpsewhich-examples"></a>
+<a class="index-entry-id" id="index-examples_002c-of-running-kpsewhich"></a>
+
+<p>Some examples of running <code class="code">kpsewhich</code> with a typical TeX tree.
+A basic successful search (exit status 0):
+</p>
+<div class="example">
+<pre class="example-preformatted">$ kpsewhich plain.tex
+/usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
+</pre></div>
+
+<p>Searching for multiple files, one of which is not found (exit status
+is 1 for this):
+</p>
+<div class="example">
+<pre class="example-preformatted">$ kpsewhich plain.tex foobar plain.mf
+/usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
+
+/usr/local/texlive/2024/texmf-dist/metafont/base/plain.mf
+</pre></div>
+
+<p>Using <code class="code">--all</code> to see all files by the same name (exit status 0):
+</p>
+<div class="example">
+<pre class="example-preformatted">$ kpsewhich --all language.dat
+/usr/local/texlive/2024/texmf-dist/tex/generic/config/language.dat
+/usr/local/texlive/2024/texmf-dist/lambda/generic/config/language.dat
+</pre></div>
+
+<hr>
+</div>
<div class="subsection-level-extent" id="Path-searching-options">
<div class="nav-panel">
<p>
-Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files for <code class="command">kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files for <code class="command">kpsewhich</code></a>, Previous: <a href="#kpsewhich-examples" accesskey="p" rel="prev"><code class="code">kpsewhich</code> examples</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h4 class="subsection" id="Path-searching-options-1"><span>5.6.1 Path searching options<a class="copiable-link" href="#Path-searching-options-1"> ¶</a></span></h4>
+<h4 class="subsection" id="Path-searching-options-1"><span>5.6.2 Path searching options<a class="copiable-link" href="#Path-searching-options-1"> ¶</a></span></h4>
<a class="index-entry-id" id="index-path-searching-options"></a>
-<p>Kpsewhich looks up each non-option argument on the command line as a
-filename, and returns the first file found.
+<p>Various options alter the path searching behavior. Options apply to
+all lookups.
</p>
-<p>Various options alter the path searching behavior:
-</p>
<dl class="table">
<dt><a class="index-entry-id" id="index-all-matches_002c-finding"></a>
<a id="index-_002d_002dall"></a><span>‘<samp class="samp">--all</samp>’<a class="copiable-link" href="#index-_002d_002dall"> ¶</a></span></dt>
@@ -1776,6 +1821,10 @@
random). Exception: with the glyph formats (<code class="code">pk</code>, <code class="code">gf</code>),
this option has no effect and only the first match is returned.
</p>
+<p>With both <code class="code">-all</code> and multiple input files, there’s no easy way to
+discern which matches belong to which files; you have to check the
+basename of the output. This could be improved, if there is any demand.
+</p>
</dd>
<dt><a class="index-entry-id" id="index-_002d_002dno_002dcasefold_002dsearch"></a>
<a id="index-_002d_002dcasefold_002dsearch"></a><span>‘<samp class="samp">--casefold-search</samp>’<a class="copiable-link" href="#index-_002d_002dcasefold_002dsearch"> ¶</a></span></dt>
@@ -2050,7 +2099,7 @@
<p>
Next: <a href="#Auxiliary-tasks" accesskey="n" rel="next">Auxiliary tasks</a>, Previous: <a href="#Path-searching-options" accesskey="p" rel="prev">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h4 class="subsection" id="Specially_002drecognized-files-for-kpsewhich"><span>5.6.2 Specially-recognized files for <code class="command">kpsewhich</code><a class="copiable-link" href="#Specially_002drecognized-files-for-kpsewhich"> ¶</a></span></h4>
+<h4 class="subsection" id="Specially_002drecognized-files-for-kpsewhich"><span>5.6.3 Specially-recognized files for <code class="command">kpsewhich</code><a class="copiable-link" href="#Specially_002drecognized-files-for-kpsewhich"> ¶</a></span></h4>
<p><code class="command">kpsewhich</code> recognizes a few special filenames on the command
line and defaults to using the ‘known’ file formats for them, merely
@@ -2119,7 +2168,7 @@
<p>
Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>, Previous: <a href="#Specially_002drecognized-files" accesskey="p" rel="prev">Specially-recognized files for <code class="command">kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h4 class="subsection" id="Auxiliary-tasks-1"><span>5.6.3 Auxiliary tasks<a class="copiable-link" href="#Auxiliary-tasks-1"> ¶</a></span></h4>
+<h4 class="subsection" id="Auxiliary-tasks-1"><span>5.6.4 Auxiliary tasks<a class="copiable-link" href="#Auxiliary-tasks-1"> ¶</a></span></h4>
<a class="index-entry-id" id="index-auxiliary-tasks"></a>
@@ -2234,7 +2283,7 @@
<p>
Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h4 class="subsection" id="Standard-options-1"><span>5.6.4 Standard options<a class="copiable-link" href="#Standard-options-1"> ¶</a></span></h4>
+<h4 class="subsection" id="Standard-options-1"><span>5.6.5 Standard options<a class="copiable-link" href="#Standard-options-1"> ¶</a></span></h4>
<a class="index-entry-id" id="index-standard-options"></a>
@@ -3190,7 +3239,7 @@
</p>
<a class="index-entry-id" id="index-mktex_002ecnf-1"></a>
<a class="index-entry-id" id="index-mktex_002eopt"></a>
-<a class="index-entry-id" id="index-site-overrides-for-mktex_2026"></a>
+<a class="index-entry-id" id="index-site-overrides-for-mktex_002e_002e_002e"></a>
<p>As distributed, all the scripts source a file
<samp class="file">texmf/web2c/mktex.cnf</samp> if it exists, so you can override various
defaults.
@@ -3388,7 +3437,7 @@
to the program; for example, <code class="code">DVIPSMAKEPK</code> for Dvipsk.
</p>
<a class="index-entry-id" id="index-missfont_002elog"></a>
-<a class="index-entry-id" id="index-failed-mktex_2026-script-invocation"></a>
+<a class="index-entry-id" id="index-failed-mktex_002e_002e_002e-script-invocation"></a>
<p>If a <code class="code">mktex…</code> script fails, the invocation is appended to a
file <samp class="file">missfont.log</samp> (by default) in the current directory. After
fixing the problem, you can then execute the log file to create the
@@ -3711,8 +3760,7 @@
</li><li><a class="index-entry-id" id="index-restricted-mode_002c-for-output-files"></a>
When is set to ‘<samp class="samp">r</samp>’ (for “restricted”), filenames beginning
-with ‘<samp class="samp">.</samp>’ are disallowed (except <samp class="file">.tex</samp>, because LaTeX
-needs it).
+with ‘<samp class="samp">.</samp>’ are disallowed.
</li><li><a class="index-entry-id" id="index-paranoid-mode_002c-for-output-files"></a>
When set to ‘<samp class="samp">p</samp>’ (for “paranoid”), additional restrictions are
@@ -4566,7 +4614,7 @@
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
</td></tr></table>
-<table class="cp-entries-printindex" border="0">
+<table class="cp-entries-printindex">
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th></tr>
@@ -4854,6 +4902,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-epoch_002c-seconds-since">epoch, seconds since</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-error-message-macros">error message macros</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-examples_002c-of-casefolding-searches">examples, of casefolding searches</a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-examples_002c-of-running-kpsewhich">examples, of running <code class="code">kpsewhich</code></a></td><td class="printindex-index-section"><a href="#kpsewhich-examples">kpsewhich examples</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-excessive-startup-time">excessive startup time</a></td><td class="printindex-index-section"><a href="#Slow-path-searching">Slow path searching</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-expand_002ec"><code>expand.c</code></a></td><td class="printindex-index-section"><a href="#Brace-expansion">Brace expansion</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-expanding-symlinks">expanding symlinks</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
@@ -4869,7 +4918,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-colons">extra colons</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-F">F</th></tr>
-<tr><td></td><td class="printindex-index-entry"><a href="#index-failed-mktex_2026-script-invocation">failed <code class="code">mktex…</code> script invocation</a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-failed-mktex_002e_002e_002e-script-invocation">failed <code class="code">mktex…</code> script invocation</a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-font">fallback font</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-resolutions">fallback resolutions</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-FAQ_002c-Kpathsea">FAQ, Kpathsea</a></td><td class="printindex-index-section"><a href="#Common-problems">Common problems</a></td></tr>
@@ -4990,6 +5039,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003einvocation_005fshort_005fname"><code>kpse->invocation_short_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003eprogram_005fname"><code>kpse->program_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-kpsewhich"><code>kpsewhich</code></a></td><td class="printindex-index-section"><a href="#Invoking-kpsewhich">Invoking kpsewhich</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kpsewhich-examples"><code class="code">kpsewhich</code> examples</a></td><td class="printindex-index-section"><a href="#kpsewhich-examples">kpsewhich examples</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-Kpsewhich_002c-and-debugging">Kpsewhich, and debugging</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-L">L</th></tr>
@@ -5164,7 +5214,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-commands_002c-security">shell commands, security</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-shell-variables">shell variables</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-shell_005fescape_002c-example-for-code"><code>shell_escape<span class="r">, example for code</span></code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
-<tr><td></td><td class="printindex-index-entry"><a href="#index-site-overrides-for-mktex_2026">site overrides for <code class="code">mktex…</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-site-overrides-for-mktex_002e_002e_002e">site overrides for <code class="code">mktex…</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-skeleton-TeX-directory">skeleton TeX directory</a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-slow-startup-time">slow startup time</a></td><td class="printindex-index-section"><a href="#Slow-path-searching">Slow path searching</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-source-files"><code>source files</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
Modified: trunk/Master/texmf-dist/doc/kpathsea/kpathsea.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/aleph.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/aleph.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/aleph.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH ALEPH 1 "24 August 2023" "Web2C 2024"
+.TH ALEPH 1 "24 August 2023" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/aleph.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/amstex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/amstex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/amstex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH AMSTEX 1 "16 June 2015" "Web2C 2024"
+.TH AMSTEX 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/amstex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/bibtex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/bibtex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/bibtex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH BIBTEX 1 "24 August 2023" "bibtex 0.99d" "Web2C 2024"
+.TH BIBTEX 1 "18 March 2024" "bibtex 0.99d" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
@@ -5,10 +5,10 @@
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
.el .ds OX TeX
.\" BX definition must follow TX so BX can use TX
-.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if t .ds BX \fRB\s-2IB\s+2\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
-.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\\s-2A\\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\\s-2A\\s+2\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH NAME
@@ -40,13 +40,13 @@
.PP
\*(BX looks up, in bibliographic database
.RB ( .bib )
-files specified by the \\bibliography command,
-the entries specified by the \\cite and \\nocite commands
+files specified by the \ebibliography command,
+the entries specified by the \ecite and \enocite commands
in the \*(LX or \*(TX source file.
It formats the information from those entries
according to instructions in a bibliography style
.RB ( .bst )
-file (specified by the \\bibliographystyle command),
+file (specified by the \ebibliographystyle command),
and it outputs the results to the
.B .bbl
file.
@@ -55,7 +55,8 @@
explains what a \*(LX source file must contain to work with \*(BX.
Appendix B of the manual describes the format of the
.B .bib
-files. The `\*(BXing' document describes extensions and details of
+files.
+The `\*(BXing' document describes extensions and details of
this format, and it gives other useful hints for using \*(BX.
.\"=====================================================================
.SH OPTIONS
@@ -64,11 +65,11 @@
option defines the minimum number of
.B crossref
required for automatic inclusion of the crossref base entry in the citation
-list; the default is two.
+list; the default is two.
To avoid these automatic inclusions altogether, give this option
a sufficiently large number, and be sure to remove any
previous
-.B .aux
+.B .aux
and
.B .bbl
files. Otherwise the option may
@@ -82,13 +83,14 @@
option, \*(BX operates silently. Without it, a banner and progress
reports are printed on
.IR stdout .
-.PP
+.
.\"=====================================================================
.SH ENVIRONMENT
\*(BX searches the directories in the
path defined by the BSTINPUTS environment variable for
.B .bst
-files. If BSTINPUTS is not set, it uses the system default.
+files.
+If BSTINPUTS is not set, it uses the system default.
For
.B .bib
files, it uses the BIBINPUTS environment variable if that is set,
Modified: trunk/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctie.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ctie.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ctie.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH CTIE 1 "8 June 2020" "Web2C 2024"
+.TH CTIE 1 "8 June 2020" "Web2C 2025"
.\"=====================================================================
.SH NAME
ctie \- merge or apply CWEB change files
Modified: trunk/Master/texmf-dist/doc/man/man1/ctie.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctwill-proofsort.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctwill-refsort.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ctwill.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ctwill.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ctwill.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc
.\"
-.TH "CTWILL" "1" "March 10, 2024" "Web2c 2024" "General Commands Manual"
+.TH "CTWILL" "1" "January 1, 2025." "Web2c 2025" "General Commands Manual"
.SH NAME
ctwill, ctwill-proofsort, ctwill-refsort, ctwill-twinx \- translate CWEB to TeX with
mini-indexes
@@ -122,7 +122,7 @@
to be a drop-in replacement for the original package.
There are, however, a few differences worth noting:
.IP \[bu] 2
-This version is based on the most recent version of CWEB (4.11).
+This version is based on the most recent version of CWEB (4.12.1).
.IP \[bu] 2
In TeX\ Live the utility programs are prefixed with \f[B]ctwill\-\f[R]
and the macro files with \f[B]ct\f[R] for technical reasons.
Modified: trunk/Master/texmf-dist/doc/man/man1/ctwill.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/cweave.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/cweb.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/cweb.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/cweb.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc
.\"
-.TH "CWEB" "1" "March 10, 2024" "Web2c 2024" "General Commands Manual"
+.TH "CWEB" "1" "March 10, 2024" "Web2c 2025" "General Commands Manual"
.SH NAME
ctangle, cweave \- translate CWEB to C/C++ and/or TeX
.SH SYNOPSIS
Modified: trunk/Master/texmf-dist/doc/man/man1/cweb.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvicopy.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/dvicopy.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/dvicopy.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2024"
+.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvilualatex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvilualatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvipng.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/dvipng.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/dvipng.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,5 @@
-.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -15,29 +16,12 @@
.ft R
.fi
..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
. ds C`
. ds C'
'br\}
@@ -54,135 +38,77 @@
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
-.if !\nF .nr F 0
-.if \nF>0 \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{\
-. nr % 0
-. nr F 2
+. if !\nF==2 \{\
+. nr % 0
+. nr F 2
+. \}
. \}
.\}
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear. Run. Save yourself. No user-serviceable parts.
-. \" fudge factors for nroff and troff
-.if n \{\
-. ds #H 0
-. ds #V .8m
-. ds #F .3m
-. ds #[ \f1
-. ds #] \fP
-.\}
-.if t \{\
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-. ds #V .6m
-. ds #F 0
-. ds #[ \&
-. ds #] \&
-.\}
-. \" simple accents for nroff and troff
-.if n \{\
-. ds ' \&
-. ds ` \&
-. ds ^ \&
-. ds , \&
-. ds ~ ~
-. ds /
-.\}
-.if t \{\
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-. \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-. \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-. \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-. ds : e
-. ds 8 ss
-. ds o a
-. ds d- d\h'-1'\(ga
-. ds D- D\h'-1'\(hy
-. ds th \o'bp'
-. ds Th \o'LP'
-. ds ae ae
-. ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
+.rr rF
.\" ========================================================================
.\"
.IX Title "DVIPNG 1"
-.TH DVIPNG 1 "2020-01-05" "dvipng 1.17" "User commands"
+.TH DVIPNG 1 2025-02-02 "dvipng 1.18" "User commands"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
-.SH "NAME"
+.SH NAME
dvipng \- A DVI\-to\-PNG translator
-.SH "SYNOPSIS"
+.SH SYNOPSIS
.IX Header "SYNOPSIS"
dvipng [options] filename
.PP
dvipng [options] [filename] \-
-.SH "DESCRIPTION"
+.SH DESCRIPTION
.IX Header "DESCRIPTION"
-This program makes \s-1PNG\s0 and/or \s-1GIF\s0 graphics from \s-1DVI\s0 files as obtained
+This program makes PNG and/or GIF graphics from DVI files as obtained
from TeX and its relatives.
.PP
-If \s-1GIF\s0 support is enabled, \s-1GIF\s0 output is chosen by using the
+If GIF support is enabled, GIF output is chosen by using the
\&\fBdvigif\fR binary or with the \fB\-\-gif\fR option.
.PP
The benefits of \fBdvipng\fR/\fBdvigif\fR include
-.IP "*" 4
-Speed. It is a very fast bitmap-rendering code for \s-1DVI\s0 files, which
+.IP * 4
+Speed. It is a very fast bitmap-rendering code for DVI files, which
makes it suitable for generating large amounts of images on-the-fly,
as needed in preview-latex, WeBWorK and others.
-.IP "*" 4
+.IP * 4
It does not read the postamble, so it can be started before TeX
finishes. There is a \fB\-\-follow\fR switch that makes dvipng wait at
-end-of-file for further output, unless it finds the \s-1POST\s0 marker that
-indicates the end of the \s-1DVI.\s0
-.IP "*" 4
+end-of-file for further output, unless it finds the POST marker that
+indicates the end of the DVI.
+.IP * 4
Interactive query of options. dvipng can read options interactively
through stdin, and all options are usable. It is even possible to change
the input file through this interface.
-.IP "*" 4
-Supports \s-1PK, VF,\s0 PostScript Type1, and TrueType fonts, subfonts (i.e.,
+.IP * 4
+Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts (i.e.,
as used in CJK-LaTeX), color specials, and inclusion of PostScript,
-\&\s-1PNG, JPEG\s0 or \s-1GIF\s0 images.
-.IP "*" 4
+PNG, JPEG or GIF images.
+.IP * 4
and more...
-.SH "OPTIONS"
+.SH OPTIONS
.IX Header "OPTIONS"
Many of the parameterless options listed here can be turned off by
suffixing the option with a zero (\fB0\fR); for instance, to turn off
page reversal, use \fB\-r0\fR. Such options are marked with a trailing
\&\fB*\fR.
-.IP "\fB\-\fR" 4
+.IP \fB\-\fR 4
.IX Item "-"
Read additional options from standard input after processing the command
line.
-.IP "\fB\-\-help\fR" 4
+.IP \fB\-\-help\fR 4
.IX Item "--help"
Print a usage message and exit.
-.IP "\fB\-\-version\fR" 4
+.IP \fB\-\-version\fR 4
.IX Item "--version"
Print the version number and exit.
.IP "\fB\-bd\fR \fInum\fR" 4
@@ -202,7 +128,7 @@
fallback color makes the default border width 1 px.
.IP "\fB\-\-bdpi\fR \fInum\fR" 4
.IX Item "--bdpi num"
-This option only has an effect when using bitmapped (\s-1PK\s0) fonts. The
+This option only has an effect when using bitmapped (PK) fonts. The
option sets the base (Metafont) resolution, both horizontal and
vertical, to \fInum\fR dpi (dots per inch). This option is necessary
when manually selecting Metafont mode with the \-\-mode option (see
@@ -210,7 +136,7 @@
.IP "\fB\-bg\fR \fIcolor_spec\fR" 4
.IX Item "-bg color_spec"
Choose background color for the images. This option will be ignored if
-there is a background color \especial in the \s-1DVI.\s0 The color spec should
+there is a background color \especial in the DVI. The color spec should
be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. You can
also specify 'Transparent' or 'transparent' which will give you a
transparent background with the normal background as a fallback color. A
@@ -217,8 +143,8 @@
capitalized 'Transparent' will give a full-alpha transparency, while an
all-lowercase 'transparent' will give a simple fully transparent
background with non-transparent antialiased pixels. The latter would be
-suitable for viewers who cannot cope with a true alpha channel. \s-1GIF\s0
-images do not support full alpha transparency, so in case of \s-1GIF\s0 output,
+suitable for viewers who cannot cope with a true alpha channel. GIF
+images do not support full alpha transparency, so in case of GIF output,
both variants will use the latter behaviour.
.IP "\fB\-d\fR \fInum\fR" 4
.IX Item "-d num"
@@ -250,7 +176,7 @@
.Ve
.Sp
On some high-res screens, the value is instead 120 dpi. Good luck!
-.IP "\fB\-\-depth*\fR" 4
+.IP \fB\-\-depth*\fR 4
.IX Item "--depth*"
Report the depth of the image. This only works reliably when the
LaTeX style \fIpreview.sty\fR from preview-latex is used with
@@ -265,7 +191,7 @@
.Sp
The depth is a negative offset in this case, so the minus sign is
necessary, and the unit is pixels (px).
-.IP "\fB\-\-dvinum*\fR" 4
+.IP \fB\-\-dvinum*\fR 4
.IX Item "--dvinum*"
Set this option to make the output page number be the TeX page
numbers rather than the physical page number. See the \fB\-o\fR switch.
@@ -272,16 +198,16 @@
.IP "\fB\-fg\fR \fIcolor_spec\fR" 4
.IX Item "-fg color_spec"
Choose foreground color for the images. This option will be ignored if
-there is a foreground color \especial in the \s-1DVI.\s0 The color spec should
+there is a foreground color \especial in the DVI. The color spec should
be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'.
-.IP "\fB\-\-follow*\fR" 4
+.IP \fB\-\-follow*\fR 4
.IX Item "--follow*"
Wait for data at end-of-file. One of the benefits of dvipng is that it
does not read the postamble, so it can be started before TeX
finishes. This switch makes dvipng wait at end-of-file for further
-output, unless it finds the \s-1POST\s0 marker that indicates the end of the
-\&\s-1DVI.\s0 This is similar to \fBtail \-f\fR but for DVI-to-PNG conversion.
-.IP "\fB\-\-freetype*\fR" 4
+output, unless it finds the POST marker that indicates the end of the
+DVI. This is similar to \fBtail \-f\fR but for DVI-to-PNG conversion.
+.IP \fB\-\-freetype*\fR 4
.IX Item "--freetype*"
Enable/disable FreeType font rendering (default on). This option is
available if the FreeType2 font library was present at compilation time.
@@ -288,7 +214,7 @@
If this is the case, dvipng will have direct support for PostScript
Type1 and TrueType fonts internally, rather than using \fBgsftopk\fR
for rendering the fonts. If you have PostScript versions of Computer
-Modern installed, there will be no need to generate bitmapped (\s-1PK\s0)
+Modern installed, there will be no need to generate bitmapped (PK)
variants on disk of these. Then, you can render images at different (and
unusual) resolutions without cluttering the disk with lots of bitmapped
fonts.
@@ -301,15 +227,15 @@
color palette. Default value is 1.0. For 0 < \fInum\fR < 1, the
fonts will be lighter (more like the background), and for \fInum\fR >
1, the fonts will be darker (more like the foreground).
-.IP "\fB\-\-gif*\fR" 4
+.IP \fB\-\-gif*\fR 4
.IX Item "--gif*"
-The images are output in the \s-1GIF\s0 format, if \s-1GIF\s0 support is enabled.
+The images are output in the GIF format, if GIF support is enabled.
This is the default for the \fBdvigif\fR binary, which only will be
-available when \s-1GIF\s0 support is enabled. \s-1GIF\s0 images are palette images
+available when GIF support is enabled. GIF images are palette images
(see the \fB\-\-palette\fR option) and does not support true alpha
channels (see the \fB\-\-bg\fR option). See also the \fB\-\-png\fR
option.
-.IP "\fB\-\-height*\fR" 4
+.IP \fB\-\-height*\fR 4
.IX Item "--height*"
Report the height of the image. This only works reliably when the
LaTeX style \fIpreview.sty\fR from preview-latex is used with
@@ -323,26 +249,26 @@
is the last page in the document. If \fInum\fR is prefixed by an equals
sign, then it (and the argument to the \fB\-p\fR option, if specified)
is treated as a physical (absolute) page number, rather than a value to
-compare with the TeX \fB\ecount0\fR values stored in the \s-1DVI\s0 file.
+compare with the TeX \fB\ecount0\fR values stored in the DVI file.
Thus, using \fB\-l =9\fR will end with the ninth page of the document,
no matter what the pages are actually numbered.
.IP "\fB\-\-mode\fR \fImode\fR" 4
.IX Item "--mode mode"
-This option only has an effect when using bitmapped (\s-1PK\s0) fonts. Use
-\&\fImode\fR as the Metafont device name for the \s-1PK\s0 fonts (both for path
+This option only has an effect when using bitmapped (PK) fonts. Use
+\&\fImode\fR as the Metafont device name for the PK fonts (both for path
searching and font generation). This needs to be augmented with the base
device resolution, given with the \fB\-\-bdpi\fR option. See the file
<\fBftp://ftp.tug.org/tex/modes.mf\fR> for a list of resolutions and mode
names for most devices.
-.IP "\fB\-M*\fR" 4
+.IP \fB\-M*\fR 4
.IX Item "-M*"
-This option only has an effect when using bitmapped (\s-1PK\s0) fonts. It turns
-off automatic \s-1PK\s0 font generation (\fImktexpk\fR).
-.IP "\fB\-\-nogs*\fR" 4
+This option only has an effect when using bitmapped (PK) fonts. It turns
+off automatic PK font generation (\fImktexpk\fR).
+.IP \fB\-\-nogs*\fR 4
.IX Item "--nogs*"
This switch prohibits the internal call to GhostScript for displaying
PostScript specials. \fB\-\-nogs0\fR turns the call back on.
-.IP "\fB\-\-nogssafer*\fR" 4
+.IP \fB\-\-nogssafer*\fR 4
.IX Item "--nogssafer*"
Normally, if GhostScript is used to render PostScript specials, the
GhostScript interpreter is run with the option \fB\-dSAFER\fR. The
@@ -350,7 +276,7 @@
\&\fB\-dSAFER\fR option in Ghostscript disables PostScript operators such
as deletefile, to prevent possibly malicious PostScript programs from
having any effect.
-.IP "\fB\-\-norawps*\fR" 4
+.IP \fB\-\-norawps*\fR 4
.IX Item "--norawps*"
Some packages generate raw PostScript specials, even non-rendering such
specials. This switch turns off the internal call to GhostScript
@@ -358,10 +284,10 @@
turns the call back on.
.IP "\fB\-o\fR \fIname\fR" 4
.IX Item "-o name"
-Send output to the file \fIname\fR. A single occurrence of \fB\f(CB%d\fB\fR or
-\&\fB\f(CB%01d\fB\fR, ..., \fB\f(CB%09d\fB\fR will be exchanged for the physical
+Send output to the file \fIname\fR. A single occurrence of \fR\f(CB%d\fR\fB\fR or
+\&\fB\fR\f(CB%01d\fR\fB\fR, ..., \fB\fR\f(CB%09d\fR\fB\fR will be exchanged for the physical
page number (this can be changed, see the \fB\-\-dvinum\fR switch). The
-default output filename is \fIfile\fR\fB\f(CB%d\fB.png\fR where the input \s-1DVI\s0
+default output filename is \fIfile\fR\fB\fR\f(CB%d\fR\fB.png\fR where the input DVI
file was \fIfile\fR\fB.dvi\fR.
.IP "\fB\-O\fR \fIx\-offset\fR\fB,\fR\fIy\-offset\fR" 4
.IX Item "-O x-offset,y-offset"
@@ -377,18 +303,18 @@
equals sign, then it (and the argument to the \fB\-l\fR option, if
specified) is treated as a physical (absolute) page number, rather than
a value to compare with the TeX \fB\ecount0\fR values stored in the
-\&\s-1DVI\s0 file. Thus, using \fB\-p =3\fR will start with the third page of
+DVI file. Thus, using \fB\-p =3\fR will start with the third page of
the document, no matter what the pages are actually numbered.
-.IP "\fB\-\-palette*\fR" 4
+.IP \fB\-\-palette*\fR 4
.IX Item "--palette*"
When an external image is included, \fBdvipng\fR will automatically
switch to truecolor mode, to avoid unnecessary delay and quality
-reduction, and enable the \s-1EPS\s0 translator to draw on a transparent
+reduction, and enable the EPS translator to draw on a transparent
background and outside of the boundingbox. This switch will force
palette (256\-color) output and make \fBdvipng\fR revert to opaque
clipped image inclusion. This will also override the \fB\-\-truecolor\fR
switch if present.
-.IP "\fB\-\-picky*\fR" 4
+.IP \fB\-\-picky*\fR 4
.IX Item "--picky*"
No images are output when a warning occurs. Normally, dvipng will
output an image in spite of a warning, but there may be something
@@ -396,10 +322,10 @@
have a more complete but slower fallback converter. Mainly, this is
useful for failed figure inclusion and unknown \especial occurrences,
but warnings will also occur for missing or unknown color specs and
-missing \s-1PK\s0 fonts.
-.IP "\fB\-\-png*\fR" 4
+missing PK fonts.
+.IP \fB\-\-png*\fR 4
.IX Item "--png*"
-The images are output in the \s-1PNG\s0 format. This is the default for the
+The images are output in the PNG format. This is the default for the
\&\fBdvipng\fR binary. See also the \fB\-\-gif\fR option.
.IP "\fB\-pp\fR \fIfirstpage\fR\fB\-\fR\fIlastpage\fR" 4
.IX Item "-pp firstpage-lastpage"
@@ -406,7 +332,7 @@
Print pages \fIfirstpage\fR through \fIlastpage\fR; but not quite
equivalent to \fB\-p\fR \fIfirstpage\fR \fB\-l\fR \fIlastpage\fR. For example,
when rendering a book, there may be several instances of a page in the
-\&\s-1DVI\s0 file (one in \f(CW\*(C`\efrontmatter\*(C'\fR, one in \f(CW\*(C`\emainmatter\*(C'\fR, and one
+DVI file (one in \f(CW\*(C`\efrontmatter\*(C'\fR, one in \f(CW\*(C`\emainmatter\*(C'\fR, and one
in \f(CW\*(C`\ebackmatter\*(C'\fR). In case of several pages matching, \fB\-pp\fR
\&\fIfirstpage\fR\fB\-\fR\fIlastpage\fR will render \fIall\fR pages that
matches the specified range, while \fB\-p\fR \fIfirstpage\fR \fB\-l\fR
@@ -417,10 +343,10 @@
range in \fB\-pp\fR between the pages from \fB\-p\fR to \fB\-l\fR. Also
multiple \fB\-pp\fR options accumulate, unlike \fB\-p\fR and \fB\-l\fR.
The \fB\-\fR separator can also be \fB:\fR. Note that \fB\-pp \-1\fR
-will be interpreted as \*(L"all pages up to and including 1\*(R", if you want a
+will be interpreted as "all pages up to and including 1", if you want a
page numbered \-1 (only the table of contents, say) put \fB\-pp \-1\-\-1\fR,
or more readable, \fB\-pp \-1:\-1\fR.
-.IP "\fB\-q*\fR" 4
+.IP \fB\-q*\fR 4
.IX Item "-q*"
Run quietly. Don't chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
@@ -427,15 +353,15 @@
.IP "\fB\-Q\fR \fInum\fR" 4
.IX Item "-Q num"
Set the quality to \fInum\fR. That is, choose the number of antialiasing
-levels for bitmapped fonts (\s-1PK\s0), to be
+levels for bitmapped fonts (PK), to be
\&\fInum\fR*\fInum\fR+1. The default value is 4 which gives 17 levels of
antialiasing for antialiased fonts from these two. If FreeType is
available, its rendering is unaffected by this option.
-.IP "\fB\-r*\fR" 4
+.IP \fB\-r*\fR 4
.IX Item "-r*"
Toggle output of pages in reverse/forward order. By default, the first
-page in the \s-1DVI\s0 is output first.
-.IP "\fB\-\-strict*\fR" 4
+page in the DVI is output first.
+.IP \fB\-\-strict*\fR 4
.IX Item "--strict*"
The program exits when a warning occurs. Normally, dvipng will output
an image in spite of a warning, but there may be something missing in
@@ -447,23 +373,23 @@
Set the image size to \fIimage_size\fR which can be either of
\&\fBbbox\fR, \fBtight\fR, or a comma-separated pair of dimensions
\&\fIhsize\fR,\fIvsize\fR such as \fB.1in,.3cm\fR. The default is
-\&\fBbbox\fR which produces a \s-1PNG\s0 that includes all ink put on the page
-and in addition the \s-1DVI\s0 origin, located 1in from the top and 1in from
+\&\fBbbox\fR which produces a PNG that includes all ink put on the page
+and in addition the DVI origin, located 1in from the top and 1in from
the left edge of the paper. This usually gives whitespace above and to
the left in the produced image. The value \fBtight\fR will make dvipng
only include all ink put on the page, producing neat images.
-.IP "\fB\-\-truecolor*\fR" 4
+.IP \fB\-\-truecolor*\fR 4
.IX Item "--truecolor*"
This will make \fBdvipng\fR generate truecolor output. Note that
truecolor output is automatic if you include an external image in your
-\&\s-1DVI,\s0 e.g., via a PostScript special (i.e., the \fBgraphics\fR or
+DVI, e.g., via a PostScript special (i.e., the \fBgraphics\fR or
\&\fBgraphicx\fR package). This switch is overridden by the
\&\fB\-\-palette\fR switch.
-.IP "\fB\-v*\fR" 4
+.IP \fB\-v*\fR 4
.IX Item "-v*"
Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
-.IP "\fB\-\-width*\fR" 4
+.IP \fB\-\-width*\fR 4
.IX Item "--width*"
Report the width of the image. See also \fB\-\-height\fR and
\&\fB\-\-depth\fR.
@@ -472,25 +398,25 @@
This option is deprecated; it should not be used. It is much better to
select the output resolution directly with the \fB\-D\fR option. This
option sets the magnification ratio to \fInum\fR/1000 and
-overrides the magnification specified in the \s-1DVI\s0 file. Must be between
+overrides the magnification specified in the DVI file. Must be between
10 and 100000. It is recommended that you use standard magstep values
(1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the
-total number of \s-1PK\s0 files generated. \fInum\fR may be a real number, not
+total number of PK files generated. \fInum\fR may be a real number, not
an integer, for increased precision.
.IP "\fB\-z\fR \fInum\fR" 4
.IX Item "-z num"
-Set the \s-1PNG\s0 compression level to \fInum\fR. This option is enabled if
+Set the PNG compression level to \fInum\fR. This option is enabled if
your \fBlibgd\fR is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
older \fBlibgd\fR, the hard-soldered value 5 is used. The include file
\&\fBpng.h\fR says
-\&\*(L"Currently, valid values range from 0 \- 9, corresponding directly to
-the zlib compression levels 0 \- 9 (0 \- no compression, 9 \- \*(R"maximal\*(L"
+"Currently, valid values range from 0 \- 9, corresponding directly to
+the zlib compression levels 0 \- 9 (0 \- no compression, 9 \- "maximal"
compression). Note that tests have shown that zlib compression levels
-3\-6 usually perform as well as level 9 for \s-1PNG\s0 images, and do
+3\-6 usually perform as well as level 9 for PNG images, and do
considerably fewer calculations. In the future, these values may not
-correspond directly to the zlib compression levels.\*(R"
-.SH "NOTES"
+correspond directly to the zlib compression levels."
+.SH NOTES
.IX Header "NOTES"
The full manual is accessible in info format, on most systems by typing
.PP
@@ -497,10 +423,10 @@
.Vb 1
\& info dvipng
.Ve
-.SH "COPYRIGHT"
+.SH COPYRIGHT
.IX Header "COPYRIGHT"
-This program is released under the \s-1GNU\s0 Lesser General Public License
-version 3, see the \s-1COPYING\s0 file in the dvipng distribution or
+This program is released under the GNU Lesser General Public License
+version 3, see the COPYING file in the dvipng distribution or
<\fBhttp://www.gnu.org/licenses/gpl.html\fR>.
.PP
Copyright (c) 2002\-2015, 2019 Jan-AAke Larsson
Modified: trunk/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvisvgm.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/dvisvgm.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/dvisvgm.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -2,12 +2,12 @@
.\" Title: dvisvgm
.\" Author: Martin Gieseking <martin.gieseking at uos.de>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 2024-02-04
+.\" Date: 2025-01-04
.\" Manual: dvisvgm Manual
-.\" Source: dvisvgm 3.2.2
+.\" Source: dvisvgm 3.4.3
.\" Language: English
.\"
-.TH "DVISVGM" "1" "2024\-02\-04" "dvisvgm 3\&.2\&.2" "dvisvgm Manual"
+.TH "DVISVGM" "1" "2025\-01\-04" "dvisvgm 3\&.4\&.3" "dvisvgm Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -44,14 +44,14 @@
.sp
SVG is a vector\-based graphics format and therefore dvisvgm tries to convert the glyph outlines of all fonts referenced in a DVI page section to scalable path descriptions\&. The fastest way to achieve this is to extract the path information from vector\-based font files available in PFB, TTF, or OTF format\&. If dvisvgm is able to find such a file, it extracts all necessary outline information about the glyphs from it\&.
.sp
-However, TeX\(cqs main source for font descriptions is Metafont, which produces bitmap output (GF files)\&. That\(cqs why not all obtainable TeX fonts are available in a scalable format\&. In these cases, dvisvgm tries to vectorize Metafont\(cqs output by tracing the glyph bitmaps\&. The results are not as perfect as most (manually optimized) PFB or OTF counterparts, but are nonetheless really nice in most cases\&.
+However, TeX\(cqs former main source for font descriptions is Metafont, which produces bitmap output in terms of GF files\&. That\(cqs why not all obtainable TeX fonts are available in a scalable format\&. In these cases, dvisvgm tries to vectorize Metafont\(cqs output by tracing the glyph bitmaps\&. The results are not as perfect as most (manually optimized) PFB or OTF counterparts, but are nonetheless really nice in most cases\&.
.sp
-When running dvisvgm without option \fB\-\-no\-fonts\fR, it creates \fIfont\fR elements (\fB<font>\fR\&...\fB</font>\fR) to embed the font data into the SVG files\&. Unfortunately, only few SVG renderers support these elements yet\&. Most web browsers and vector graphics applications don\(cqt evaluate them properly so that the text components of the resulting graphics might look strange\&. In order to create more compatible SVG files, command\-line option \fB\-\-no\-fonts\fR can be given to replace the font elements by plain graphics paths\&. Most web browsers (but only few external SVG renderers) also support WOFF and WOFF2 fonts that can be used instead of the default SVG fonts\&. Option \fB\-\-font\-format\fR offers the functionality to change the format applied to the fonts being embedded\&. This, however, only works when converting DVI files\&. Text present in PDF and PostScript files is always converted to path elements\&.
+When running dvisvgm without option \fB\-\-no\-fonts\fR, it creates \fIfont\fR elements (\fB<font>\fR\&...\fB</font>\fR) to embed the font data into the SVG files\&. Unfortunately, only few SVG renderers support these elements\&. Most web browsers and vector graphics applications don\(cqt evaluate them properly so that the text components of the resulting graphics might look strange\&. In order to create more compatible SVG files, command\-line option \fB\-\-no\-fonts\fR can be given to replace the font elements by plain graphics paths\&. Most web browsers (but only few external SVG renderers) also support WOFF and WOFF2 fonts that can be used instead of the default SVG fonts\&. Option \fB\-\-font\-format\fR offers the functionality to change the format applied to the fonts being embedded\&. This, however, only works when converting DVI files\&. Text present in PDF and PostScript files is always converted to path elements\&.
.SH "OPTIONS"
.sp
-dvisvgm provides a POSIX\-compliant command\-line interface with short and long option names\&. They may be given before and/or after the name of the file to be converted\&. Also, the order of specifying the options is not significant, i\&.e\&. you can add them in any order without changing dvisvgm\(cqs behavior\&. Certain options accept or require additional parameters which are directly appended to or separated by whitespace from a short option (e\&.g\&. \fB\-v0\fR or \fB\-v 0\fR)\&. Long options require an additional equals sign (\fB=\fR) between option name and argument but without any surrounding whitespace (e\&.g\&. \fB\-\-verbosity=0\fR)\&. Multiple short options that don\(cqt expect a further parameter can be combined after a single dash (e\&.g\&. \fB\-ejs\fR rather than \fB\-e \-j \-s\fR)\&.
+dvisvgm provides a POSIX\-compliant command\-line interface with short and long option names\&. They may be given before and/or after the name of the file to be converted\&. Also, the order of specifying the options is not significant, i\&.e\&. you can add them in any order without changing dvisvgm\(cqs behavior\&. Certain options accept or require additional parameters which are directly appended to or separated by whitespace from a short option (e\&.g\&. \fB\-v0\fR or \fB\-v 0\fR)\&. Long options require an additional equals sign (\fB=\fR) between option name and argument but without any surrounding whitespace (e\&.g\&. \fB\-\-verbosity=0\fR)\&. Multiple short options that don\(cqt expect further parameters can be combined after a single dash (e\&.g\&. \fB\-ejs\fR rather than \fB\-e \-j \-s\fR)\&.
.sp
-Long option names may also be shortened by omitting trailing characters\&. As long as the shortened name is unambiguous, it\(cqs recognized and applied\&. For example, option \fB\-\-exact\-bbox\fR can be shortened to \fB\-\-exact\fR, \fB\-\-exa\fR, or \fB\-\-ex\fR\&. In case of an ambiguous abbreviation, dvisvgm prints an error message together with all matching option names\&.
+Long option names may also be shortened by omitting trailing characters as long as the shortened name is still unambiguous\&. For example, option \fB\-\-exact\-bbox\fR can be shortened to \fB\-\-exact\fR, \fB\-\-exa\fR, or \fB\-\-ex\fR\&. In case of ambiguous abbreviations, dvisvgm prints an error message together with all matching option names\&.
.PP
\fB\-b, \-\-bbox\fR=\fIfmt\fR
.RS 4
@@ -167,7 +167,7 @@
.PP
\fB\-B, \-\-bitmap\-format\fR=\fIfmt\fR
.RS 4
-This option sets the image format used to embed bitmaps extracted from PostScript or PDF data\&. By default, dvisvgm embeds all bitmaps as JPEG images because it\(cqs the most compact of the two formats supported by SVG\&. To select the alternative lossless PNG format,
+This option sets the image format used to embed bitmaps that are extracted from PostScript or PDF data\&. By default, dvisvgm embeds all bitmaps as JPEG images because it\(cqs the most compact of the two formats supported by SVG\&. To select the alternative lossless PNG format,
\fB\-\-bitmap\-format=png\fR
can be used\&. There are some more format variants dvisvgm currently supports even though
\fBjpeg\fR
@@ -322,8 +322,11 @@
.RS 4
Embeds the contents of bitmap files into the generated SVG files instead of adding file references\&. Because of the base64\-encoded data, the SVG files are usually much bigger but at the same time more portable because they don\(cqt rely on external bitmap files\&.
.sp
-This option only affects bitmaps referenced in DVI/XDV files, e\&.g\&. added by
-\fB\eincludegraphics\fR\&. Bitmaps in PostScript or PDF files are always embedded\&. Also see option
+This option only affects bitmaps referenced in DVI/XDV files, e\&.g\&. by
+\fB\eincludegraphics\fR
+or special command
+\fBdvisvgm:img\fR
+(see below)\&. Bitmaps present in PostScript or PDF files are always embedded\&. Also see option
\fBbitmap\-format\fR\&.
.RE
.PP
@@ -379,6 +382,7 @@
Loads and evaluates a single font map file or a sequence of font map files\&. These files are required to resolve font file names and encodings\&. dvisvgm does not provide its own map files but tries to read available ones coming with dvips or dvipdfm\&. If option
\fB\-\-fontmap\fR
is omitted, dvisvgm looks for the default map files
+\fIdvisvgm\&.map\fR,
\fIps2pk\&.map\fR,
\fIpdftex\&.map\fR,
\fIdvipdfm\&.map\fR, and
@@ -429,8 +433,54 @@
dvips (\m[blue]https://tug.org/texinfohtml/dvips.html\m[])
and
dvipdfm (\m[blue]https://ctan.org/tex-archive/dviware/dvipdfm\m[])\&.
+.sp
+dvisvgm supports both the
+\fIdvips\fR
+and the
+\fIdvipdfm\fR
+map file formats\&. It extends both variants by two include statements that allow for loading other map files inside a map file\&. The syntax is as follows:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+#include [<modechar>] <filename|filepath>
+#includefirst [<modechar>] <filename|filepath>
+.fi
+.if n \{\
.RE
+.\}
+.sp
+They must be placed on a separate line and start at the first column of that line\&. Otherwise, they are ignored\&. While the first variant always tries to include the specified file,
+\fB#includefirst\fR
+is only executed once, i\&.e\&. once a file was successfully included by this statement, all subsequent
+\fB#includefirst\fR
+lines are skipped\&. This can be used to include one of several alternative files, whereby the first one found is loaded and all others are ignored\&.
+.sp
+The optional parameter
+\fI<modechar>\fR
+(which can be
+\fB+\fR,
+\fB\-\fR, or
+\fB=\fR) determines how to integrate the data read from the included file into the already present mapping data\&. They work the same way as the mode specifiers described above\&. If
+\fI<modechar>\fR
+parameter is omitted, it defaults to
+\fB+\fR\&.
+.sp
+The following filename or file path specifies the file to include\&. In case of plain filenames (without path indicators), the files are looked up using the TeX file search functionality, i\&.e\&. files in the TeX directory tree can easily be added\&. Relative paths are relative to the location of the file containing the
+\fB#include\fR
+statement\&. Path components must be separated by forward slashes (\fB/\fR), also on Windows systems\&.
+.sp
+Examples:
+\fB#include pdftex\&.map\fR
+looks for
+\fIpdftex\&.map\fR
+in the current working directory and in the TeX directory tree\&.
+\fB#include \&./pdftex\&.map\fR, on the other hand, looks for
+\fIpdftex\&.map\fR
+only in the directory where the including file is located\&.
.RE
+.RE
.PP
\fB\-\-grad\-overlap\fR
.RS 4
@@ -441,11 +491,11 @@
.PP
\fB\-\-grad\-segments\fR=\fInumber\fR
.RS 4
-Determines the maximal number of segments per column and row used to approximate gradient color fills\&. Since SVG 1\&.1 only supports a small subset of the shading algorithms available in PostScript, dvisvgm approximates some of them by subdividing the area to be filled into smaller, monochromatic segments\&. Each of these segments gets the average color of the region it covers\&. Thus, increasing the number of segments leads to smaller monochromatic areas and therefore a better approximation of the actual color gradient\&. As a drawback, more segments imply bigger SVG files because every segment is represented by a separate path element\&.
+Determines the maximum number of segments per column and row used to approximate gradient color fills\&. Since SVG 1\&.1 only supports a small subset of the shading algorithms available in PostScript, dvisvgm approximates some of them by subdividing the area to be filled into smaller, monochromatic segments\&. Each of these segments gets the average color of the region it covers\&. Thus, increasing the number of segments leads to smaller monochromatic areas and therefore a better approximation of the actual color gradient\&. As a drawback, more segments imply bigger SVG files because every segment is represented by a separate path element\&.
.sp
Currently, dvisvgm supports free\- and lattice\-form triangular patch meshes as well as Coons and tensor\-product patch meshes\&. They are approximated by subdividing the area of each patch into a
\fIn\fR\(mu\fIn\fR
-grid of smaller segments\&. The maximal number of segments per column and row can be changed with option
+grid of smaller segments\&. The maximum number of segments per column and row can be changed with option
\fB\-\-grad\-segments\fR\&.
.RE
.PP
@@ -556,7 +606,7 @@
.RS 4
Prints a given message to the console after an SVG file has been written\&. Argument
\fItext\fR
-may consist of static text and the macros listed below in the description of special command
+may consist of static text as well as the macros listed below in the description of special command
\fBdvisvgm:raw\fR\&. For example,
\fB\-\-message="page {?pageno} written to {?svgfile}"\fR
prints the message with the macros expanded after the conversion of each page of a DVI or PDF file or after processing an EPS file\&.
@@ -563,7 +613,7 @@
.sp
The output of option
\fB\-\-message\fR
-is not affected by the specified verbosity level, i\&.e\&. it prints the text even with
+is not affected by a specified verbosity level, i\&.e\&. dvisvgm prints the text even with
\fB\-\-verbosity=0\fR\&.
.RE
.PP
@@ -812,11 +862,11 @@
\fB\-\-page=10\-\fR
converts all pages starting with page 10\&. Please consider that the page values don\(cqt refer to the page numbers printed on the corresponding page\&. Instead, the physical page count is expected, where the first page always gets number 1\&.
.sp
-At the end of the range sequence an optional filter specifier can be added\&. Currently, the two filters
+At the end of the range sequence an optional filter specifier can be appended in order to remove certain page numbers from the sequence\&. Currently, the two filters
\fB:even\fR
and
\fB:odd\fR
-are supported which restrict the preceding values to even or odd numbers\&. For example,
+are supported which restrict the preceding values to even and odd numbers, respectively\&. For example,
\fB\-\-page=1\-11,20:even\fR
is equivalent to
\fB\-\-page=2,4,6,8,10,20\fR\&.
@@ -920,7 +970,7 @@
.PP
\fB\-d, \-\-precision\fR=\fIdigits\fR
.RS 4
-Specifies the maximal number of decimal places applied to floating\-point attribute values\&. All attribute values written to the generated SVG file(s) are rounded accordingly\&. The parameter
+Specifies the maximum number of decimal places applied to floating\-point attribute values\&. All attribute values written to the generated SVG file(s) are rounded accordingly\&. The parameter
\fIdigits\fR
accepts integer values from 0 to 6, where 0 enables the automatic selection of significant decimal places\&. This is also the default value if dvisvgm is called without option
\fB\-\-precision\fR\&.
@@ -1300,6 +1350,25 @@
\fBcolor\fR
.RS 4
Statements of this command set provide instructions to change the text/paint color\&. For an overview of the exact syntax, see the documentation of dvips, for instance\&.
+.sp
+dvisvgm extends the dvips syntax of the color specials by two optional modifiers to enable the differentiation between fill and stroke colors, i\&.e\&. colors used to fill enclosed areas and to draw lines, respectively\&. If one of the color specifiers, like a color name or a color model followed by a sequence of color components, is preceded by
+\fBfill\fR
+or
+\fBstroke\fR, only the corresponding color is changed\&. Without these modifiers both colors are affected\&. Example:
+\fBcolor push fill rgb 1 0 1\fR
+pushes a new color pair onto the color stack whereby the fill color is set to magenta and the stroke color retains its current value\&.
+\fBcolor push rgb 1 0 1\fR
+pushes a color pair with both colors set to magenta\&.
+.sp
+Additionally, the new special
+\fBcolor set\fR
+is introduced\&. Its syntax is the same as the one of
+\fBcolor push\fR
+including the optional
+\fBfill\fR
+and
+\fBstroke\fR
+modifiers\&. Instead of pushing a new color pair it modifies the topmost one on the stack\&. If the color stack is empty, the default (black) fill/stroke color is changed\&.
.RE
.PP
\fBdvisvgm\fR
@@ -1312,30 +1381,49 @@
\fIraw\fR
specials\&. The tags themselves can also be split but must be continued with the immediately following
\fIraw\fR
-special\&. Both syntactically incorrect and wrongly nested tags lead to error messages\&. Parameter
+special\&. Both syntactically incorrect and wrongly nested tags lead to error messages\&.
+.sp
+Parameter
\fItext\fR
may also contain the expressions
\fB{?x}\fR,
\fB{?y}\fR,
\fB{?color}\fR,
+\fB{?fillcolor}\fR,
+\fB{?strokecolor}\fR,
\fB{?matrix}\fR,
\fB{?pageno}\fR,
\fB{?svgfile}\fR, and
\fB{?svgpath}\fR
-that expand to the current
+that respectively expand to the current
\fIx\fR
-or
+and
\fIy\fR
-coordinate, the current color, the current transformation matrix, the current page number, and the relative and absolute path of the SVG file being created, respectively\&. Character sequence
+coordinate, an RGB hex string of the current active fill and stroke color, the current transformation matrix, the current page number, and the relative and absolute path of the SVG file being created\&.
+\fB{?color}\fR
+expands to the same string as
+\fB{?fillcolor}\fR
+and is still available for compatibility with older dvisvgm versions that didn\(cqt distinguish between fill and stroke colors (see information about color specials below)\&.
+.sp
+As SVG doesn\(cqt support CMYK colors, for example in
+\fBfill\fR
+and
+\fBstroke\fR
+attributes, dvisvgm provides macro
+\fB{?cmyk(\fR\fB\fIc\fR\fR\fB,\fR\fB\fIm\fR\fR\fB,\fR\fB\fIy\fR\fR\fB,\fR\fB\fIk\fR\fR\fB)}\fR
+to create an RGB hex string from a CMYK color\&. It can be used instead of a combination of color/PostScript specials and color macros to directly insert a CMYK color value\&.
+.sp
+Character sequence
\fB{?nl}\fR
expands to a newline character\&. Finally, constructions of the form
\fB{?(\fR\fB\fIexpr\fR\fR\fB)}\fR
-enable the evaluation of mathematical expressions which may consist of basic arithmetic operations including modulo\&. Like above, the variables
+enable the evaluation of mathematical expressions which may consist of basic arithmetic operations including modulo\&. As above, the variables
\fIx\fR
and
\fIy\fR
-represent the current coordinates\&. Example:
-\fB{?(\-10*(x+2y)\-5)}\fR\&.
+represent the current coordinates\&. Invalid operations, like divisions by zero, lead to an error message on the console\&. Example:
+\fB{?(\-10*(x+2y)\-5)}\fR
+is a valid expresssion and expands to the corresponding numeric string\&.
.RE
.PP
\fBdvisvgm:rawdef\fR \fItext\fR
@@ -1394,12 +1482,20 @@
.PP
\fBdvisvgm:img\fR \fIwidth\fR \fIheight\fR \fIfile\fR
.RS 4
-Creates an image element at the current graphic position referencing the given file\&. JPEG, PNG, and SVG images can be used here\&. However, dvisvgm does not check the file format or the file name suffix\&. The lengths
+Creates an
+\fBimage\fR
+element using the current graphic position, transformation matrix, the specified extents, and the given filename\&. This special command also updates the bounding box of the resulting SVG to entirely enclose the transformed image\&. The image itself is positioned such that the lower left corner of the untransformed image lies at the current graphic position\&. The length
\fIwidth\fR
and
\fIheight\fR
-can be given together with a unit specifier (see option
-\fB\-\-bbox\fR) or as plain floating point numbers\&. In the latter case, TeX point units are assumed (1in = 72\&.27pt)\&.
+specify the extents of the untransformed image\&. For a list of supported length units see option
+\fB\-\-bbox\fR\&. Plain numbers without an appended unit specifier imply TeX points (1in = 72\&.27pt)\&.
+.sp
+Parameter
+\fIfile\fR
+can be a plain filename or a relative or absolute path of a file\&. By default, dvisvgm just creates links referencing the image file so that the SVG renderer will evaluate the filename or path relative to the location of the generated SVG file\&. If option
+\fB\-\-embed\-bitmaps\fR
+is given, JPEG and PNG images are embedded into the SVG document\&. As this requires base64\-encoding of the image data, the resulting SVG files can become quite big\&.
.RE
.PP
\fBdvisvgm:bbox\fR lock
@@ -1415,7 +1511,9 @@
\fBdvisvgm:bbox\fR n[ew] \fIname\fR
.RS 4
Defines or resets a local bounding box called
-\fIname\fR\&. The name may consist of letters and digits\&. While processing a DVI page, dvisvgm continuously updates the (global) bounding box of the current page in order to determine the minimal rectangle containing all visible page components (characters, images, drawing elements etc\&.) Additionally to the global bounding box, the user can request an arbitrary number of named local bounding boxes\&. Once defined, these boxes are updated together with the global bounding box starting with the first character that follows the definition\&. Thus, the local boxes can be used to compute the extent of parts of the page\&. This is useful for scenarios where the generated SVG file is post\-processed\&. In conjunction with special
+\fIname\fR\&. The name may consist of letters and digits\&. While processing a DVI page, dvisvgm continuously updates the (global) bounding box of the current page in order to determine the minimal rectangle containing all visible page components (characters, images, drawing elements etc\&.) Additionally to the global bounding box, the user can request an arbitrary number of named local bounding boxes\&. Once defined, these boxes are updated together with the global bounding box starting with the first character that follows the definition\&. Thus, the local boxes can be used to compute the extent of parts of the page\&. This is useful for scenarios where the generated SVG file is post\-processed\&.
+.sp
+In conjunction with special
\fBdvisvgm:raw\fR, the macro
\fB{?bbox \fR\fB\fIname\fR\fR\fB}\fR
expands to the four values
@@ -1443,7 +1541,9 @@
\fIheight\fR, and
\fIdepth\fR
can be given together with a unit specifier (see option
-\fB\-\-bbox\fR) or as plain floating point numbers\&. In the latter case, TeX point units are assumed (1in = 72\&.27pt)\&. Depending on size and position of the virtual rectangle, this command either enlarges the overall bounding box or leaves it as is\&. It\(cqs not possible to reduce its extent\&. This special should be used together with
+\fB\-\-bbox\fR) or as plain floating point numbers\&. In the latter case, TeX point units are assumed (1in = 72\&.27pt)\&. Depending on size and position of the virtual rectangle, this command either enlarges the overall bounding box or leaves it as is\&. So, it\(cqs not possible to reduce its extent\&.
+.sp
+This special is supposed to be used together with
\fBdvisvgm:raw\fR
in order to update the viewport of the page properly\&. By default, the box extents are assigned unchanged and, in particular, are not altered by transformation commands\&. In order to apply the current transformation matrix, the optional modifier
\fBtransform\fR
@@ -1486,7 +1586,7 @@
This special works similar to option
\fB\-\-currentcolor\fR
but doesn\(cqt require an explicit color argument\&. Instead, it takes the currently active color and replaces it with
-\fBcurrentColor\fR\&. Therefore, the result depends on the placement of the special and the preceding color changes\&. Argument
+\fBcurrentColor\fR\&. Therefore, the result depends on both the placement of the special and the preceding color changes\&. Argument
\fBon\fR
\(en which activates the
\fIcurrentColor\fR
@@ -1498,10 +1598,12 @@
.RS 4
Prints the given text
\fImsg\fR
-to the console\&. It may also contain the macros
-\fI{?\&...}\fR
-mentioned above (see
-\fBdvisvgm:raw\fR)\&.
+to the console\&. Besides static text it may also contain the macros
+\fB{?\&...}\fR
+mentioned in the description of
+\fBdvisvgm:raw\fR\&. The messages created by this special can be suppressed with option
+\fB\-\-verbosity\fR
+(see above)\&.
.RE
.RE
.PP
@@ -1848,4 +1950,4 @@
Written by Martin Gieseking <\m[blue]\fBmartin\&.gieseking at uos\&.de\fR\m[]>
.SH "COPYING"
.sp
-Copyright \(co 2005\-2024 Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&.
+Copyright \(co 2005\-2025 Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&.
Modified: trunk/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvitomp.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/dvitomp.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/dvitomp.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH DVITOMP 1 "16 June 2015" "Web2C 2024"
+.TH DVITOMP 1 "16 June 2015" "Web2C 2025"
.\" man page by Jim Van Zandt <jrv at vanzandt.mv.com>
.SH NAME
dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE
Modified: trunk/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/dvitype.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/dvitype.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/dvitype.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH DVITYPE 1 "16 June 2015" "Web2C 2024"
+.TH DVITYPE 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/eptex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/euptex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/gftodvi.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/gftodvi.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/gftodvi.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH GFTODVI 1 "4 March 2021" "Web2C 2024"
+.TH GFTODVI 1 "4 March 2021" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/gftopk.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/gftopk.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/gftopk.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH GFTOPK 1 "16 June 2015" "Web2C 2024"
+.TH GFTOPK 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/gftype.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/gftype.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/gftype.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH GFTYPE 1 "16 June 2015" "Web2C 2024"
+.TH GFTYPE 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/gftype.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/inimf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/initex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/kpseaccess.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/kpseaccess.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/kpseaccess.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.4.0"
+.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.4.1"
.\"=====================================================================
.if n .ds MP MetaPost
.if t .ds MP MetaPost
Modified: trunk/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.4.0"
+.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.4.1"
.\"=====================================================================
.SH NAME
kpsereadlink \- print contents of symbolic link
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsestat.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/kpsestat.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/kpsestat.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.4.0"
+.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.4.1"
.\"=====================================================================
.if n .ds MP MetaPost
.if t .ds MP MetaPost
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsewhich.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/kpsewhich.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/kpsewhich.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.4.0"
+.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.4.1"
.\"=====================================================================
.if n .ds MP MetaPost
.if t .ds MP MetaPost
Modified: trunk/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/latex-dev.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/latex-dev.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/latex-dev.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH LATEX-DEV 1 "17 November 2019" "Web2C 2024"
+.TH LATEX-DEV 1 "17 November 2019" "Web2C 2025"
.SH NAME
latex-dev, pdflatex-dev, xelatex-dev, lualatex-dev, dvilualatex-dev, platex-dev, uplatex-dev \- release candidate LaTeX testing
.SH SYNOPSIS
Modified: trunk/Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/latex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/latex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/latex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH LATEX 1 "30 April 2018" "Web2C 2024"
+.TH LATEX 1 "30 April 2018" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/latex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/luajithbtex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/luajittex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/lualatex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/lualatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/luatex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/luatex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/luatex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH LUATEX 1 "17 November 2019" "Web2C 2024"
+.TH LUATEX 1 "17 November 2019" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/luatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/mf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/mf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/mf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH MF 1 "24 August 2023" "Web2C 2024"
+.TH MF 1 "24 August 2023" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/mf.man1.pdf
===================================================================
(Binary files differ)
Added: trunk/Master/texmf-dist/doc/man/man1/mflua.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/mflua.1 (rev 0)
+++ trunk/Master/texmf-dist/doc/man/man1/mflua.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -0,0 +1,72 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
+.TH MFLUA "1" "February 2025" "TeX Live" "User Commands"
+.SH NAME
+MFLua \- manual page for MFLua 2.71828182-1.0.1-alpha (TeX Live 2025)
+.SH SYNOPSIS
+.B mflua
+[\fI\,OPTION\/\fR]... [\fI\,MFNAME\/\fR[\fI\,.mf\/\fR]] [\fI\,COMMANDS\/\fR]
+.br
+.B mflua
+[\fI\,OPTION\/\fR]... \fI\,\FIRST-LINE\/\fR
+.br
+.B mflua
+[\fI\,OPTION\/\fR]... \fI\,&BASE ARGS\/\fR
+.SH DESCRIPTION
+.IP
+Run MFLua on MFNAME, usually creating MFNAME.tfm and MFNAME.NNNNgf,
+where NNNN is the resolution of the specified mode (2602 by default).
+Any following COMMANDS are processed as Metafont input,
+after MFNAME is read.
+If the first line of MFNAME is %&BASE, and BASE is an existing .base file,
+use it. Else use `NAME.base', where NAME is the program invocation name,
+most commonly `mf'.
+.IP
+Alternatively, if the first non\-option argument begins with a backslash,
+interpret all non\-option arguments as a line of Metafont input.
+.IP
+Alternatively, if the first non\-option argument begins with a &, the
+next word is taken as the BASE to read, overriding all else. Any
+remaining arguments are processed as above.
+.IP
+If no arguments or options are specified, prompt for input.
+.PP
+\fB\-base\fR=\fI\,BASENAME\/\fR use BASENAME instead of program name or a %& line
+[\-no]\-file\-line\-error disable/enable file:line:error style messages
+\fB\-halt\-on\-error\fR stop processing at the first error
+\fB\-ini\fR be inimf, for dumping bases; this is implicitly
+.IP
+true if the program name is `inimf'
+.PP
+\fB\-interaction\fR=\fI\,STRING\/\fR set interaction mode (STRING=batchmode/nonstopmode/
+.IP
+scrollmode/errorstopmode)
+.PP
+\fB\-jobname\fR=\fI\,STRING\/\fR set the job name to STRING
+\fB\-kpathsea\-debug\fR=\fI\,NUMBER\/\fR set path searching debugging flags according to
+.IP
+the bits of NUMBER
+.PP
+[\-no]\-mktex=FMT disable/enable mktexFMT generation (FMT=mflua)
+\fB\-output\-directory\fR=\fI\,DIR\/\fR use existing DIR as the directory to write files in
+[\-no]\-parse\-first\-line disable/enable parsing of first line of input file
+\fB\-progname\fR=\fI\,STRING\/\fR set program (and base) name to STRING
+\fB\-recorder\fR enable filename recorder
+\fB\-translate\-file\fR=\fI\,TCXNAME\/\fR use the TCX file TCXNAME
+\fB\-8bit\fR make all characters printable by default
+\fB\-help\fR display this help and exit
+\fB\-version\fR output version information and exit
+.SH "REPORTING BUGS"
+Email bug reports to luigi.scarso at gmail.com.
+.PP
+kpathsea version 6.4.1
+.br
+Copyright 2025 L. Scarso.
+.br
+There is NO warranty. Redistribution of this software is
+covered by the terms of both the MFLua copyright and
+the Lesser GNU General Public License.
+.br
+For more information about these matters, see the file
+named COPYING and the MFLua source.
+.br
+Primary author of MFLua: L. Scarso.
Property changes on: trunk/Master/texmf-dist/doc/man/man1/mflua.1
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf 2025-02-10 18:36:39 UTC (rev 73848)
Property changes on: trunk/Master/texmf-dist/doc/man/man1/mflua.man1.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Modified: trunk/Master/texmf-dist/doc/man/man1/mft.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/mft.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/mft.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH MFT 1 "27 May 2018" "Web2C 2024"
+.TH MFT 1 "27 May 2018" "Web2C 2025"
.\"=====================================================================
.if n .ds MP MetaPost
.if t .ds MP MetaPost
Modified: trunk/Master/texmf-dist/doc/man/man1/mft.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/mpost.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/mpost.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/mpost.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH MPOST 1 "31 December 2018" "Web2C 2024"
+.TH MPOST 1 "31 December 2018" "Web2C 2025"
.\"=====================================================================
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
Modified: trunk/Master/texmf-dist/doc/man/man1/mpost.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ofm2opl.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ofm2opl.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ofm2opl.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH OFM2OPL 1 "8 March 2022" "Web2C 2024"
+.TH OFM2OPL 1 "8 March 2022" "Web2C 2025"
.PP
.SH "NAME"
ofm2opl \- convert Omega and TeX font-metric files to property-list files
Modified: trunk/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/opl2ofm.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/opl2ofm.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/opl2ofm.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH OPL2OFM 1 "8 March 2022" "Web2C 2024"
+.TH OPL2OFM 1 "8 March 2022" "Web2C 2025"
.PP
.SH "NAME"
opl2ofm \- convert Omega and TeX property-list files to font-metric files
Modified: trunk/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/otangle.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH OVF2OVP 1 "8 March 2022" "Web2C 2024"
+.TH OVF2OVP 1 "8 March 2022" "Web2C 2025"
.PP
.SH "NAME"
ovf2ovp \- convert virtual font file and associated font metrics to property-list format
Modified: trunk/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH OVP2OVF 1 "8 March 2022" "Web2C 2024"
+.TH OVP2OVF 1 "8 March 2022" "Web2C 2025"
.PP
.SH "NAME"
ovp2ovf \- convert a virtual property-list file into a virtual font file and its associated font metric file
Modified: trunk/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/patgen.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/patgen.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/patgen.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PATGEN 1 "16 June 2015" "Web2C 2024"
+.TH PATGEN 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/patgen.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pbibtex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pbibtex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pbibtex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PBIBTEX 1 "24 July 2021" "Web2C 2023"
+.TH PBIBTEX 1 "24 July 2021" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/pbibtex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pdfetex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pdfetex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pdfetex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PDFETEX 1 "16 June 2015" "Web2C 2024"
+.TH PDFETEX 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pdftex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pdftex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pdftex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "2 March 2024" "Web2C 2024"
+.TH PDFTEX 1 "2 March 2024" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pdftosrc.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pdftosrc.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pdftosrc.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH pdftosrc 1 "16 June 2015" "Web2C 2024"
+.TH pdftosrc 1 "16 June 2015" "Web2C 2025"
.SH NAME
pdftosrc \- extract source file or stream from PDF file
.SH SYNOPSIS
Modified: trunk/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pktogf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pktogf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pktogf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PKTOGF 1 "16 June 2015" "Web2C 2024"
+.TH PKTOGF 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pktype.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pktype.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pktype.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PKTYPE 1 "16 June 2015" "Web2C 2024"
+.TH PKTYPE 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/pktype.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/platex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pltotf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pltotf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pltotf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PLTOTF 1 "16 June 2015" "Web2C 2024"
+.TH PLTOTF 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/pooltype.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/pooltype.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/pooltype.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH POOLTYPE 1 "16 June 2015" "Web2C 2024"
+.TH POOLTYPE 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ppltotf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ppltotf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ppltotf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PPLTOTF 1 "15 March 2019" "Web2C 2023"
+.TH PPLTOTF 1 "15 March 2019" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ptex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ptex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ptex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PTEX 1 "08 August 2021" "Web2C 2023"
+.TH PTEX 1 "08 August 2021" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/ptex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ptftopl.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ptftopl.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ptftopl.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH PTFTOPL 1 "30 August 2022" "Web2C 2023"
+.TH PTFTOPL 1 "30 August 2022" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/tangle.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/tangle.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/tangle.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TANGLE 1 "02 March 2022" "Web2C 2024"
+.TH TANGLE 1 "02 March 2022" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/tangle.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/tex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/tex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/tex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TEX 1 "6 August 2019" "Web2C 2024"
+.TH TEX 1 "6 August 2019" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/tex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/texlua.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/texluac.man1.pdf
===================================================================
(Binary files differ)
Added: trunk/Master/texmf-dist/doc/man/man1/texprof.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/texprof.1 (rev 0)
+++ trunk/Master/texmf-dist/doc/man/man1/texprof.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -0,0 +1,345 @@
+.TH TEXPROF 1 "2 September 2024" "Version 1.0"
+.\"=====================================================================
+.if n .ds MF Metafont
+.if t .ds MF Metafont
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.if n .ds TX TeX
+.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
+.el .ds OX TeX
+.\" BX definition must follow TX so BX can use TX
+.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if n .ds BX BibTeX
+.\" LX definition must follow TX so LX can use TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if n .ds LX LaTeX
+.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
+.if n .ds AX AmSTeX
+.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
+.if n .ds AY AmSLaTeX
+.if n .ds WB Web
+.if t .ds WB W\s-2EB\s0
+.\"=====================================================================
+.SH NAME
+texprof \- A profiler for TeX source files
+.SH SYNOPSIS
+.B texprof
+.RI [ options ]
+.RI [ \fB&\fPformat ]
+.RI [ file | \fB\e\fPcommands ]
+.\"=====================================================================
+.SH DESCRIPTION
+Run the \*(TX profiler on
+.IR file ,
+usually creating
+.IR file.dvi
+and
+.IR file.tprof .
+If the
+.IR file
+argument has no extension, ".tex" will be appended to it.
+Instead of a file name, a list of \*(TX commands can be given, the first
+of which must start with a backslash.
+With a
+.BI & format
+argument, the \*(TX profiler uses a different set of precompiled commands,
+contained in
+.IR format\fB.fmt\fP ;
+it is usually better to use the
+.B -fmt
+.I format
+option instead.
+.PP
+The \*(TX profiler is a version of \*(TX that measures the time
+\*(TX needs to execute individual input lines or macros.
+It writes the collected data to a file with extension
+.IR .tprof .
+A separate program,
+.B texprofile
+(see
+.BR texprofile (1)),
+is used to display the content of a
+.IR .tprof
+file in a readable form.
+
+.PP
+The typical use of the \*(TX profiler is with pre generated formats.
+The
+.B texprof
+command uses the equivalent of the plain \*(TX format, and the
+.B latexprof
+command uses the equivalent of the \*(LX format. To investigate
+the timing of macros targeted to
+.B pdftex
+or
+.B pdflatex,
+you can use
+.B pdftexprof
+or
+.B pdflatexprof.
+
+.PP
+The \*(TX profiler's handling of its command-line arguments is similar
+to that of the other \*(TX programs in the
+.I web2c
+implementation.
+
+.\"=====================================================================
+.SH OPTIONS
+This version of the \*(TX profiler understands the following command line
+options.
+.TP
+.BI -cnf-line \ string
+Parse
+.I string
+as a
+.I texmf.cnf
+configuration line. See the Kpathsea manual.
+.TP
+.B -etex
+Enable the e-\*(TX extensions. This option is only effective in
+combination with
+.BR -ini .
+See
+.BR etex (1).
+.TP
+.B -file-line-error
+Print error messages in the form
+.I file:line:error
+which is similar to the way many compilers format them.
+.TP
+.B -no-file-line-error
+Disable printing error messages in the
+.I file:line:error
+style.
+.TP
+.BI -fmt \ format
+Use
+.I format
+as the name of the format to be used, instead of the name by which
+the \*(TX profiler was called or a
+.I %&
+line.
+.TP
+.B -help
+Print help message and exit.
+.TP
+.B -ini
+Start in
+.I INI
+mode, which is used to dump formats. The
+.I INI
+mode can be used for typesetting, but no format is preloaded, and
+basic initializations like setting catcodes may be required.
+.TP
+.BI -interaction \ mode
+Sets the interaction mode. The mode can be either
+.IR batchmode ,
+.IR nonstopmode ,
+.IR scrollmode ,
+and
+.IR errorstopmode .
+The meaning of these modes is the same as that of the corresponding
+\ecommands.
+.TP
+.BI -jobname \ name
+Use
+.I name
+for the job name, instead of deriving it from the name of the input file.
+.TP
+.BI -kpathsea-debug \ bitmask
+Sets path searching debugging flags according to the bitmask. See the
+.I Kpathsea
+manual for details.
+.TP
+.B -ltx
+Enable the \*(LX extensions. This option is only effective in
+combination with
+.BR -ini .
+See
+.BR latex (1).
+.TP
+.BI -mktex \ fmt
+Enable
+.RI mktex fmt ,
+where
+.I fmt
+must be either
+.IR tex ,
+.IR tfm ,
+.IR fmt ,
+or
+.IR pk .
+.TP
+.BI -no-mktex \ fmt
+Disable
+.RI mktex fmt ,
+where
+.I fmt
+must be either
+.IR tex ,
+.IR tfm ,
+.IR fmt ,
+or
+.IR pk .
+.TP
+.BI -output-directory \ directory
+Write output files in
+.I directory
+instead of the current directory. Look up input files in
+.I directory
+first, then along the normal search path.
+.TP
+.B -parse-first-line
+If the first line of the main input file begins with
+.I %&
+parse it to look for a dump name.
+.TP
+.B -no-parse-first-line
+Disable parsing of the first line of the main input file.
+.TP
+.B -pdf
+Enable the simulation of common
+.B pdftex
+primitives. This option requires the
+.BR -ini
+option and implies the
+.BR -ltx
+option.
+See
+.BR pdftex (1).
+.TP
+.B -prof
+Enable profiling as soon as \*(TX enters the main loop. If tis option
+it not used, profiling needs to switched on using the \eprofileon
+primitive. Profiling can be switched of with the \eprofileoff
+primitive.
+.TP
+.BI -progname \ name
+Pretend to be program
+.IR name .
+This affects both the format used and the search paths.
+.TP
+.B -version
+Print version information and exit.
+.\"=====================================================================
+.SH ENVIRONMENT
+See the Kpathsea library documentation (e.g., the `Path specifications'
+node) for precise details of how the environment variables are used.
+The
+.B kpsewhich
+utility can be used to query the values of the variables.
+.PP
+.TP
+.B TEXMFOUTPUT
+Normally, \*(TX puts its output files in the current directory. If
+any output file cannot be opened there, it tries to open it in the
+directory specified in the environment variable TEXMFOUTPUT.
+There is no default value for that variable. For example, if you say
+.I texprof paper
+and the current directory is not writable and TEXMFOUTPUT has
+the value
+.IR /tmp ,
+\*(TX attempts to create
+.I /tmp/paper.log ,
+.I /tmp/paper.dvi ,
+and
+.I /tmp/paper.tprof .
+TEXMFOUTPUT is also checked for input
+files, as \*(TX often generates files that need to be subsequently
+read; for input, no suffixes (such as ``.tex'') are added by default,
+the input name is simply checked as given.
+.TP
+.B TEXINPUTS
+Search path for
+.I \einput
+and
+.I \eopenin
+files.
+This normally starts with ``.'', so
+that user files are found before system files. An empty path
+component will be replaced with the paths defined in the
+.I texmf.cnf
+file. For example, set TEXINPUTS to ".:/home/user/tex:" to prepend the
+current directory and ``/home/user/tex'' to the standard search path.
+.TP
+.B TEXFORMATS
+Search path for format files.
+.TP
+.B TFMFONTS
+Search path for font metric
+.RI ( .tfm )
+files.
+.TP
+.B SOURCE_DATE_EPOCH
+If set, its value, taken to be in epoch-seconds, will be used for the
+creation date and as the reference moment for the time related
+primitives of \*(LX. This is useful for making reproducible builds.
+.TP
+.B FORCE_SOURCE_DATE
+If set to the value "1", the time-related \*(TX primitives
+.RI ( \eyear ,
+.IR \emonth ,
+.IR \eday ,
+.IR \etime )
+are also initialized from the value of SOURCE_DATE_EPOCH. This is not
+recommended if there is any viable alternative.
+.PP
+Many, many more environment variables may be consulted related to path
+searching. See the Kpathsea manual.
+.\"=====================================================================
+.SH FILES
+The location of the files mentioned below varies from system to
+system. Use the
+.B kpsewhich
+utility to find their locations.
+.TP
+.I *.tfm
+Metric files for \*(TX's fonts.
+.TP
+.I *.fmt
+Predigested \*(TX format files.
+.TP
+.I *.pk *.pfb
+Font files used by \*(TX.
+.\"=====================================================================
+.SH NOTES
+This manual page is not meant to be exhaustive. The complete
+documentation for the \*(TX profiler can be found in
+.IR texprof.pdf .
+Further information can be found in the manual of the
+.IR "Kpathsea library" .
+.\"=====================================================================
+.SH BUGS
+This version of the \*(TX profiler does not implement all of the
+primitives that pdftex provides, and further, it will not produce
+the same side effects.
+.\"=====================================================================
+.SH AVAILABILITY
+The \*(TX profiler should compile on a large variety of machine architectures
+and operating systems. The function to obtain timing information id POSIX
+specific.
+.PP
+The sources of the \*(TX profiler are hosted at
+.BR https://github.com/ruckertm/HINT
+.\"=====================================================================
+.SH "SEE ALSO"
+.BR texprofiler (1),
+.BR tex (1),
+.BR latex (1),
+.BR pdftex (1),
+.BR pdflatex (1), and
+.BR kpsewhich (1).
+.\"=====================================================================
+.SH AUTHORS
+The primary author of the \*(TX profiler is Martin Ruckert,
+with e\*(TX extensions by Peter Breitenlohner,
+\*(LX extensions by Thierry Laronde,
+and
+the kpathsearch library by Karl Berry.
+.PP
+\*(TX was designed by Donald E. Knuth,
+who implemented it using his \*(WB system for Pascal programs.
+.PP
+Many, many more contributed to the typesetting system now known as \*(TX;
+far too many to name all of them here.
+.\" vim: syntax=nroff
Property changes on: trunk/Master/texmf-dist/doc/man/man1/texprof.1
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf 2025-02-10 18:36:39 UTC (rev 73848)
Property changes on: trunk/Master/texmf-dist/doc/man/man1/texprof.man1.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/man/man1/texprofile.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/texprofile.1 (rev 0)
+++ trunk/Master/texmf-dist/doc/man/man1/texprofile.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -0,0 +1,596 @@
+'\" t
+.\" Manual page created with latex2man on Tue Jan 28 17:56:46 2025
+.\" NOTE: This file is generated, DO NOT EDIT.
+.de Vb
+.ft CW
+.nf
+..
+.de Ve
+.ft R
+
+.fi
+..
+.TH "TEXPROFILE" "1" "28\-1\-2025" "Displaying TeX profiles " "Displaying TeX profiles "
+.SH NAME
+
+.PP
+texprofile
+\- Displaying the profile data collected by texprof\&.
+.PP
+.SH SYNOPSIS
+
+.PP
+texprofile
+[Options] \fIinputfile\fP
+.PP
+.SH DESCRIPTION
+
+texprofile
+reads the binary \fIinputfile\fP
+as produced by
+texprof\&.
+The extension \&.tprof
+of the input file can be
+omitted. It analyses the data and presents the results in a variety of
+tables, either optimized for human readability or as CSV (comma
+separated values) files for further processing.
+.PP
+The output is written to the standard output stream where it can be redirected
+to a file or viewed immediately.
+.PP
+.SH OPTIONS
+
+There are four types of options: general options, table options,
+selection options, and formatting options.
+.PP
+The general options:
+.TP
+\fB\-?\fP \fB\-h\fP \fB\-\-help\fP
+ Display a short help text and exit the program.
+.TP
+\fB\-\-version\fP
+ Display the version information and exit.
+.PP
+The table options determine the tables that will be displayed.
+These options all use upper case letters.
+If no table option is given, only some global information is shown.
+.PP
+.TP
+\fB\-T\fP
+ Show the table of the top 10 input lines.
+.TP
+\fB\-G\fP
+ Show the table of the macro call graph.
+.TP
+\fB\-C\fP
+ Show the table of times per TeX command.
+.TP
+\fB\-L\fP
+ Show the table of times per input line.
+.TP
+\fB\-R\fP
+ Show the table of raw time stamps.
+.TP
+\fB\-S\fP
+ Show the table of macro stack changes.
+.TP
+\fB\-F\fP
+ Show the table of all input files.
+.TP
+\fB\-M\fP
+ Show the table of all macros called.
+.TP
+\fB\-A\fP
+ Show important tables (equal to \-TGFC) tables.
+.TP
+\fB\-N\fP
+ Do not show the table of global information.
+.PP
+The selection options allow to reduce the amount of data that is shown
+in the table by omitting table entries that contribute little to the
+overall runtime.
+.PP
+.TP
+\fB\-p\fP\fIn\fP
+ Do not show information for table entries
+with cumulative time below \fIn\fP
+percent. The default is 1.0 percent.
+.TP
+\fB\-t\fP\fIn\fP
+ Limit the number of input lines shown in the
+table of the ``Top Ten\&'' to \fIn\fP\&.
+This option is only useful
+with the \fB\-T\fP
+option.
+.PP
+The formatting option determine the formatting of the information in the tables
+as well as the selection of information that is shown in the tables.
+.PP
+.TP
+\fB\-i\fP
+ Add the macros file and line numbers after the macro name.
+This option is useful to distinguish two macros that share
+the same name.
+.TP
+\fB\-m\fP
+ Optimize output for machine readability. When optimized for human readability,
+times are rounded and given in a short form adding a unit identifier:
+s for seconds, ms for milliseconds, us for micro seconds, and ns for
+nanoseconds. This format is inconvenient if you want to import the data
+for example into a spread\-sheet for further processing.
+With the \fB\-m\fP
+option times are simply given in nano seconds without units.
+Similar the combined time for the total time used for a macro and the
+time used as a sub\-macro from the call graph is given in a single column
+with a slash separating both numbers is nice for human readers.
+With the \fB\-m\fP
+option both numbers will simply be given in separate columns.
+.PP
+.TP
+\fB\-n\fP
+ Show the time stamp numbers. This option is useful together with
+the \fB\-R\fP
+option, if you import the table into a database or spread\-sheet.
+If you sort the data by various properties into different
+categories, the time stamp number can be used to keeping the entries
+within a category sorted by time.
+.PP
+.TP
+\fB\-s\fP
+ Show the changes of the macro stack.
+This option is useful with the \fB\-R\fP
+option if you want to see the changes
+in the macro stack (see \fB\-S\fP)
+together with the timing information in
+a single table.
+.PP
+.SH DATA FORMATS
+
+.SS FILE NUMBERS
+While texprof
+is running, every TeX input file is given a
+unique file number. The file name alone is often not unique because
+two files in different directories might have the same file
+name. Displaying the full file name with the complete path is however often
+not very
+convenient. So if you observe the same file name together with
+different file numbers, you can use the option \fB\-F\fP
+to get a table of all
+file numbers and their full file names.
+.PP
+But even within the same
+directory, TeX can read different files with the same name during one
+run: TeX can open a file for writing, write content to the file, close
+it, open it for reading, read it and close it again. Then TeX might
+repeat this process a second time, or multiple times, reusing the same
+file name over and over again. texprof
+will assign a new file
+number to this file each time it is opened for reading. So you can
+tell from the sequence of file numbers which one was the first, the
+second, or the third.
+.PP
+Last not least, there are some special file
+numbers:
+.TP
+0 \- unknown
+If the file is unknown, which should rarely happen,
+the file number 0 is used.
+.TP
+1\- system
+texprof
+will map
+time intervals that are used to execute certain system routines
+to the ``system\&'' pseudo file
+using the line numbers to identify the specific routine
+like producing the output DVI file (shipout), breaking
+a paragraph into lines (linebrk), or breaking the
+document into pages (buildpg). These times do not depend on the
+use of macros but simply on the size of the document.
+.TP
+2 \- terminal
+TeX commands entered on the command line or interactively are mapped
+to file number 2.
+.PP
+.SS TIME
+If the option \fB\-m\fP
+is given times are given as nanoseconds.
+Otherwise, times are rounded to at most 4 digits precission and
+displayed with a unit: seconds (s), milliseconds (ms), microseconds
+(um), or nanoseconds (ns).
+.PP
+.SS MACRO NAMES
+Macro names are shown with the leading backslash. Since macro names
+are often not unique, the command line option \fB\-i\fP
+can be used to
+show after the macro name in square brackets the file number and the
+line number where the macro is defined. Unless two macros with the
+same name are defined in the same file and line this is sufficient to
+uniquely identify a macro. A macro defined with ``let\&'' results in a
+complet copy of the original macro. Therefore it will not reference
+the file and line of the ``let\&'' command but the same file and line as
+the original macro.
+.PP
+.SH EXAMPLES
+
+Let\&'s assume that you issue the command texprof
+\fB\-prof\fP
+\fIhello.tex\fP\&.
+This will run texprof
+on the input file
+\fIhello.tex\fP
+with option \fB\-prof\fP\&.
+The program texprof
+will load the plain TeX format and then process hello.tex
+to
+produce hello.log
+and hello.dvi\&.
+It will execute
+exactly the same steps that TeX would execute if you had issued the
+command tex
+\fIhello.tex\fP\&.
+.PP
+In addition to hello.log
+and hello.dvi,
+texprof
+will also produce the file hello.tprof
+containing time
+measurements made while texprof
+was running. The option
+\fB\-prof\fP
+will switch on the gathering of timing data as soon as
+texprof
+enters its main control procedure; The file
+hello.tprof
+will contain a time measurement, called a time
+stamp, for every command that TeX executed while processing the input.
+A binary format is used to store all that data in a simple and compact
+form. Still the file hello.tprof
+might become very big.
+.PP
+The program texprofile
+is used to extract and analyse the data
+contained in hello.tprof
+and produce useful output. Here are
+some examples:
+.PP
+.TP
+texprofile \fIhello\fP
+ Without further options texprofile
+will write some general
+information to the standard output, like the total time measured,
+the number of samples, the average time per sample, etc.
+The general information is always given unless explicitely disabled
+with the \fB\-N\fP
+option or with the \fB\-m\fP
+option.
+.PP
+.TP
+texprofile \fB\-T\fP \fIhello\fP
+ With the option \fB\-T\fP,
+texprofile
+will map each time stamp
+to a specific line of input, add up the time intervalls for each input
+line separately, and output a table showing the ten lines that have
+the highest cummulative time.
+The table has the following seven columns:
+.RS
+.TP
+1. file
+The first column contains the input file number as explained above.
+The input file name if shown in column 7.
+.TP
+2. line
+The line number.
+.TP
+3. percent
+The time spent in this line and file as a percentage of the total
+time measured as given as part of the general information.
+.TP
+4. absolute
+The absolute time spent in this line and file.
+.TP
+5. count
+The number of times the execution path entered this line.
+Note, that a
+macro call usually redirects the execution path to another line
+from where the execution will return after the macro call has completed.
+Reentering the line after such an excursion to an other line will
+cause this counter to be incremented. In summary, this counter might
+reflect the number of partial executions of a line not the number
+of full executions of the entire line.
+.TP
+6. average
+The average time spent in the line is simply computed by dividing the
+value in column 4 by the value in column 5.
+.TP
+7. file
+The input file name. The corresponding file number is shown in column 1.
+.RE
+.RS
+.PP
+.RE
+.TP
+texprofile \fB\-G\fP \fIhello\fP
+ With the option \fB\-G\fP,
+texprofile
+will map each time stamp
+either to file input or to a macro body.
+The table shown is divided into several sections, the first section
+is devoted to file input, each of the following sections is devoted
+to a specific macro.
+.br
+Each section starts with a header. The header of the
+first section is ``File\&'' the header of a later section is the macro name.
+.br
+The first line after the header gives the total time spent in the section
+in two different formats:
+.RS
+.TP
+1. time
+Column 1 gives it as an absolut time.
+.TP
+3. percentage
+Column 3 gives it as a percentage of the total time measured.
+.RE
+.RS
+.PP
+For the first section with the header ``File\&'', the absolute time
+will be equal to the total time measured because texprof
+did spent all the time processing the file \fIhello\fP\&.
+And consequently the value in column 3 will be 100%\&.
+.br
+To accomplish a task, a macro usually calls other
+macros that we call child macros in the following.
+The following lines in the table will give a breakdown
+of the time shown in the first line.
+The breakdown starts with a line showing the time spent in the section
+excluding the time spent in child macros. It shows in column 4 the number
+of times the macro was called.
+.RS
+.RE
+.TP
+1. time
+Column 1 gives the absolut time spent in the section excluding the time
+spent in child macros
+.TP
+3. percentage
+Column 3 gives the time from column 1 as a percentage of the total time
+spent in this section as given in the previous line.
+.TP
+4. count/total
+Column 4 gives the number of times the section was called.
+.RE
+.RS
+.PP
+The lines that follow in the table show the time spent in one of
+the child macros. Column 2, 4, and 5 need some explanation.
+.RS
+.RE
+.TP
+2. loop
+The only case where column 2 is not empty is the case of a
+recursive macro. A recursive macro is a macro that along the
+chain of macro calls eventually calls itself creating a
+recursive loop. At this point, a macro becomesits own descendant
+and at the same time its own ancestor.
+.br
+Therefore texprofile
+maintains for each child macro two
+accumulators for the elapsed time: For the time shown in
+column 2 labeled ``loop\&'', texprofile
+adds up the time
+differences observed at the return of a child macro. For the
+time shown in the column labeled ``time\&'' and ``percent\&'', it
+subtracts from the time differences observed at the return of a
+child macro all those time differences that were already added
+to one of the other lines in the time breakdown: the macro itself
+or one of the other child macros.
+So the times shown in column 1 of line 2 and the following lines
+will add up to the time shown in column 1 of the line 1;
+and the percentages shown in column 3 of line 2 and the following lines
+will add up to 100%\&.
+The time shown in column 3 will show show the total time needed
+to accomplish the sub task assigned to the respective child macro.
+.TP
+4. count/total
+Column 4 shows two counts n/m for the macro named in column 5.
+m is the total number of calls to the macro and n is the number of
+calls as a child macro in the current section. The number n will
+always be less or equal to m\&.
+.RS
+.PP
+.RE
+.TP
+5. child
+Column 5 shows the name of the child macro as explained above.
+.RE
+.RS
+.PP
+.RE
+.TP
+texprofile \fB\-G\fP \fB\-m\fP \fIhello\fP
+ This table will contain the same data as the previous example
+but this time the \fB\-m\fP
+option will optimize the output for
+machine readability.
+.RS
+.TP
+.B *
+There are no column headers.
+.TP
+.B *
+The times in column 1 ``time\&'' and column 2 ``loop\&''
+are given in nanoseconds without a unit identifier.
+.TP
+.B *
+The numbers n/m in column 4 are now shown in two separate
+columns 4 and 5; the macro name moves from column 5 to column 6.
+.RE
+.RS
+.PP
+.RE
+.TP
+texprofile \fB\-F\fP \fIhello\fP
+ With the option \fB\-F\fP,
+texprofile
+outputs the table
+of all of TeX\&'s input files using 5 columns:
+.RS
+.TP
+1. file
+The file number as explained above.
+.TP
+2. lines
+The difference between the highest and the lowest
+line number found in the profile data for this file. This is
+usually only a subset of all the lines of the file.
+.TP
+3. percent
+The percentage of the total time measured that is attibuted to the file.
+.TP
+4. time
+The absolute time that is attibuted to the file.
+.TP
+5. name
+The full file name of the file.
+.RE
+.RS
+.PP
+.RE
+.TP
+texprofile \fB\-C\fP \fIhello\fP
+ With the option \fB\-C\fP,
+texprofile
+outputs the table
+of all TeX commands executed while profiling
+using 6 columns:
+.RS
+.TP
+1. cmd
+The command code used internaly by TeX.
+Usually the same number is used by TeX for several
+closely related tasks.
+There is a special command code 101 which is used to
+for the time that is spend on system routines that are
+mapped to the system file as explained above.
+.TP
+2. time
+The total time used for the command.
+.TP
+3. percent
+The percentage of the total time measured used for the command.
+.TP
+4. count
+The number of times this command was executed.
+.TP
+5. average
+The average time needed to execute the command.
+This is simpy the value in column 2 divided by the value in column 4.
+.TP
+6. name
+A verbal description of the command or commands that share this
+command code.
+.RE
+.RS
+.PP
+.RE
+.TP
+texprofile \fB\-R\fP \fB\-m\fP \fB\-n\fP \fIhello\fP
+ With the options \fB\-R\fP
+\fB\-m\fP,
+texprofile
+outputs the table
+of raw time measurements as observed by texprof
+optimized for machine
+readability. The option \fB\-n\fP
+adds a column for the number
+of each time measurements.
+Because of the \fB\-m\fP
+option, the table has no column headers.
+The table has 7 columns:
+.RS
+.TP
+1. number
+The number of the time measurment.
+These numbers are strictly increasing but not necessarily consecutive.
+They can be used to keep the measurements sorted in the order in which
+they were made.
+.TP
+2. file
+The file number as explained above.
+.TP
+3. line
+The line number as explained above.
+.TP
+4. time
+The time interval in nano seconds.
+.TP
+5. command
+The command name as given in column 6 of the previous example.
+.TP
+6. level
+The nesting level of the macro call stack.
+.TP
+7. macro
+The macro name.
+.RE
+.RS
+.PP
+This table contains all the timing information gathered during the run
+of texprof\&.
+Some information about macro calls is contained in
+column 6. More information about macro calls could be added
+by using the \fB\-s\fP
+option. The information about macro returns
+can be obtained from column 6.
+The table can be imported to a spread\-sheet or a database for further
+analysis.
+.RE
+.PP
+.SH BUGS
+
+If the last command in a macro body is a macro call, we call this a tail call.
+If such a tail call reads ahead to scan the following input
+for possible arguments, the look\-ahead mechaism of TeX might push further
+macros or new input files on TeX\&'s input stack.
+These entries will remain on top of TeXprof\&'s macro nesting stack,
+even if TeX backs up all these tokens on its input stack.
+This can cause an attribution of runtime to those entries as sub entries
+of the tail call. If this explanation sounds complicated to you, it is
+because the situation is indeed complicated.
+.PP
+.SH SEE ALSO
+
+\fItexprof\fP(1)
+.PP
+.SH VERSION
+
+Version: 1.1 of 28-1-2025
+.TP
+Copyright
+(C)2024, Martin Ruckert,
+.br
+Hochschule München, Lothstrasse 64, D\-80335 München
+.PP
+.TP
+Distribution
+texprofile
+is distributed with TeX Live.
+More recent versions might be found on GitHub
+\fBhttps://github.com/ruckertm/HINT\fP\&.
+.PP
+.TP
+License
+This program can be redistributed and/or modified under the
+terms of the MIT/X11 license.
+.PP
+.SH AUTHOR
+
+Martin Ruckert
+.br
+Munich University of Applied Sciences
+.br
+Email: \fBmartin.ruckert at hm.edu\fP
+.br
+.PP
+.\" NOTE: This file is generated, DO NOT EDIT.
Property changes on: trunk/Master/texmf-dist/doc/man/man1/texprofile.1
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf 2025-02-10 18:36:39 UTC (rev 73848)
Property changes on: trunk/Master/texmf-dist/doc/man/man1/texprofile.man1.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Modified: trunk/Master/texmf-dist/doc/man/man1/tftopl.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/tftopl.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/tftopl.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TFTOPL 1 "16 June 2015" "Web2C 2024"
+.TH TFTOPL 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
Modified: trunk/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/tie.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/tie.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/tie.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TIE 1 "30 August 2022" "Web2C 2024"
+.TH TIE 1 "30 August 2022" "Web2C 2025"
.\"=====================================================================
.SH NAME
tie \- merge or apply WEB change files
Modified: trunk/Master/texmf-dist/doc/man/man1/tie.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/ttf2afm.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/ttf2afm.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/ttf2afm.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TTF2AFM 1 "8 March 2022" "Web2C 2024"
+.TH TTF2AFM 1 "8 March 2022" "Web2C 2025"
.PP
.SH "NAME"
ttf2afm \- utility to generate AFM files for TrueType fonts
Modified: trunk/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/twill-refsort.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/twill.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/twill.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/twill.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH TWILL 1 "16 February 2024" "Web2C 2024"
+.TH TWILL 1 "20 March 2024" "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -57,7 +57,9 @@
.PP
There are several macros that probably should be redefined by
the programmer at the beginning of the \*(WB file.
-It is a good idea to set \\title to the name of the program.
+It is a good idea to set
+.I \etitle
+to the name of the program.
.PP
.B twill
is exactly like
Modified: trunk/Master/texmf-dist/doc/man/man1/twill.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/upbibtex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/uplatex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/uplatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/uptex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/vftovp.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/vftovp.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/vftovp.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH VFTOVP 1 "16 June 2015" "Web2C 2024"
+.TH VFTOVP 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/vptovf.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/vptovf.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/vptovf.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH VPTOVF 1 "16 June 2015" "Web2C 2024"
+.TH VPTOVF 1 "16 June 2015" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/weave.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/weave.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/weave.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH WEAVE 1 "13 October 2023" "Web2C 2024"
+.TH WEAVE 1 "20 March 2024 "Web2C 2025"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -58,11 +58,12 @@
There are several macros
that probably should be redefined by
the programmer at the beginning of the \*(WB file.
-It is a good idea to set \\title
+It is a good idea to set
+.I \etitle
to the name of the program.
And, to cause output of only changed modules, one can say
-\\let\\maybe=\\iffalse (usually as the first change in the
-change file).
+.I \elet\emaybe=\eiffalse
+(usually as the first change in the change file).
.\"=====================================================================
.SH ENVIRONMENT
The environment variable WEBINPUTS is used to search for the input files,
Modified: trunk/Master/texmf-dist/doc/man/man1/weave.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/xelatex-dev.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/xelatex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/xetex.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/xetex.1 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/man/man1/xetex.1 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,4 +1,4 @@
-.TH XETEX 1 "10 July 2018" "Web2C 2024"
+.TH XETEX 1 "10 July 2018" "Web2C 2025"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
Modified: trunk/Master/texmf-dist/doc/man/man1/xetex.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
===================================================================
--- trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,11 +1,11 @@
<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the TeX Live build system and more.
-Copyright © 2016-2024 Karl Berry.
+Copyright © 2016-2025 Karl Berry.
Copyright © 2013-2015 Karl Berry & Peter Breitenlohner.
@@ -23,10 +23,10 @@
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the TeX Users Group. -->
-<title>Building TeX Live (2024)</title>
+<title>Building TeX Live (2025)</title>
-<meta name="description" content="Building TeX Live (2024)">
-<meta name="keywords" content="Building TeX Live (2024)">
+<meta name="description" content="Building TeX Live (2025)">
+<meta name="keywords" content="Building TeX Live (2025)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -75,73 +75,73 @@
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h1 class="top" id="Building-TeX-Live-_00282024_0029"><span>Building TeX Live (2024)<a class="copiable-link" href="#Building-TeX-Live-_00282024_0029"> ¶</a></span></h1>
+<h1 class="top" id="Building-TeX-Live-_00282025_0029"><span>Building TeX Live (2025)<a class="copiable-link" href="#Building-TeX-Live-_00282025_0029"> ¶</a></span></h1>
<p>For an overview of this manual, see <a class="pxref" href="#Introduction">Introduction</a>.
</p>
-<div class="element-shortcontents" id="SEC_Shortcontents">
+<div class="region-shortcontents" id="SEC_Shortcontents">
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="toc-numbered-mark">
-<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
-<li><a id="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li>
-<li><a id="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li>
-<li><a id="stoc-Building-1" href="#toc-Building-1">4 Building</a></li>
-<li><a id="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
-<li><a id="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
-<li><a id="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
-<li><a id="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
-<li><a id="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
-<li><a id="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
-<li><a id="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
-<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li>
+<li><a id="stoc-Introduction" href="#toc-Introduction">1 Introduction</a></li>
+<li><a id="stoc-Overview-of-build-system" href="#toc-Overview-of-build-system">2 Overview of build system</a></li>
+<li><a id="stoc-Prerequisites" href="#toc-Prerequisites">3 Prerequisites</a></li>
+<li><a id="stoc-Building" href="#toc-Building">4 Building</a></li>
+<li><a id="stoc-Installing" href="#toc-Installing">5 Installing</a></li>
+<li><a id="stoc-Layout-and-infrastructure" href="#toc-Layout-and-infrastructure">6 Layout and infrastructure</a></li>
+<li><a id="stoc-Configure-options" href="#toc-Configure-options">7 Configure options</a></li>
+<li><a id="stoc-Coding-conventions" href="#toc-Coding-conventions">8 Coding conventions</a></li>
+<li><a id="stoc-Continuous-integration" href="#toc-Continuous-integration">9 Continuous integration</a></li>
+<li><a id="stoc-install_002dtl" href="#toc-install_002dtl">Appendix A install-tl</a></li>
+<li><a id="stoc-tlmgr" href="#toc-tlmgr">Appendix B tlmgr</a></li>
+<li><a id="stoc-Index" href="#toc-Index" rel="index">Index</a></li>
</ul>
</div>
</div>
-<div class="element-contents" id="SEC_Contents">
+<div class="region-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="toc-numbered-mark">
- <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a id="toc-Overview-of-build-system-1" href="#Overview-of-build-system">2 Overview of build system</a></li>
- <li><a id="toc-Prerequisites-1" href="#Prerequisites">3 Prerequisites</a></li>
- <li><a id="toc-Building-1" href="#Building">4 Building</a>
+ <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Overview-of-build-system" href="#Overview-of-build-system">2 Overview of build system</a></li>
+ <li><a id="toc-Prerequisites" href="#Prerequisites">3 Prerequisites</a></li>
+ <li><a id="toc-Building" href="#Building">4 Building</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li>
- <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.2 Build in parallel</a></li>
- <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.3 Build distribution</a></li>
- <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.4 Build one package</a></li>
- <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.5 Build one engine</a></li>
- <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a>
+ <li><a id="toc-Build-iteration" href="#Build-iteration">4.1 Build iteration</a></li>
+ <li><a id="toc-Build-in-parallel" href="#Build-in-parallel">4.2 Build in parallel</a></li>
+ <li><a id="toc-Build-distribution" href="#Build-distribution">4.3 Build distribution</a></li>
+ <li><a id="toc-Build-one-package" href="#Build-one-package">4.4 Build one package</a></li>
+ <li><a id="toc-Build-one-engine" href="#Build-one-engine">4.5 Build one engine</a></li>
+ <li><a id="toc-Cross-compilation" href="#Cross-compilation">4.6 Cross compilation</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
- <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li>
+ <li><a id="toc-Cross-configuring" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
+ <li><a id="toc-Cross-problems" href="#Cross-problems">4.6.2 Cross problems</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Installing-1" href="#Installing">5 Installing</a>
+ <li><a id="toc-Installing" href="#Installing">5 Installing</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Installation-directories-1" href="#Installation-directories">5.1 Installation directories</a></li>
- <li><a id="toc-Linked-scripts-1" href="#Linked-scripts">5.2 Linked scripts</a></li>
- <li><a id="toc-Distro-builds-1" href="#Distro-builds">5.3 Distro builds</a></li>
+ <li><a id="toc-Installation-directories" href="#Installation-directories">5.1 Installation directories</a></li>
+ <li><a id="toc-Linked-scripts" href="#Linked-scripts">5.2 Linked scripts</a></li>
+ <li><a id="toc-Distro-builds" href="#Distro-builds">5.3 Distro builds</a></li>
</ul></li>
- <li><a id="toc-Layout-and-infrastructure-1" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
+ <li><a id="toc-Layout-and-infrastructure" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Build-system-tools-1" href="#Build-system-tools">6.1 Build system tools</a></li>
- <li><a id="toc-Top_002dlevel-directories-1" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
- <li><a id="toc-Autoconf-macros-1" href="#Autoconf-macros">6.3 Autoconf macros</a>
+ <li><a id="toc-Build-system-tools" href="#Build-system-tools">6.1 Build system tools</a></li>
+ <li><a id="toc-Top_002dlevel-directories" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
+ <li><a id="toc-Autoconf-macros" href="#Autoconf-macros">6.3 Autoconf macros</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-General-setup-macros-1" href="#General-setup-macros">6.3.1 General setup macros</a></li>
- <li><a id="toc-Macros-for-programs-1" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
- <li><a id="toc-Macros-for-compilers-1" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
- <li><a id="toc-Macros-for-libraries-1" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
- <li><a id="toc-Macros-for-library-and-header-flags-1" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
- <li><a id="toc-Macros-for-Windows-1" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
+ <li><a id="toc-General-setup-macros" href="#General-setup-macros">6.3.1 General setup macros</a></li>
+ <li><a id="toc-Macros-for-programs" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
+ <li><a id="toc-Macros-for-compilers" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
+ <li><a id="toc-Macros-for-libraries" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
+ <li><a id="toc-Macros-for-library-and-header-flags" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
+ <li><a id="toc-Macros-for-Windows" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
</ul></li>
- <li><a id="toc-Library-modules-1" href="#Library-modules">6.4 Library modules</a>
+ <li><a id="toc-Library-modules" href="#Library-modules">6.4 Library modules</a>
<ul class="toc-numbered-mark">
<li><a id="toc-The-png-library-in-libs_002flibpng" href="#png-library">6.4.1 The <code class="code">png</code> library in <samp class="file">libs/libpng</samp></a></li>
<li><a id="toc-The-zlib-library-in-libs_002fzlib" href="#zlib-library">6.4.2 The <code class="code">zlib</code> library in <samp class="file">libs/zlib</samp></a></li>
@@ -148,7 +148,7 @@
<li><a id="toc-The-freetype-library-in-libs_002ffreetype2" href="#freetype-library">6.4.3 The <code class="code">freetype</code> library in <samp class="file">libs/freetype2</samp></a></li>
<li><a id="toc-The-kpathsea-library-in-texk_002fkpathsea" href="#kpathsea-library">6.4.4 The <code class="code">kpathsea</code> library in <samp class="file">texk/kpathsea</samp></a></li>
</ul></li>
- <li><a id="toc-Program-modules-1" href="#Program-modules">6.5 Program modules</a>
+ <li><a id="toc-Program-modules" href="#Program-modules">6.5 Program modules</a>
<ul class="toc-numbered-mark">
<li><a id="toc-The-t1utils-package-in-utils_002ft1utils" href="#t1utils-package">6.5.1 The <code class="code">t1utils</code> package in <samp class="file">utils/t1utils</samp></a></li>
<li><a id="toc-The-xindy-package-in-utils_002fxindy" href="#xindy-package">6.5.2 The <code class="code">xindy</code> package in <samp class="file">utils/xindy</samp></a></li>
@@ -155,82 +155,82 @@
<li><a id="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code class="code">xdvik</code> package in <samp class="file">texk/xdvik</samp></a></li>
<li><a id="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp class="file">utils/asymptote</samp></a></li>
</ul></li>
- <li><a id="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a>
+ <li><a id="toc-Extending-TeX-Live" href="#Extending-TeX-Live">6.6 Extending TeX Live</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
- <li><a id="toc-Adding-a-new-engine-1" href="#Adding-a-new-engine">6.6.2 Adding a new engine</a></li>
- <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.3 Adding a new generic library module</a></li>
- <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.4 Adding a new TeX-specific library module</a></li>
+ <li><a id="toc-Adding-a-new-program-module" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
+ <li><a id="toc-Adding-a-new-engine" href="#Adding-a-new-engine">6.6.2 Adding a new engine</a></li>
+ <li><a id="toc-Adding-a-new-generic-library-module" href="#Adding-a-new-generic-library-module">6.6.3 Adding a new generic library module</a></li>
+ <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.4 Adding a new TeX-specific library module</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
+ <li><a id="toc-Configure-options" href="#Configure-options">7 Configure options</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Global-configure-options-1" href="#Global-configure-options">7.1 Global configure options</a>
+ <li><a id="toc-Global-configure-options" href="#Global-configure-options">7.1 Global configure options</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild-1" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code class="code">--disable-native-texlive-build</code></a></li>
- <li><a id="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_2026" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code class="code">--prefix</code>, <code class="code">--bindir</code>, …</a></li>
- <li><a id="toc-_002d_002ddisable_002dlargefile-1" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code class="code">--disable-largefile</code></a></li>
- <li><a id="toc-_002d_002ddisable_002dmissing-1" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code class="code">--disable-missing</code></a></li>
- <li><a id="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel-1" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code class="code">--enable-compiler-warnings=</code><var class="var">level</var></a></li>
- <li><a id="toc-_002d_002denable_002dcxx_002druntime_002dhack-1" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code class="code">--enable-cxx-runtime-hack</code></a></li>
- <li><a id="toc-_002d_002denable_002dmaintainer_002dmode-1" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code class="code">--enable-maintainer-mode</code></a></li>
- <li><a id="toc-_002d_002denable_002dmultiplatform-1" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code class="code">--enable-multiplatform</code></a></li>
- <li><a id="toc-_002d_002denable_002dshared-1" href="#g_t_002d_002denable_002dshared">7.1.9 <code class="code">--enable-shared</code></a></li>
- <li><a id="toc-_002d_002denable_002dsilent_002drules-1" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code class="code">--enable-silent-rules</code></a></li>
- <li><a id="toc-_002d_002dwithout_002dln_002ds-1" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code class="code">--without-ln-s</code></a></li>
- <li><a id="toc-_002d_002dwithout_002dx-1" href="#g_t_002d_002dwithout_002dx">7.1.12 <code class="code">--without-x</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code class="code">--disable-native-texlive-build</code></a></li>
+ <li><a id="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_002e_002e_002e" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code class="code">--prefix</code>, <code class="code">--bindir</code>, …</a></li>
+ <li><a id="toc-_002d_002ddisable_002dlargefile" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code class="code">--disable-largefile</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dmissing" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code class="code">--disable-missing</code></a></li>
+ <li><a id="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code class="code">--enable-compiler-warnings=</code><var class="var">level</var></a></li>
+ <li><a id="toc-_002d_002denable_002dcxx_002druntime_002dhack" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code class="code">--enable-cxx-runtime-hack</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmaintainer_002dmode" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code class="code">--enable-maintainer-mode</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmultiplatform" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code class="code">--enable-multiplatform</code></a></li>
+ <li><a id="toc-_002d_002denable_002dshared" href="#g_t_002d_002denable_002dshared">7.1.9 <code class="code">--enable-shared</code></a></li>
+ <li><a id="toc-_002d_002denable_002dsilent_002drules" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code class="code">--enable-silent-rules</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dln_002ds" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code class="code">--without-ln-s</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dx" href="#g_t_002d_002dwithout_002dx">7.1.12 <code class="code">--without-x</code></a></li>
</ul></li>
- <li><a id="toc-Program_002dspecific-configure-options-1" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
+ <li><a id="toc-Program_002dspecific-configure-options" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
<ul class="toc-numbered-mark">
<li><a id="toc-_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog" href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">7.2.1 <code class="code">--enable-<var class="var">prog</var></code>, <code class="code">--disable-<var class="var">prog</var></code></a></li>
- <li><a id="toc-_002d_002ddisable_002dall_002dpkgs-1" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code class="code">--disable-all-pkgs</code></a></li>
- <li><a id="toc-Configure-options-for-texk_002fweb2c-1" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp class="file">texk/web2c</samp></a></li>
- <li><a id="toc-Configure-options-for-texk_002fbibtex_002dx-1" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp class="file">texk/bibtex-x</samp></a></li>
- <li><a id="toc-Configure-options-for-texk_002fdvipdfm_002dx-1" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp class="file">texk/dvipdfm-x</samp></a></li>
- <li><a id="toc-Configure-options-for-texk_002fdvisvgm-1" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp class="file">texk/dvisvgm</samp></a></li>
- <li><a id="toc-Configure-options-for-texk_002ftexlive-1" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp class="file">texk/texlive</samp></a></li>
- <li><a id="toc-Configure-options-for-texk_002fxdvik-1" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp class="file">texk/xdvik</samp></a></li>
- <li><a id="toc-Configure-options-for-utils_002fxindy-1" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp class="file">utils/xindy</samp></a></li>
+ <li><a id="toc-_002d_002ddisable_002dall_002dpkgs" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code class="code">--disable-all-pkgs</code></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fweb2c" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp class="file">texk/web2c</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fbibtex_002dx" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp class="file">texk/bibtex-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvipdfm_002dx" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp class="file">texk/dvipdfm-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvisvgm" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp class="file">texk/dvisvgm</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002ftexlive" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp class="file">texk/texlive</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fxdvik" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp class="file">texk/xdvik</samp></a></li>
+ <li><a id="toc-Configure-options-for-utils_002fxindy" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp class="file">utils/xindy</samp></a></li>
</ul></li>
- <li><a id="toc-Library_002dspecific-configure-options-1" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
+ <li><a id="toc-Library_002dspecific-configure-options" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Configure-options-for-kpathsea-1" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code class="code">kpathsea</code></a></li>
+ <li><a id="toc-Configure-options-for-kpathsea" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code class="code">kpathsea</code></a></li>
</ul></li>
- <li><a id="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
+ <li><a id="toc-Variables-for-configure" href="#Variables-for-configure">7.4 Variables for configure</a></li>
</ul></li>
- <li><a id="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
+ <li><a id="toc-Coding-conventions" href="#Coding-conventions">8 Coding conventions</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
- <li><a id="toc-Const-1" href="#Const">8.2 Const</a></li>
+ <li><a id="toc-Declarations-and-definitions" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
+ <li><a id="toc-Const" href="#Const">8.2 Const</a></li>
</ul></li>
- <li><a id="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
+ <li><a id="toc-Continuous-integration" href="#Continuous-integration">9 Continuous integration</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
- <li><a id="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
- <li><a id="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
- <li><a id="toc-Releases-on-Github-1" href="#Releases-on-Github">9.4 Releases on Github</a></li>
+ <li><a id="toc-Transfer-from-Subversion-to-Github" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
+ <li><a id="toc-Automatic-update-of-the-Git-mirror" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
+ <li><a id="toc-CI-testing-on-Travis_002dCI" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
+ <li><a id="toc-Releases-on-Github" href="#Releases-on-Github">9.4 Releases on Github</a></li>
</ul></li>
- <li><a id="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
+ <li><a id="toc-install_002dtl" href="#install_002dtl">Appendix A install-tl</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-install_002dtl-NAME-1" href="#install_002dtl-NAME">A.1 install-tl NAME</a></li>
- <li><a id="toc-install_002dtl-SYNOPSIS-1" href="#install_002dtl-SYNOPSIS">A.2 install-tl SYNOPSIS</a></li>
- <li><a id="toc-install_002dtl-DESCRIPTION-1" href="#install_002dtl-DESCRIPTION">A.3 install-tl DESCRIPTION</a></li>
+ <li><a id="toc-install_002dtl-NAME" href="#install_002dtl-NAME">A.1 install-tl NAME</a></li>
+ <li><a id="toc-install_002dtl-SYNOPSIS" href="#install_002dtl-SYNOPSIS">A.2 install-tl SYNOPSIS</a></li>
+ <li><a id="toc-install_002dtl-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 install-tl DESCRIPTION</a></li>
<li><a id="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
- <li><a id="toc-install_002dtl-EXAMPLES-1" href="#install_002dtl-EXAMPLES">A.5 install-tl EXAMPLES</a></li>
- <li><a id="toc-install_002dtl-OPTIONS-1" href="#install_002dtl-OPTIONS">A.6 install-tl OPTIONS</a></li>
+ <li><a id="toc-install_002dtl-EXAMPLES" href="#install_002dtl-EXAMPLES">A.5 install-tl EXAMPLES</a></li>
+ <li><a id="toc-install_002dtl-OPTIONS" href="#install_002dtl-OPTIONS">A.6 install-tl OPTIONS</a></li>
<li><a id="toc-PROFILES" href="#install_002dtl-PROFILES">A.7 PROFILES</a></li>
<li><a id="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.8 ENVIRONMENT VARIABLES</a></li>
<li><a id="toc-DIRECTORY-TREES" href="#install_002dtl-DIRECTORY-TREES">A.9 DIRECTORY TREES</a></li>
- <li><a id="toc-install_002dtl-BUGS-1" href="#install_002dtl-BUGS">A.10 install-tl BUGS</a></li>
+ <li><a id="toc-install_002dtl-BUGS" href="#install_002dtl-BUGS">A.10 install-tl BUGS</a></li>
<li><a id="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.11 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a id="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
+ <li><a id="toc-tlmgr" href="#tlmgr">Appendix B tlmgr</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-tlmgr-NAME-1" href="#tlmgr-NAME">B.1 tlmgr NAME</a></li>
- <li><a id="toc-tlmgr-SYNOPSIS-1" href="#tlmgr-SYNOPSIS">B.2 tlmgr SYNOPSIS</a></li>
- <li><a id="toc-tlmgr-DESCRIPTION-1" href="#tlmgr-DESCRIPTION">B.3 tlmgr DESCRIPTION</a></li>
- <li><a id="toc-tlmgr-EXAMPLES-1" href="#tlmgr-EXAMPLES">B.4 tlmgr EXAMPLES</a></li>
- <li><a id="toc-tlmgr-OPTIONS-1" href="#tlmgr-OPTIONS">B.5 tlmgr OPTIONS</a></li>
+ <li><a id="toc-tlmgr-NAME" href="#tlmgr-NAME">B.1 tlmgr NAME</a></li>
+ <li><a id="toc-tlmgr-SYNOPSIS" href="#tlmgr-SYNOPSIS">B.2 tlmgr SYNOPSIS</a></li>
+ <li><a id="toc-tlmgr-DESCRIPTION" href="#tlmgr-DESCRIPTION">B.3 tlmgr DESCRIPTION</a></li>
+ <li><a id="toc-tlmgr-EXAMPLES" href="#tlmgr-EXAMPLES">B.4 tlmgr EXAMPLES</a></li>
+ <li><a id="toc-tlmgr-OPTIONS" href="#tlmgr-OPTIONS">B.5 tlmgr OPTIONS</a></li>
<li><a id="toc-ACTIONS" href="#tlmgr-ACTIONS">B.6 ACTIONS</a>
<ul class="toc-numbered-mark">
<li><a id="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
@@ -299,9 +299,8 @@
</ul></li>
<li><a id="toc-ENVIRONMENT-VARIABLES-1" href="#tlmgr-ENVIRONMENT-VARIABLES">B.13 ENVIRONMENT VARIABLES</a></li>
<li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.14 AUTHORS AND COPYRIGHT</a></li>
- <li><a id="toc-POD-ERRORS" href="#tlmgr-POD-ERRORS">B.15 POD ERRORS</a></li>
</ul></li>
- <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
+ <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
</ul>
</div>
</div>
@@ -309,14 +308,14 @@
<div class="chapter-level-extent" id="Introduction">
<div class="nav-panel">
<p>
-Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Building TeX Live (2024)</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Building TeX Live (2025)</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Introduction-1"><span>1 Introduction<a class="copiable-link" href="#Introduction-1"> ¶</a></span></h2>
<a class="index-entry-id" id="index-introduction"></a>
-<p>This manual (dated March 2024) corresponds to the TeX Live
-2024 release.
+<p>This manual (dated January 2025) corresponds to the TeX Live
+2025 release.
</p>
<p>This manual is aimed at system installers and programmers, and focuses
on how to configure, build, and develop the TeX Live (TL) sources. It is
@@ -367,7 +366,7 @@
<div class="chapter-level-extent" id="Overview-of-build-system">
<div class="nav-panel">
<p>
-Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Overview-of-build-system-1"><span>2 Overview of build system<a class="copiable-link" href="#Overview-of-build-system-1"> ¶</a></span></h2>
@@ -435,7 +434,7 @@
<div class="chapter-level-extent" id="Prerequisites">
<div class="nav-panel">
<p>
-Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Prerequisites-1"><span>3 Prerequisites<a class="copiable-link" href="#Prerequisites-1"> ¶</a></span></h2>
@@ -542,7 +541,7 @@
<div class="chapter-level-extent" id="Building">
<div class="nav-panel">
<p>
-Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Building-1"><span>4 Building<a class="copiable-link" href="#Building-1"> ¶</a></span></h2>
@@ -657,17 +656,22 @@
<a class="index-entry-id" id="index-distribution-tarball_002c-making"></a>
<a class="index-entry-id" id="index-dist-and-distcheck-targets-for-make"></a>
-<p>Running <code class="code">make dist</code> at the top level creates a tarball
+<p>Running <code class="code">make dist</code> or related targets at the top level outputs an
+error message and fails. We no longer try to keep <code class="code">make dist</code>
+working, although it could be restored if there is some use for it.
+</p>
+<p>The <code class="code">dist</code> target used to create a tarball
<samp class="file">tex-live-<var class="var">yyyy</var>-<var class="var">mm</var>-<var class="var">dd</var>.tar.xz</samp> from the TL source
-tree. Running <code class="code">make distcheck</code> also verifies that this tarball
-suffices to build and install all of TL.
+tree, and <code class="code">distcheck</code> also verifies that this tarball suffices to
+build and install all of TL.
</p>
-<p>This is useful for checking consistency of the source tree and
-Makefiles, but the result is not a complete or even usable TeX
-system, since all the support files are lacking; see <a class="pxref" href="#Installing">Installing</a>.
-We do not actually distribute any such tarball, and have no plans to
-do so.
+<p>However, the result was not a complete or even usable TeX system,
+since all the support files are lacking. We do not actually
+distribute any such tarball, and have no plans to do so.
</p>
+<p>See <a class="xref" href="#Installing">Installing</a>, for more information on what to do with the results
+of a build.
+</p>
<hr>
</div>
<div class="section-level-extent" id="Build-one-package">
@@ -992,7 +996,7 @@
few auxiliary C and C++ programs required for the build process as
configure arguments
</p>
-<a class="index-entry-id" id="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></a>
+<a class="index-entry-id" id="index-BUILDCC_002c-BUILDCFLAGS_002c-_002e_002e_002e"></a>
<div class="example">
<pre class="example-preformatted">BUILDCC=...
BUILDCPPFLAGS=...
@@ -1063,7 +1067,7 @@
<div class="chapter-level-extent" id="Installing">
<div class="nav-panel">
<p>
-Next: <a href="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Installing-1"><span>5 Installing<a class="copiable-link" href="#Installing-1"> ¶</a></span></h2>
@@ -1085,8 +1089,9 @@
is the TeX Live (plain text) database in
<samp class="file">Master/tlpkg/texlive.tlpdb</samp>, and/or the TeX Live installer,
<code class="code">install-tl</code>. More information is under <samp class="file">Master/tlpkg</samp> and
-at <a class="url" href="https://tug.org/texlive/distro.html">https://tug.org/texlive/distro.html</a>.
-</p>
+at <a class="url" href="https://tug.org/texlive/distro.html">https://tug.org/texlive/distro.html</a> and
+ <a class="url" href="https://tug.org/texlive/build.html#deploy">https://tug.org/texlive/build.html#deploy</a>.
+</p>
<ul class="mini-toc">
<li><a href="#Installation-directories" accesskey="1">Installation directories</a></li>
@@ -1164,25 +1169,31 @@
<a class="index-entry-id" id="index-linked-scripts"></a>
<a class="index-entry-id" id="index-scripts_002c-linked-and-not-maintained"></a>
+<a class="index-entry-id" id="index-symbolic-links_002c-used-for-scripts"></a>
<a class="index-entry-id" id="index-symlinks_002c-used-for-scripts"></a>
<a class="index-entry-id" id="index-wrapper-binary-for-scripts-on-Windows"></a>
<a class="index-entry-id" id="index-Windows_002c-invoking-scripts-on"></a>
-<p>Quite a few executables are architecture-independent shell, Perl, or
-other interpreted scripts, rather than compiled binaries. A few are
-maintained as part of the TL source tree, but most are maintained
-elsewhere with copies under <samp class="file">texk/texlive/linked_scripts</samp>.
+<p>Quite a few of the executables in TeX Live are architecture-independent
+shell, Perl, or other interpreted scripts, rather than compiled
+binaries. A few are maintained as part of the TL source tree, but
+most are maintained independently in their own packages, with copies
+under <samp class="file">texk/texlive/linked_scripts</samp>.
</p>
<p>These so-called <em class="dfn">linked scripts</em> are installed under
<code class="code"><var class="var">datarootdir</var>/texmf-dist/scripts</code>; for Unix-like systems a
symbolic link is made in <code class="code"><var class="var">bindir</var></code>. For example, a symlink
-points from <code class="code"><var class="var">bindir</var>/ps2eps</code> to
-<code class="code"><var class="var">datarootdir</var>/texmf-dist/scripts/ps2eps/ps2eps.pl</code>. For
-Windows, a standard wrapper binary (copied to, e.g.,
-<code class="code"><var class="var">bindir</var>/ps2eps.exe</code>) serves the same purpose. The source
-for the wrapper is in <samp class="file">texk/texlive/windows_wrapper</samp>.
+points from <code class="code"><var class="var">bindir</var>/fmtutil</code> to
+<code class="code"><var class="var">datarootdir</var>/texmf-dist/scripts/texlive/fmtutil.pl</code>. The
+symlink is relative, so the installation root can be anywhere.
</p>
-<p>One reason for this is to avoid having many copies of the same
+<a class="index-entry-id" id="index-wrapper-for-scripts_002c-on-Windows"></a>
+<p>For Windows, we cannot portably use symlinks, so a standard wrapper
+binary (copied to, e.g., <code class="code"><var class="var">bindir</var>/fmtutil.exe</code>) serves the
+same purpose (the source for the wrapper is in
+<samp class="file">texk/texlive/windows_wrapper</samp>).
+</p>
+<p>One reason for all this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
</p>
@@ -1192,13 +1203,39 @@
<a class="index-entry-id" id="index-xz"></a>
<a class="index-entry-id" id="index-wget"></a>
<p>Most important of all, we want the <code class="code"><var class="var">bindir</var></code> resulting from
-the build to be as close as possible to what is in the TL
-distribution. At present, there are a few exceptions—Asymptote,
-Biber, Xindy—and each one creates considerable extra work. We don’t
-want to add more. (See <a class="url" href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a> for
-information about building those exceptions, as well as the <code class="code">xz</code>
-and <code class="code">wget</code> programs that are used in the TL infrastructure.)
+<code class="code">make install</code> in the TL source tree to be as close as possible
+to what’s in thej TL distribution. At present, there are a few
+exceptions—Asymptote, Biber, Xindy—and each one creates
+considerable extra work. We don’t want to add more. (See
+<a class="url" href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a> for information about
+building those exceptions, as well as the <code class="code">xz</code> and <code class="code">wget</code>
+programs that are used in the TL infrastructure.)
</p>
+<a class="index-entry-id" id="index-scripts_002dtargets_002elst"></a>
+<p>As part of the <code class="code">make install</code> in the <samp class="file">linked_scripts</samp>
+directory, a file <samp class="file">scripts-targets.lst</samp> is created to record all
+the links that are created this way, so that distros and others can
+reproduce them. The file has one line per link. The first word is the
+target of the link (e.g.,
+‘<samp class="samp">texmf-dist/scripts/texlive/fmtutil.pl</samp>’), and the second word
+is the name of the link to be placed in the bindir (e.g.,
+‘<samp class="samp">fmtutil</samp>’). Determining the relative link target (how many
+‘<samp class="samp">../</samp>’s) is left to the users of this file, since it varies among
+distributions. It can be assumed there is no whitespace in these filenames.
+</p>
+<p>A few links are within bindir; in that case, the first word of the
+line is just a base name, e.g., the file ‘<samp class="samp">fmtutil mktexfmt</samp>’ means
+that doing the equivalent of <code class="code">ln -s fmtutil mktexfmt</code> in the bindir.
+</p>
+<p>Be aware that although extensions are usually stripped (as with
+<code class="code">fmtutil</code>), there are exceptions, such as
+<code class="code">memoize-extract.pl</code> and <code class="code">listings-ext.sh</code>.
+</p>
+<p>The <samp class="file">scripts-targets.lst</samp> file started being created as of the
+TeX Live 2025 release. Historically, another file <samp class="file">scripts.lst</samp> has
+been (and still is) created, containing only the link targets, and
+using a Bourne shell syntax.
+</p>
<hr>
</div>
<div class="section-level-extent" id="Distro-builds">
@@ -1291,7 +1328,7 @@
<div class="chapter-level-extent" id="Layout-and-infrastructure">
<div class="nav-panel">
<p>
-Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Layout-and-infrastructure-1"><span>6 Layout and infrastructure<a class="copiable-link" href="#Layout-and-infrastructure-1"> ¶</a></span></h2>
@@ -1343,12 +1380,12 @@
</p>
<div class="display">
<pre class="display-preformatted">autoconf (GNU Autoconf) 2.72
-automake (GNU automake) 1.16.5
+automake (GNU automake) 1.17
bison (GNU Bison) 3.8.2
flex 2.6.0
-ltmain.sh (GNU libtool) 2.4.7
+ltmain.sh (GNU libtool) 2.5.4
m4 (GNU M4) 1.4.19
-makeinfo (GNU texinfo) 7.1
+makeinfo (GNU texinfo) 7.2
</pre></div>
<a class="index-entry-id" id="index-reautoconf"></a>
@@ -1421,7 +1458,7 @@
<samp class="file">make</samp> targets such as <code class="code">dist</code> or <code class="code">distcheck</code>.
</p>
<a class="index-entry-id" id="index-build_002daux_002f-top_002dlevel-directory"></a>
-<a class="index-entry-id" id="index-config_002eguess_002c-config_002esub_002c-_2026"></a>
+<a class="index-entry-id" id="index-config_002eguess_002c-config_002esub_002c-_002e_002e_002e"></a>
<a class="index-entry-id" id="index-Gnulib_002c-used-for-common-files"></a>
<p>The top-level <samp class="file">build-aux/</samp> directory contains the common files
<samp class="file">compile</samp>, <samp class="file">config.guess</samp>, <samp class="file">config.sub</samp>,
@@ -1483,15 +1520,15 @@
<a class="index-entry-id" id="index-macros_002c-general-setup"></a>
<p>The TL sources use two general setup macros:
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fBASIC"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_BASIC</strong> <var class="def-var-arguments">(<var class="var">name</var>, [<var class="var">more-options</var>])</var><a class="copiable-link" href="#index-KPSE_005fBASIC"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fBASIC"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_BASIC</strong> <var class="def-var-arguments">(<var class="var">name</var>, [<var class="var">more-options</var>])</var><a class="copiable-link" href="#index-KPSE_005fBASIC"> ¶</a></span></dt>
<dd><p>Initialize the basic TL infrastructure for module <var class="var">name</var>:<br> <code class="code">AM_INIT_AUTOMAKE([foreign <var class="var">more-options</var>])</code><br> <code class="code">AM_MAINTAINER_MODE</code><br> <code class="code">KPSE_COMPILER_WARNINGS</code><br>
and make sure the C compiler understands function prototypes. This is
used for all generic library and program modules.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOMMON"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMMON</strong> <var class="def-var-arguments">(<var class="var">name</var>, [<var class="var">more-options</var>])</var><a class="copiable-link" href="#index-KPSE_005fCOMMON"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOMMON"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMMON</strong> <var class="def-var-arguments">(<var class="var">name</var>, [<var class="var">more-options</var>])</var><a class="copiable-link" href="#index-KPSE_005fCOMMON"> ¶</a></span></dt>
<dd><p>Like <code class="code">KPSE_BASIC</code> but add:<br> <code class="code">LT_PREREQ([2.2.6])</code><br> <code class="code">LT_INIT([win32-dll])</code><br> <code class="code">AC_SYS_LARGEFILE</code><br> <code class="code">AC_FUNC_FSEEKO</code><br>along with checks for frequently used functions,
headers, types, and structures. This is used for TeX-specific
modules.
@@ -1509,8 +1546,8 @@
<a class="index-entry-id" id="index-macros_002c-for-programs"></a>
<p>Macros for program checks:
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCHECK_005fLATEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_LATEX</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fLATEX"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCHECK_005fLATEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_LATEX</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fLATEX"> ¶</a></span></dt>
<dd><p>Set <code class="code">LATEX</code> to the first of <code class="code">latex</code>, <code class="code">elatex</code>, or
<code class="code">lambda</code> which exists in <code class="code">PATH</code>, or to <code class="code">no</code> if none of
them exists. Call <code class="code">AC_SUBST</code> for <code class="code">LATEX</code>. The result of
@@ -1518,19 +1555,19 @@
variable or the cache variable <code class="code">ac_cv_prog_LATEX</code>.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCHECK_005fPDFLATEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_PDFLATEX</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fPDFLATEX"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCHECK_005fPDFLATEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_PDFLATEX</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fPDFLATEX"> ¶</a></span></dt>
<dd><p>Check for <code class="code">pdflatex</code> in <code class="code">PATH</code> and set <code class="code">PDFLATEX</code>.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCHECK_005fPERL"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_PERL</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fPERL"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCHECK_005fPERL"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_PERL</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fPERL"> ¶</a></span></dt>
<dd><p>Check for <code class="code">perl</code> or <code class="code">perl5</code> in <code class="code">PATH</code> and set
<code class="code">PERL</code>.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fPROG_005fLEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_PROG_LEX</strong><a class="copiable-link" href="#index-KPSE_005fPROG_005fLEX"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fPROG_005fLEX"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_PROG_LEX</strong><a class="copiable-link" href="#index-KPSE_005fPROG_005fLEX"> ¶</a></span></dt>
<dd><p>Call <code class="code">AC_PROG_LEX</code> and add the flag <code class="code">-l</code> for <code class="code">flex</code>.
</p></dd></dl>
@@ -1547,8 +1584,8 @@
<p>Macros for compiler-related checks:
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOMPILER_005fWARNINGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMPILER_WARNINGS</strong><a class="copiable-link" href="#index-KPSE_005fCOMPILER_005fWARNINGS"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOMPILER_005fWARNINGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMPILER_WARNINGS</strong><a class="copiable-link" href="#index-KPSE_005fCOMPILER_005fWARNINGS"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-WARNING_005fC_005bXX_005dFLAGS"></a>
<p>When using the (Objective) C/C++ compiler, set
<code class="code">WARNING_[OBJ]C[XX]FLAGS</code> to suitable warning flags (depending on
@@ -1561,13 +1598,16 @@
… variables.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOMPILER_005fVISIBILITY"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMPILER_VISIBILITY</strong><a class="copiable-link" href="#index-KPSE_005fCOMPILER_005fVISIBILITY"> ¶</a></span></dt>
-<dd><p>When using the C or C++ compiler, try to set
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOMPILER_005fVISIBILITY"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COMPILER_VISIBILITY</strong><a class="copiable-link" href="#index-KPSE_005fCOMPILER_005fVISIBILITY"> ¶</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002dfvisibility_003dhidden"></a>
+<a class="index-entry-id" id="index-_002dfvisibility_002dinlines_002dhidden"></a>
+<p>When using the C or C++ compiler, try to set
<code class="code">VISIBILITY_C[XX]FLAGS</code> to flags to hide external symbols. Call
-<code class="code">AC_SUBST</code> for this variable. At present this only tests for
-the compiler option <code class="code">-fvisibility=hidden</code>, but could be
-extended if necessary.
+<code class="code">AC_SUBST</code> for this variable. This tests for the compiler option
+<code class="code">-fvisibility=hidden</code> and, except for C,
+<code class="code">-fvisibility-inlines-hidden</code>. Reports or patches for additional
+tests are welcome.
</p>
<a class="index-entry-id" id="index-kpse_005fcv_005fvisibility_005fc_005bxx_005dflags"></a>
<p>This macro caches its results in the <code class="code">kpse_cv_visibility_cflags</code>
@@ -1574,8 +1614,8 @@
or <code class="code">kpse_cv_visibility_cxxflags</code> variable.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCXX_005fHACK"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CXX_HACK</strong><a class="copiable-link" href="#index-KPSE_005fCXX_005fHACK"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCXX_005fHACK"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CXX_HACK</strong><a class="copiable-link" href="#index-KPSE_005fCXX_005fHACK"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-static-linking-for-C_002b_002b"></a>
<a class="index-entry-id" id="index-linking-C_002b_002b-libraries-statically"></a>
<a class="index-entry-id" id="index-_002d_002denable_002dcxx_002druntime_002dhack"></a>
@@ -1601,8 +1641,8 @@
<a class="index-entry-id" id="index-macros_002c-for-libraries"></a>
<p>One macro for a library check:
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fLARGEFILE"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_LARGEFILE</strong> <var class="def-var-arguments">(<var class="var">variable</var>, [<var class="var">extra-define</var>])</var><a class="copiable-link" href="#index-KPSE_005fLARGEFILE"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fLARGEFILE"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_LARGEFILE</strong> <var class="def-var-arguments">(<var class="var">variable</var>, [<var class="var">extra-define</var>])</var><a class="copiable-link" href="#index-KPSE_005fLARGEFILE"> ¶</a></span></dt>
<dd><p>Call <code class="code">AC_SYS_LARGEFILE</code> and <code class="code">AC_FUNC_FSEEKO</code> and append
suitable <code class="code">-D</code> flags (optionally including
<code class="code">-D<var class="var">extra-define</var></code>) to <var class="var">variable</var>.
@@ -1625,8 +1665,8 @@
that provides make variables for that library. E.g., for
<samp class="file">libs/libpng</samp>:
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fLIBPNG_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_LIBPNG_FLAGS</strong><a class="copiable-link" href="#index-KPSE_005fLIBPNG_005fFLAGS"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fLIBPNG_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_LIBPNG_FLAGS</strong><a class="copiable-link" href="#index-KPSE_005fLIBPNG_005fFLAGS"> ¶</a></span></dt>
<dd><p>Provide the configure option <code class="code">--with-system-libpng</code>. Set and
<code class="code">AC_SUBST</code> <code class="code">make</code> variables for modules using this library (either
an installed version or from the TeX Live tree):
@@ -1640,14 +1680,14 @@
</table>
</dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fADD_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_ADD_FLAGS</strong> <var class="def-var-arguments">(<var class="var">name</var>)</var><a class="copiable-link" href="#index-KPSE_005fADD_005fFLAGS"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fADD_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_ADD_FLAGS</strong> <var class="def-var-arguments">(<var class="var">name</var>)</var><a class="copiable-link" href="#index-KPSE_005fADD_005fFLAGS"> ¶</a></span></dt>
<dd><p>Temporarily extend <code class="code">CPPFLAGS</code> and <code class="code">LIBS</code> with the values required
for the library module <code class="code"><var class="var">name</var></code>.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fRESTORE_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_RESTORE_FLAGS</strong><a class="copiable-link" href="#index-KPSE_005fRESTORE_005fFLAGS"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fRESTORE_005fFLAGS"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_RESTORE_FLAGS</strong><a class="copiable-link" href="#index-KPSE_005fRESTORE_005fFLAGS"> ¶</a></span></dt>
<dd><p>Restore <code class="code">CPPFLAGS</code> and <code class="code">LIBS</code> to their original values.
</p></dd></dl>
@@ -1696,8 +1736,8 @@
<p>Windows differs in several aspects from Unix-like systems, many of
them due to the lack of symbolic links.
</p>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCHECK_005fWIN32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_WIN32</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fWIN32"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCHECK_005fWIN32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_CHECK_WIN32</strong><a class="copiable-link" href="#index-KPSE_005fCHECK_005fWIN32"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-kpse_005fcv_005fhave_005fwin32"></a>
<p>Check if compiling for a Windows system. The result is either
<code class="code">no</code> for Unix-like systems (including Cygwin), <code class="code">mingw32</code> for
@@ -1705,8 +1745,8 @@
is cached in the <code class="code">kpse_cv_have_win32</code> variable.
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOND_005fWIN32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_WIN32</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fWIN32"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOND_005fWIN32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_WIN32</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fWIN32"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-WIN32_002c-Automake-conditional"></a>
<p>Call <code class="code">KPSE_CHECK_WIN32</code> and define the Automake conditional
<code class="code">WIN32</code> (<code class="code">true</code> if the value of <code class="code">kpse_cv_have_win32</code> is
@@ -1713,8 +1753,8 @@
not <code class="code">no</code>).
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOND_005fMINGW32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_MINGW32</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fMINGW32"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOND_005fMINGW32"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_MINGW32</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fMINGW32"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-MINGW32_002c-Automake-conditional"></a>
<p>Call <code class="code">KPSE_COND_WIN32</code> and define the Automake conditional
<code class="code">MINGW32</code> (<code class="code">true</code> if the value of <code class="code">kpse_cv_have_win32</code> is
@@ -1721,8 +1761,8 @@
<code class="code">mingw32</code>).
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fCOND_005fWIN32_005fWRAP"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_WIN32_WRAP</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fWIN32_005fWRAP"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fCOND_005fWIN32_005fWRAP"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_COND_WIN32_WRAP</strong><a class="copiable-link" href="#index-KPSE_005fCOND_005fWIN32_005fWRAP"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-WIN32_005fWRAP_002c-Automake-conditional"></a>
<a class="index-entry-id" id="index-runscript_002eexe"></a>
<p>Call <code class="code">KPSE_COND_WIN32</code> and define the Automake conditional
@@ -1732,8 +1772,8 @@
(see <a class="pxref" href="#Linked-scripts">Linked scripts</a>).
</p></dd></dl>
-<dl class="first-deffn first-defmac-alias-first-deffn">
-<dt class="deffn defmac-alias-deffn" id="index-KPSE_005fWIN32_005fCALL"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_WIN32_CALL</strong><a class="copiable-link" href="#index-KPSE_005fWIN32_005fCALL"> ¶</a></span></dt>
+<dl class="first-deffn first-defmac-alias-first-deffn def-block">
+<dt class="deffn defmac-alias-deffn def-line" id="index-KPSE_005fWIN32_005fCALL"><span class="category-def">Macro: </span><span><strong class="def-name">KPSE_WIN32_CALL</strong><a class="copiable-link" href="#index-KPSE_005fWIN32_005fCALL"> ¶</a></span></dt>
<dd><a class="index-entry-id" id="index-callexe_002ec"></a>
<p>Call <code class="code">KPSE_COND_WIN32</code> and check if the file
<samp class="file">texk/texlive/windows_wrapper/callexe.c</samp> exists; if it does, create a
@@ -2369,7 +2409,7 @@
<div class="chapter-level-extent" id="Configure-options">
<div class="nav-panel">
<p>
-Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Configure-options-1"><span>7 Configure options<a class="copiable-link" href="#Configure-options-1"> ¶</a></span></h2>
@@ -2466,7 +2506,7 @@
<p>
Next: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="n" rel="next"><code class="code">--disable-largefile</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="p" rel="prev"><code class="code">--disable-native-texlive-build</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<h4 class="subsection" id="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"><span>7.1.2 <code class="code">--prefix</code>, <code class="code">--bindir</code>, …<a class="copiable-link" href="#g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"> ¶</a></span></h4>
+<h4 class="subsection" id="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_002e_002e_002e"><span>7.1.2 <code class="code">--prefix</code>, <code class="code">--bindir</code>, …<a class="copiable-link" href="#g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_002e_002e_002e"> ¶</a></span></h4>
<a class="index-entry-id" id="index-_002d_002dprefix-configure-option"></a>
<a class="index-entry-id" id="index-_002d_002dbindir-configure-option"></a>
@@ -3109,7 +3149,7 @@
<div class="chapter-level-extent" id="Coding-conventions">
<div class="nav-panel">
<p>
-Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Coding-conventions-1"><span>8 Coding conventions<a class="copiable-link" href="#Coding-conventions-1"> ¶</a></span></h2>
@@ -3259,7 +3299,7 @@
<div class="chapter-level-extent" id="Continuous-integration">
<div class="nav-panel">
<p>
-Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Continuous-integration-1"><span>9 Continuous integration<a class="copiable-link" href="#Continuous-integration-1"> ¶</a></span></h2>
@@ -3402,7 +3442,7 @@
<div class="appendix-level-extent" id="install_002dtl">
<div class="nav-panel">
<p>
-Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="appendix" id="install_002dtl-1"><span>Appendix A install-tl<a class="copiable-link" href="#install_002dtl-1"> ¶</a></span></h2>
@@ -4111,8 +4151,11 @@
</dd>
<dt><code class="code">TL_DOWNLOAD_ARGS</code></dt>
<dd><a class="anchor" id="install_002dtl-TL_005fDOWNLOAD_005fARGS"></a>
-<p>These override the normal choice of a download program; see the <code class="code">tlmgr</code>
-documentation, e.g.,
+</dd>
+<dt><code class="code">TEXLIVE_PREFER_OWN</code></dt>
+<dd><a class="anchor" id="install_002dtl-TEXLIVE_005fPREFER_005fOWN"></a>
+<p>These override the normal choice of the download and other utility
+programs; see the <code class="code">tlmgr</code> documentation, e.g.,
<a class="url" href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>.
</p>
</dd>
@@ -4271,7 +4314,7 @@
distribution (<a class="url" href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: install-tl 69711 2024-02-05 17:23:27Z karl $
+<p>$Id: install-tl 73024 2024-12-03 17:12:38Z karl $
</p>
<hr>
</div>
@@ -4279,7 +4322,7 @@
<div class="appendix-level-extent" id="tlmgr">
<div class="nav-panel">
<p>
-Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="appendix" id="tlmgr-1"><span>Appendix B tlmgr<a class="copiable-link" href="#tlmgr-1"> ¶</a></span></h2>
@@ -4298,7 +4341,6 @@
<li><a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a></li>
<li><a href="#tlmgr-ENVIRONMENT-VARIABLES">ENVIRONMENT VARIABLES</a></li>
<li><a href="#tlmgr-AUTHORS-AND-COPYRIGHT">AUTHORS AND COPYRIGHT</a></li>
-<li><a href="#tlmgr-POD-ERRORS">POD ERRORS</a></li>
</ul>
<hr>
<div class="appendixsec-level-extent" id="tlmgr-NAME">
@@ -4799,8 +4841,8 @@
as any substring, and outputs bug-reporting and other information for
the package selected from the results.
</p>
-<p>The search is equivalent to <code class="code">tlmgr search --word --file <em class="emph">search-string</em>.
-Thus, <em class="emph">search-string</em> is interpreted as a (Perl) regular expression.</code>
+<p>The search is equivalent to <code class="code">tlmgr search --word --file</code> <em class="emph">search-string</em>.
+Thus, <em class="emph">search-string</em> is interpreted as a (Perl) regular expression.
</p>
<hr>
</div>
@@ -4986,7 +5028,7 @@
<dt><strong class="strong">--json</strong></dt>
<dd><a class="anchor" id="tlmgr-_002d_002djson"></a>
<p>Instead of dumping the actual content, the database is dumped as
-JSON. For the format of JSON output see <code class="code">tlpkg/doc/JSON-formats.txt</code>,
+JSON. For the format of JSON output see <code class="code">tlpkg/doc/json-formats.txt</code>,
format definition <code class="code">TLPDB</code>.
</p>
</dd>
@@ -5030,7 +5072,7 @@
<p>The <code class="code">generate</code> action overwrites any manual changes made in the
respective files: it recreates them from scratch based on the
-information of the installed packages, plus local adaptions.
+information of the installed packages, plus local adaptations.
The TeX Live installer and <code class="code">tlmgr</code> routinely call <code class="code">generate</code> for
all of these files.
</p>
@@ -5199,6 +5241,13 @@
dependencies in a similar way.
</p>
</dd>
+<dt><strong class="strong">--only-files</strong></dt>
+<dd><a class="anchor" id="tlmgr-_002d_002donly_002dfiles"></a>
+<p>If this option is given, only the files for a given package are listed,
+no further information. If more than one package name is given, each
+file list is preceded by the package name.
+</p>
+</dd>
<dt><strong class="strong">--only-installed</strong></dt>
<dd><a class="anchor" id="tlmgr-_002d_002donly_002dinstalled"></a>
<p>If this option is given, the installation source will not be used; only
@@ -5241,11 +5290,11 @@
</dd>
<dt><strong class="strong">--json</strong></dt>
<dd><a class="anchor" id="tlmgr-_002d_002djson-1"></a>
-<p>In case <code class="code">--json</code> is specified, the output is a JSON encoded array where
-each array element is the JSON representation of a single <code class="code">TLPOBJ</code> but
-with additional information. For details see
-<code class="code">tlpkg/doc/JSON-formats.txt</code>, format definition: <code class="code">TLPOBJINFO</code>. If both
-<code class="code">--json</code> and <code class="code">--data</code> are given, <code class="code">--json</code> takes precedence.
+<p>If <code class="code">--json</code> is specified, the output is a JSON encoded array where each
+array element is the JSON representation of a single <code class="code">TLPOBJ</code> but with
+additional information. For details see <code class="code">tlpkg/doc/json-formats.txt</code>,
+format definition: <code class="code">TLPOBJINFO</code>. If both <code class="code">--json</code> and <code class="code">--data</code> are
+given, <code class="code">--json</code> takes precedence.
</p>
</dd>
</dl>
@@ -5428,7 +5477,7 @@
<p>Both <code class="code">show...</code> forms take an option <code class="code">--json</code>, which dumps the option
information in JSON format. In this case, both forms dump the same
data. For the format of the JSON output see
-<code class="code">tlpkg/doc/JSON-formats.txt</code>, format definition <code class="code">TLOPTION</code>.
+<code class="code">tlpkg/doc/json-formats.txt</code>, format definition <code class="code">TLOPTION</code>.
</p>
<p>In the third form, with <em class="emph">key</em>, if <em class="emph">value</em> is not given, the setting
for <em class="emph">key</em> is displayed. If <em class="emph">value</em> is present, <em class="emph">key</em> is set to
@@ -5508,7 +5557,7 @@
<code class="code">desktop_integration</code> is set, then some packages will install items in
a sub-folder of the Start menu for <code class="code">tlmgr gui</code>, documentation, etc. If
<code class="code">fileassocs</code> is set, Windows file associations are made (see also the
-<code class="code">postaction</code> action). Finally, if <code class="code">multiuser</code> is set, then adaptions
+<code class="code">postaction</code> action). Finally, if <code class="code">multiuser</code> is set, then changes
to the registry and the menus are done for all users on the system
instead of only the current user. All three options are on by default.
</p>
@@ -5553,7 +5602,7 @@
</p>
<p>If <code class="code">--json</code> is specified without other options, the paper setup is
dumped in JSON format. For the format of JSON output see
-<code class="code">tlpkg/doc/JSON-formats.txt</code>, format definition <code class="code">TLPAPER</code>.
+<code class="code">tlpkg/doc/json-formats.txt</code>, format definition <code class="code">TLPAPER</code>.
</p>
<p>Incidentally, this syntax of having a specific program name before the
<code class="code">paper</code> keyword is unusual. It is inherited from the longstanding
@@ -5865,7 +5914,8 @@
</dd>
<dt><strong class="strong">repository status</strong></dt>
<dd><a class="anchor" id="tlmgr-repository-status"></a>
-<p>This action manages the list of repositories. See <a data-manual="MULTIPLE_REPOSITORIES" href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
+<p>This action manages the list of repositories. See <a class="url" href="https://metacpan.org/pod/MULTIPLE%20REPOSITORIES">MULTIPLE
+REPOSITORIES</a> below for detailed explanations.
</p>
<p>The first form, <code class="code">repository list</code>, lists all configured repositories
and the respective tags if set. If a path, url, or tag is given after
@@ -5968,10 +6018,11 @@
</dd>
<dt><strong class="strong">--json</strong></dt>
<dd><a class="anchor" id="tlmgr-_002d_002djson-2"></a>
-<p>When listing backups, the option <code class="code">--json</code> turn on JSON output.
-The format is an array of JSON objects (<code class="code">name</code>, <code class="code">rev</code>, <code class="code">date</code>).
-For details see <code class="code">tlpkg/doc/JSON-formats.txt</code>, format definition: <code class="code">TLBACKUPS</code>.
-If both <code class="code">--json</code> and <code class="code">--data</code> are given, <code class="code">--json</code> takes precedence.
+<p>When listing backups, the option <code class="code">--json</code> writes JSON output. The
+format is an array of JSON objects (<code class="code">name</code>, <code class="code">rev</code>, <code class="code">date</code>). For
+details see <code class="code">tlpkg/doc/json-formats.txt</code>, format definition:
+<code class="code">TLBACKUPS</code>. If both <code class="code">--json</code> and <code class="code">--data</code> are given, <code class="code">--json</code> takes
+precedence.
</p>
</dd>
</dl>
@@ -6028,6 +6079,13 @@
<code class="code">tables</code> (unless they also contain the word <code class="code">table</code> on its own).
</p>
</dd>
+<dt><strong class="strong">--json</strong></dt>
+<dd><a class="anchor" id="tlmgr-_002d_002djson-3"></a>
+<p>Output search results as a JSON hash with two keys: <strong class="strong">files</strong> and
+<strong class="strong">packages</strong>. For the format of the JSON output see
+<code class="code">tlpkg/doc/json-formats.txt</code>, format definition <code class="code">TLSEARCH</code>.
+</p>
+</dd>
</dl>
</dd>
@@ -7343,7 +7401,7 @@
<div class="appendixsec-level-extent" id="tlmgr-AUTHORS-AND-COPYRIGHT">
<div class="nav-panel">
<p>
-Next: <a href="#tlmgr-POD-ERRORS" accesskey="n" rel="next">POD ERRORS</a>, Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="appendixsec" id="AUTHORS-AND-COPYRIGHT-1"><span>B.14 AUTHORS AND COPYRIGHT<a class="copiable-link" href="#AUTHORS-AND-COPYRIGHT-1"> ¶</a></span></h3>
@@ -7351,28 +7409,9 @@
distribution (<a class="url" href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: tlmgr.pl 70001 2024-02-19 23:17:07Z karl $
+<p>$Id: tlmgr.pl 73493 2025-01-17 22:28:29Z karl $
</p>
-<hr>
-</div>
-<div class="appendixsec-level-extent" id="tlmgr-POD-ERRORS">
-<div class="nav-panel">
-<p>
-Previous: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="p" rel="prev">AUTHORS AND COPYRIGHT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<h3 class="appendixsec" id="POD-ERRORS"><span>B.15 POD ERRORS<a class="copiable-link" href="#POD-ERRORS"> ¶</a></span></h3>
-<p>Hey! <strong class="strong">The above document had some coding errors, which are explained below:</strong>
-</p>
-<dl class="table">
-<dt>Around line 8454:</dt>
-<dd><a class="anchor" id="tlmgr-Around-line-8454_003a"></a>
-<p>Unterminated C<...> sequence
-</p>
-</dd>
-</dl>
-
-
<hr>
</div>
</div>
@@ -7379,7 +7418,7 @@
<div class="unnumbered-level-extent" id="Index">
<div class="nav-panel">
<p>
-Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2024)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2025)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="unnumbered" id="Index-1"><span>Index<a class="copiable-link" href="#Index-1"> ¶</a></span></h2>
@@ -7436,7 +7475,7 @@
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
</td></tr></table>
-<table class="cp-entries-printindex" border="0">
+<table class="cp-entries-printindex">
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th></tr>
@@ -7502,6 +7541,8 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></td><td class="printindex-index-section"><a href="#g_t_002d_002dwithout_002dln_002ds"><code class="code">--without-ln-s</code></a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dx"><code>--without-x</code></a></td><td class="printindex-index-section"><a href="#g_t_002d_002dwithout_002dx"><code class="code">--without-x</code></a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dC-configure-option"><code>-C configure <span class="r">option</span></code></a></td><td class="printindex-index-section"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfvisibility_002dinlines_002dhidden"><code>-fvisibility-inlines-hidden</code></a></td><td class="printindex-index-section"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfvisibility_003dhidden"><code>-fvisibility=hidden</code></a></td><td class="printindex-index-section"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-_002dj-make-option"><code>-j make <span class="r">option</span></code></a></td><td class="printindex-index-section"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-2">$</th></tr>
@@ -7539,7 +7580,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-Build-script"><code>Build <span class="r">script</span></code></a></td><td class="printindex-index-section"><a href="#Building">Building</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-build-system_002c-design-of">build system, design of</a></td><td class="printindex-index-section"><a href="#Overview-of-build-system">Overview of build system</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-build_002daux_002f-top_002dlevel-directory"><samp class="file">build-aux/</samp> top-level directory</a></td><td class="printindex-index-section"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
-<tr><td></td><td class="printindex-index-entry"><a href="#index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"><code>BUILDCC<span class="r">,</span> BUILDCFLAGS<span class="r">, …</span></code></a></td><td class="printindex-index-section"><a href="#Cross-configuring">Cross configuring</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-BUILDCC_002c-BUILDCFLAGS_002c-_002e_002e_002e"><code>BUILDCC<span class="r">,</span> BUILDCFLAGS<span class="r">, …</span></code></a></td><td class="printindex-index-section"><a href="#Cross-configuring">Cross configuring</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-building">building</a></td><td class="printindex-index-section"><a href="#Building">Building</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-building-a-distribution">building a distribution</a></td><td class="printindex-index-section"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-building-in-parallel">building in parallel</a></td><td class="printindex-index-section"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
@@ -7564,7 +7605,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-Cocoa-Mac-framework_002c-required-by-xetex"><code class="code">Cocoa</code> Mac framework, required by <code class="code">xetex</code></a></td><td class="printindex-index-section"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-coding-conventions">coding conventions</a></td><td class="printindex-index-section"><a href="#Coding-conventions">Coding conventions</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-compilers_002c-C-and-C_002b_002b11">compilers, C and C++11</a></td><td class="printindex-index-section"><a href="#Prerequisites">Prerequisites</a></td></tr>
-<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eguess_002c-config_002esub_002c-_2026"><code>config.guess<span class="r">,</span> config.sub, …</code></a></td><td class="printindex-index-section"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eguess_002c-config_002esub_002c-_002e_002e_002e"><code>config.guess<span class="r">,</span> config.sub, …</code></a></td><td class="printindex-index-section"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-configure-options"><code class="code">configure</code> options</a></td><td class="printindex-index-section"><a href="#Configure-options">Configure options</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-configure-options_002c-for-bibtex_002dx"><code class="code">configure</code> options, for <code class="code">bibtex-x</code></a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp class="file">texk/bibtex-x</samp></a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-configure-options_002c-for-dvipdfm_002dx"><code class="code">configure</code> options, for <code class="code">dvipdfm-x</code></a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fdvipdfm_002dx">Configure options for <samp class="file">texk/dvipdfm-x</samp></a></td></tr>
@@ -7791,6 +7832,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-runscript_002eexe"><code>runscript.exe</code></a></td><td class="printindex-index-section"><a href="#Macros-for-Windows">Macros for Windows</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-S">S</th></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scripts_002dtargets_002elst"><code>scripts-targets.lst</code></a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-scripts_002c-linked-and-not-maintained">scripts, linked and not maintained</a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-scrolling_002c-smooth"><code>scrolling, smooth</code></a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp class="file">texk/xdvik</samp></a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-SED"><code>SED</code></a></td><td class="printindex-index-section"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
@@ -7808,6 +7850,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-stpcpy"><code>stpcpy</code></a></td><td class="printindex-index-section"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-Subversion-repository">Subversion repository</a></td><td class="printindex-index-section"><a href="#Build-system-tools">Build system tools</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-support-files_002c-separate-from-build">support files, separate from build</a></td><td class="printindex-index-section"><a href="#Installing">Installing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-symbolic-links_002c-used-for-scripts">symbolic links, used for scripts</a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-symlinks_002c-used-for-scripts">symlinks, used for scripts</a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-synctex">synctex</a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp class="file">texk/web2c</samp></a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-synctex-1">synctex</a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp class="file">texk/web2c</samp></a></td></tr>
@@ -7854,6 +7897,7 @@
<tr><td></td><td class="printindex-index-entry"><a href="#index-Work_002f-top_002dlevel-directory"><samp class="file">Work/</samp> top-level directory</a></td><td class="printindex-index-section"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-wrapper-binary-for-scripts-on-Windows">wrapper binary for scripts on Windows</a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-wrapper-build-system">wrapper build system</a></td><td class="printindex-index-section"><a href="#freetype-library"><code class="code">freetype</code> library</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-wrapper-for-scripts_002c-on-Windows">wrapper for scripts, on Windows</a></td><td class="printindex-index-section"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_letter-X">X</th></tr>
<tr><td></td><td class="printindex-index-entry"><a href="#index-X-toolkit">X toolkit</a></td><td class="printindex-index-section"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp class="file">texk/web2c</samp></a></td></tr>
Modified: trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/web2c/web2c.html
===================================================================
--- trunk/Master/texmf-dist/doc/web2c/web2c.html 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/texmf-dist/doc/web2c/web2c.html 2025-02-10 18:36:39 UTC (rev 73848)
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<html>
-<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the installation and use of the programs in Web2c,
@@ -76,56 +76,56 @@
<p>This document describes how to install and use the programs in the Web2c
implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 2024, released in
-March 2024.
+corresponds to Web2c version 2025, released in
+January 2025.
</p>
-<div class="element-contents" id="SEC_Contents">
+<div class="region-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="toc-numbered-mark">
- <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
+ <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Installation" href="#Installation">2 Installation</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-configure-options-1" href="#configure-options">2.1 <code class="code">configure</code> options</a></li>
- <li><a id="toc-Compile_002dtime-options-1" href="#Compile_002dtime-options">2.2 Compile-time options</a></li>
- <li><a id="toc-Additional-targets-1" href="#Additional-targets">2.3 Additional targets</a></li>
+ <li><a id="toc-configure-options" href="#configure-options">2.1 <code class="code">configure</code> options</a></li>
+ <li><a id="toc-Compile_002dtime-options" href="#Compile_002dtime-options">2.2 Compile-time options</a></li>
+ <li><a id="toc-Additional-targets" href="#Additional-targets">2.3 Additional targets</a></li>
<li><a id="toc-Trip_002c-trap_002c-and-mptrap_003a-Torture-tests" href="#Triptrap">2.4 Trip, trap, and mptrap: Torture tests</a></li>
</ul></li>
- <li><a id="toc-Commonalities-1" href="#Commonalities">3 Commonalities</a>
+ <li><a id="toc-Commonalities" href="#Commonalities">3 Commonalities</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Option-conventions-1" href="#Option-conventions">3.1 Option conventions</a></li>
- <li><a id="toc-Common-options-1" href="#Common-options">3.2 Common options</a></li>
- <li><a id="toc-Path-searching-1" href="#Path-searching">3.3 Path searching</a></li>
- <li><a id="toc-Output-file-location-1" href="#Output-file-location">3.4 Output file location</a></li>
+ <li><a id="toc-Option-conventions" href="#Option-conventions">3.1 Option conventions</a></li>
+ <li><a id="toc-Common-options" href="#Common-options">3.2 Common options</a></li>
+ <li><a id="toc-Path-searching" href="#Path-searching">3.3 Path searching</a></li>
+ <li><a id="toc-Output-file-location" href="#Output-file-location">3.4 Output file location</a></li>
</ul></li>
<li><a id="toc-Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX" href="#Three-programs">4 Three programs: Metafont, MetaPost, and TeX</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Runtime-options-1" href="#Runtime-options">4.1 Runtime options</a></li>
- <li><a id="toc-Initial-and-virgin-1" href="#Initial-and-virgin">4.2 Initial and virgin</a></li>
- <li><a id="toc-Memory-dumps-1" href="#Memory-dumps">4.3 Memory dumps</a>
+ <li><a id="toc-Runtime-options" href="#Runtime-options">4.1 Runtime options</a></li>
+ <li><a id="toc-Initial-and-virgin" href="#Initial-and-virgin">4.2 Initial and virgin</a></li>
+ <li><a id="toc-Memory-dumps" href="#Memory-dumps">4.3 Memory dumps</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Creating-memory-dumps-1" href="#Creating-memory-dumps">4.3.1 Creating memory dumps</a></li>
- <li><a id="toc-Determining-the-memory-dump-to-use-1" href="#Determining-the-memory-dump-to-use">4.3.2 Determining the memory dump to use</a></li>
- <li><a id="toc-Hardware-and-memory-dumps-1" href="#Hardware-and-memory-dumps">4.3.3 Hardware and memory dumps</a></li>
+ <li><a id="toc-Creating-memory-dumps" href="#Creating-memory-dumps">4.3.1 Creating memory dumps</a></li>
+ <li><a id="toc-Determining-the-memory-dump-to-use" href="#Determining-the-memory-dump-to-use">4.3.2 Determining the memory dump to use</a></li>
+ <li><a id="toc-Hardware-and-memory-dumps" href="#Hardware-and-memory-dumps">4.3.3 Hardware and memory dumps</a></li>
</ul></li>
- <li><a id="toc-Editor-invocation-1" href="#Editor-invocation">4.4 Editor invocation</a></li>
- <li><a id="toc-_005cinput-filenames-1" href="#g_t_005cinput-filenames">4.5 <code class="code">\input</code> filenames</a>
+ <li><a id="toc-Editor-invocation" href="#Editor-invocation">4.4 Editor invocation</a></li>
+ <li><a id="toc-_005cinput-filenames" href="#g_t_005cinput-filenames">4.5 <code class="code">\input</code> filenames</a>
<ul class="toc-numbered-mark">
<li><a id="toc-_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022" href="#g_t_005cinput-quoted-filename">4.5.1 <code class="code">\input</code> quoted filename: <code class="code">\input "some name"</code></a></li>
<li><a id="toc-_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d" href="#g_t_005cinput-braced-filename">4.5.2 <code class="code">\input</code> braced filename: <code class="code">\input{some name}</code></a></li>
- <li><a id="toc-_005cinput-filename-caveats-1" href="#g_t_005cinput-filename-caveats">4.5.3 <code class="code">\input</code> filename caveats</a></li>
+ <li><a id="toc-_005cinput-filename-caveats" href="#g_t_005cinput-filename-caveats">4.5.3 <code class="code">\input</code> filename caveats</a></li>
</ul></li>
</ul></li>
<li><a id="toc-TeX_003a-Typesetting" href="#TeX">5 TeX: Typesetting</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-tex-invocation-1" href="#tex-invocation">5.1 <code class="code">tex</code> invocation</a></li>
- <li><a id="toc-Initial-TeX-1" href="#Initial-TeX">5.2 Initial TeX</a></li>
- <li><a id="toc-Formats-1" href="#Formats">5.3 Formats</a></li>
- <li><a id="toc-Languages-and-hyphenation-1" href="#Languages-and-hyphenation">5.4 Languages and hyphenation</a>
+ <li><a id="toc-tex-invocation" href="#tex-invocation">5.1 <code class="code">tex</code> invocation</a></li>
+ <li><a id="toc-Initial-TeX" href="#Initial-TeX">5.2 Initial TeX</a></li>
+ <li><a id="toc-Formats" href="#Formats">5.3 Formats</a></li>
+ <li><a id="toc-Languages-and-hyphenation" href="#Languages-and-hyphenation">5.4 Languages and hyphenation</a>
<ul class="toc-numbered-mark">
<li><a id="toc-MLTeX_003a-Multi_002dlingual-TeX" href="#MLTeX">5.4.1 MLTeX: Multi-lingual TeX</a>
<ul class="toc-numbered-mark">
@@ -135,29 +135,29 @@
<li><a id="toc-TCX-files_003a-Character-translations" href="#TCX-files">5.4.2 TCX files: Character translations</a></li>
<li><a id="toc-Patgen_003a-Creating-hyphenation-patterns" href="#patgen-invocation">5.4.3 Patgen: Creating hyphenation patterns</a></li>
</ul></li>
- <li><a id="toc-Shell-escapes-1" href="#Shell-escapes">5.5 Shell escapes</a></li>
- <li><a id="toc-IPC-and-TeX-1" href="#IPC-and-TeX">5.6 IPC and TeX</a></li>
+ <li><a id="toc-Shell-escapes" href="#Shell-escapes">5.5 Shell escapes</a></li>
+ <li><a id="toc-IPC-and-TeX" href="#IPC-and-TeX">5.6 IPC and TeX</a></li>
<li><a id="toc-Extended-TeX-engines" href="#TeX-extensions">5.7 Extended TeX engines</a></li>
</ul></li>
<li><a id="toc-Metafont_003a-Creating-typeface-families" href="#Metafont">6 Metafont: Creating typeface families</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-mf-invocation-1" href="#mf-invocation">6.1 <code class="code">mf</code> invocation</a></li>
- <li><a id="toc-Initial-Metafont-1" href="#Initial-Metafont">6.2 Initial Metafont</a></li>
+ <li><a id="toc-mf-invocation" href="#mf-invocation">6.1 <code class="code">mf</code> invocation</a></li>
+ <li><a id="toc-Initial-Metafont" href="#Initial-Metafont">6.2 Initial Metafont</a></li>
<li><a id="toc-Modes_003a-Device-definitions-for-Metafont" href="#Modes">6.3 Modes: Device definitions for Metafont</a></li>
- <li><a id="toc-Online-Metafont-graphics-1" href="#Online-Metafont-graphics">6.4 Online Metafont graphics</a></li>
+ <li><a id="toc-Online-Metafont-graphics" href="#Online-Metafont-graphics">6.4 Online Metafont graphics</a></li>
<li><a id="toc-GFtoDVI_003a-Character-proofs-of-fonts" href="#gftodvi-invocation">6.5 GFtoDVI: Character proofs of fonts</a></li>
<li><a id="toc-MFT_003a-Prettyprinting-Metafont-source" href="#mft-invocation">6.6 MFT: Prettyprinting Metafont source</a></li>
</ul></li>
<li><a id="toc-MetaPost_003a-Generating-PostScript" href="#MetaPost">7 MetaPost: Generating PostScript</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-mpost-invocation-1" href="#mpost-invocation">7.1 <code class="code">mpost</code> invocation</a></li>
- <li><a id="toc-Initial-MetaPost-1" href="#Initial-MetaPost">7.2 Initial MetaPost</a></li>
+ <li><a id="toc-mpost-invocation" href="#mpost-invocation">7.1 <code class="code">mpost</code> invocation</a></li>
+ <li><a id="toc-Initial-MetaPost" href="#Initial-MetaPost">7.2 Initial MetaPost</a></li>
<li><a id="toc-DVItoMP_003a-DVI-to-MPX-conversion" href="#dvitomp-invocation">7.3 DVItoMP: DVI to MPX conversion</a></li>
</ul></li>
<li><a id="toc-BibTeX_003a-Bibliographies" href="#BibTeX">8 BibTeX: Bibliographies</a>
<ul class="toc-numbered-mark">
<li><a id="toc-BibTeX-invocation" href="#bibtex-invocation">8.1 BibTeX invocation</a></li>
- <li><a id="toc-Basic-BibTeX-style-files-1" href="#Basic-BibTeX-style-files">8.2 Basic BibTeX style files</a></li>
+ <li><a id="toc-Basic-BibTeX-style-files" href="#Basic-BibTeX-style-files">8.2 Basic BibTeX style files</a></li>
</ul></li>
<li><a id="toc-WEB_003a-Literate-programming" href="#WEB">9 WEB: Literate programming</a>
<ul class="toc-numbered-mark">
@@ -165,7 +165,7 @@
<li><a id="toc-Weave_003a-Translate-WEB-to-TeX" href="#weave-invocation">9.2 Weave: Translate WEB to TeX</a></li>
<li><a id="toc-Pooltype_003a-Display-WEB-pool-files" href="#pooltype-invocation">9.3 Pooltype: Display WEB pool files</a></li>
</ul></li>
- <li><a id="toc-DVI-utilities-1" href="#DVI-utilities">10 DVI utilities</a>
+ <li><a id="toc-DVI-utilities" href="#DVI-utilities">10 DVI utilities</a>
<ul class="toc-numbered-mark">
<li><a id="toc-DVIcopy_003a-Canonicalize-virtual-font-references" href="#dvicopy-invocation">10.1 DVIcopy: Canonicalize virtual font references</a></li>
<li><a id="toc-DVItype_003a-Plain-text-transliteration-of-DVI-files" href="#dvitype-invocation">10.2 DVItype: Plain text transliteration of DVI files</a>
@@ -173,9 +173,9 @@
<li><a id="toc-DVItype-output-example" href="#dvitype-output-example">10.2.1 DVItype output example</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Font-utilities-1" href="#Font-utilities">11 Font utilities</a>
+ <li><a id="toc-Font-utilities" href="#Font-utilities">11 Font utilities</a>
<ul class="toc-numbered-mark">
- <li><a id="toc-Font-file-formats-1" href="#Font-file-formats">11.1 Font file formats</a></li>
+ <li><a id="toc-Font-file-formats" href="#Font-file-formats">11.1 Font file formats</a></li>
<li><a id="toc-GFtoPK_003a-Generic-to-packed-font-conversion" href="#gftopk-invocation">11.2 GFtoPK: Generic to packed font conversion</a></li>
<li><a id="toc-PKtoGF_003a-Packed-to-generic-font-conversion" href="#pktogf-invocation">11.3 PKtoGF: Packed to generic font conversion</a></li>
<li><a id="toc-PKtype_003a-Plain-text-transliteration-of-packed-fonts" href="#pktype-invocation">11.4 PKtype: Plain text transliteration of packed fonts</a></li>
@@ -184,11 +184,11 @@
<li><a id="toc-PLtoTF_003a-Property-list-to-TeX-font-metric-conversion" href="#pltotf-invocation">11.7 PLtoTF: Property list to TeX font metric conversion</a></li>
<li><a id="toc-VFtoVP_003a-Virtual-font-to-virtual-property-lists" href="#vftovp-invocation">11.8 VFtoVP: Virtual font to virtual property lists</a></li>
<li><a id="toc-VPtoVF_003a-Virtual-property-lists-to-virtual-font" href="#vptovf-invocation">11.9 VPtoVF: Virtual property lists to virtual font</a></li>
- <li><a id="toc-Font-utilities-available-elsewhere-1" href="#Font-utilities-available-elsewhere">11.10 Font utilities available elsewhere</a></li>
+ <li><a id="toc-Font-utilities-available-elsewhere" href="#Font-utilities-available-elsewhere">11.10 Font utilities available elsewhere</a></li>
</ul></li>
- <li><a id="toc-Legalisms-1" href="#Legalisms">Appendix A Legalisms</a></li>
- <li><a id="toc-References-1" href="#References">Appendix B References</a></li>
- <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
+ <li><a id="toc-Legalisms" href="#Legalisms">Appendix A Legalisms</a></li>
+ <li><a id="toc-References" href="#References">Appendix B References</a></li>
+ <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
</ul>
</div>
</div>
@@ -202,8 +202,8 @@
<a class="index-entry-id" id="index-introduction"></a>
-<p>This manual corresponds to version 2024 of Web2c, released in
-March 2024.
+<p>This manual corresponds to version 2025 of Web2c, released in
+January 2025.
</p>
<a class="index-entry-id" id="index-Knuth_002c-Donald-E_002e"></a>
<a class="index-entry-id" id="index-TeX_002c-Web2c-implementation-of"></a>
@@ -5290,7 +5290,7 @@
<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a>
</td></tr></table>
-<table class="cp-entries-printindex" border="0">
+<table class="cp-entries-printindex">
<tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
<tr><td colspan="3"><hr></td></tr>
<tr><th id="Index_cp_symbol-1">-</th></tr>
Modified: trunk/Master/texmf-dist/doc/web2c/web2c.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/tlpkg/bin/tl-update-asy
===================================================================
--- trunk/Master/tlpkg/bin/tl-update-asy 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/tlpkg/bin/tl-update-asy 2025-02-10 18:36:39 UTC (rev 73848)
@@ -116,7 +116,7 @@
$xist/asymptote/ $xist/tex/*/asymptote"
svn status $ci | sed -n 's/^\?//p'
-b svn add `!!`
+ svn add `!!`
cd /tmp/ainst
xmf=/home/texlive/karl/Master/texmf-dist
Modified: trunk/Master/tlpkg/doc/releng.txt
===================================================================
--- trunk/Master/tlpkg/doc/releng.txt 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/tlpkg/doc/releng.txt 2025-02-10 18:36:39 UTC (rev 73848)
@@ -292,24 +292,32 @@
and changes throughout if behavior has changed.
Engine/etc. doc updates:
. run tl-update-news, which copies simple files to the runtime doc dir.
- . pdftex/mpost/luatex maintainers should update their manuals
- from their repositories (doc/manual/ and manual/ subdirs for the
- first two) to the runtime.
+ . engine maintainers should update their manuals from their
+ repositories to the runtime.
+ pdftex: doc/manual
+ metapost: manual (~www/metapost/src/manual)
+ luatex: TL:Build/source/texk/web2c/doc/luatex
. update of core man pages in Build/source/texk/web2c/man.
Update tlbuild.texi text, then
xs=.../Build/source
W=$xs/Work
make -C $W/doc script-links tlbuild-incl.texi readme-files readme-install
- Remake updmap,fmtutil man pages with help2man (install latest from source):
+ # we'll install it below.
+ Install latest help2man from ftp.gnu.org, then
+ remake mflua,updmap,fmtutil man pages with help2man:
tm=.../Master
- make -C $W/texk/texlive/tl_support xupdmap.1 xfmtutil.1
+ make -C $W/texk/texlive/tl_support xmans
x1=`(unset CDPATH; cd $tm/texmf-dist/doc/man/man1; pwd)`
They must be moved from /tmp into both Master and Build by hand:
\cp -p /tmp/xupdmap.1 $x1/updmap.1
+ \cp -p /tmp/xupdmap.1 $xs/texk/texlive/tl_support/updmap.1
+ #
\cp -p /tmp/xfmtutil.1 $x1/fmtutil.1
- \cp -p /tmp/xupdmap.1 $xs/texk/texlive/tl_support/updmap.1
\cp -p /tmp/xfmtutil.1 $xs/texk/texlive/tl_support/fmtutil.1
- Also update them in ~www/texlive/doc/*.html:
+ #
+ \cp -p /tmp/xmflua.1 $x1/mflua.1
+ (mflua should not be our job, but since we're doing the others, why not.)
+ Also update our web pages in ~www/texlive/doc/*.html (not mflua):
\cp -p /tmp/xupdmap.1.html $lw/doc/updmap.html
\cp -p /tmp/xfmtutil.1.html $lw/doc/fmtutil.html
While we're here, let's update the other generated html files:
@@ -328,7 +336,7 @@
svn add `!!`
Texinfo manuals from Build to Master:
tl-update-txi
- Don't forget to commit everything (texmf-dist/doc, Build/source, ...).
+ Finally, check and commit everything (texmf-dist/doc, Build/source, ...).
N. Really test during, and at end, of pretest that
(really! don't leave it for post-release failure)
Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds 2025-02-10 16:49:00 UTC (rev 73847)
+++ trunk/Master/tlpkg/libexec/ctan2tds 2025-02-10 18:36:39 UTC (rev 73848)
@@ -4879,9 +4879,9 @@
my $linktarget = "../../$DEST_TREE/scripts/$package/$s";
&SYSTEM ("ln -s $linktarget $platdir/$linkname");
#
- # Scripts with special cases.
- # xx should merge with bin_links in
- # Build/source/texk/texlive/linked_scripts/Makefile.am, sigh.
+ # Scripts with multiple links.
+ # xxqqq should merge with bin_links in
+ # Build/source/texk/texlive/linked_scripts/Makefile.am.
&SYSTEM ("ln -s $linkname $platdir/cllualatex")
if $linkname eq "cluttex"; # cluttex->cllualatex
&SYSTEM ("ln -s $linkname $platdir/clxelatex")
More information about the tex-live-commits
mailing list.