From 1e9e7843c8f3dd00f3beff690e97e329c552dddb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 27 Feb 2021 17:39:48 +0000 Subject: doc updates for 2021 git-svn-id: svn://tug.org/texlive/trunk@57972 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/README.1prerequisites | 6 +- Build/source/README.2building | 44 +- Build/source/README.4layout | 81 +- Build/source/README.5configure | 19 +- Build/source/doc/tlbuild-incl/install-tl.texi | 75 +- Build/source/doc/tlbuild-incl/tlmgr.texi | 62 +- Build/source/doc/tlbuild.info | 1351 +++++++------- Master/texmf-dist/doc/dvipng/dvipng.pdf | Bin 220376 -> 220487 bytes Master/texmf-dist/doc/dvips/dvips.html | 132 +- Master/texmf-dist/doc/dvips/dvips.pdf | Bin 412092 -> 412464 bytes Master/texmf-dist/doc/info/dvips.info | 428 ++--- Master/texmf-dist/doc/info/kpathsea.info | 196 +-- Master/texmf-dist/doc/info/tlbuild.info | 1851 ++++++++++---------- Master/texmf-dist/doc/info/web2c.info | 1030 +++++------ Master/texmf-dist/doc/kpathsea/kpathsea.html | 10 +- Master/texmf-dist/doc/kpathsea/kpathsea.pdf | Bin 402446 -> 402597 bytes Master/texmf-dist/doc/man/man1/Makefile | 3 - Master/texmf-dist/doc/man/man1/aleph.1 | 2 +- Master/texmf-dist/doc/man/man1/aleph.man1.pdf | Bin 30962 -> 30710 bytes Master/texmf-dist/doc/man/man1/amstex.1 | 2 +- Master/texmf-dist/doc/man/man1/amstex.man1.pdf | Bin 19850 -> 19746 bytes Master/texmf-dist/doc/man/man1/arara.man1.pdf | Bin 0 -> 19768 bytes Master/texmf-dist/doc/man/man1/autosp.1 | 4 +- Master/texmf-dist/doc/man/man1/autosp.man1.pdf | Bin 29663 -> 29228 bytes Master/texmf-dist/doc/man/man1/bibtex.1 | 2 +- Master/texmf-dist/doc/man/man1/bibtex.man1.pdf | Bin 24660 -> 24482 bytes Master/texmf-dist/doc/man/man1/cslatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/ctangle.man1.pdf | Bin 27199 -> 27534 bytes Master/texmf-dist/doc/man/man1/ctie.1 | 5 +- Master/texmf-dist/doc/man/man1/ctie.man1.pdf | Bin 18792 -> 19192 bytes .../doc/man/man1/ctwill-refsort.man1.pdf | Bin 32114 -> 33241 bytes .../texmf-dist/doc/man/man1/ctwill-twinx.man1.pdf | Bin 32114 -> 33241 bytes Master/texmf-dist/doc/man/man1/ctwill.1 | 30 +- Master/texmf-dist/doc/man/man1/ctwill.man1.pdf | Bin 32383 -> 33241 bytes Master/texmf-dist/doc/man/man1/cweave.man1.pdf | Bin 27199 -> 27534 bytes Master/texmf-dist/doc/man/man1/cweb.1 | 17 +- Master/texmf-dist/doc/man/man1/cweb.man1.pdf | Bin 27470 -> 27534 bytes Master/texmf-dist/doc/man/man1/detex.1 | 6 +- Master/texmf-dist/doc/man/man1/detex.man1.pdf | Bin 23438 -> 23185 bytes Master/texmf-dist/doc/man/man1/dvibook.1 | 11 +- Master/texmf-dist/doc/man/man1/dvibook.man1.pdf | Bin 18892 -> 19450 bytes Master/texmf-dist/doc/man/man1/dvicopy.1 | 2 +- Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf | Bin 20912 -> 20815 bytes Master/texmf-dist/doc/man/man1/dvigif.man1.pdf | Bin 48032 -> 48276 bytes .../doc/man/man1/dvilualatex-dev.man1.pdf | Bin 15706 -> 15712 bytes .../texmf-dist/doc/man/man1/dvilualatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/dviluatex.man1.pdf | Bin 34606 -> 34615 bytes Master/texmf-dist/doc/man/man1/dvipng.1 | 34 +- Master/texmf-dist/doc/man/man1/dvipng.man1.pdf | Bin 48534 -> 48276 bytes Master/texmf-dist/doc/man/man1/dvisvgm.1 | 20 +- Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf | Bin 93576 -> 94334 bytes Master/texmf-dist/doc/man/man1/dvitodvi.1 | 11 +- Master/texmf-dist/doc/man/man1/dvitodvi.man1.pdf | Bin 23773 -> 23953 bytes Master/texmf-dist/doc/man/man1/dvitomp.1 | 2 +- Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf | Bin 16838 -> 16743 bytes Master/texmf-dist/doc/man/man1/dvitype.1 | 2 +- Master/texmf-dist/doc/man/man1/dvitype.man1.pdf | Bin 23389 -> 23282 bytes Master/texmf-dist/doc/man/man1/eptex.man1.pdf | Bin 21083 -> 21094 bytes Master/texmf-dist/doc/man/man1/euptex.man1.pdf | Bin 21083 -> 21094 bytes .../texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf | Bin 32781 -> 30017 bytes .../texmf-dist/doc/man/man1/fmtutil-user.man1.pdf | Bin 32781 -> 30017 bytes Master/texmf-dist/doc/man/man1/fmtutil.1 | 159 +- Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf | Bin 32781 -> 30017 bytes Master/texmf-dist/doc/man/man1/gftodvi.1 | 2 +- Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf | Bin 26705 -> 26523 bytes Master/texmf-dist/doc/man/man1/gftopk.1 | 2 +- Master/texmf-dist/doc/man/man1/gftopk.man1.pdf | Bin 21144 -> 21038 bytes Master/texmf-dist/doc/man/man1/gftype.1 | 2 +- Master/texmf-dist/doc/man/man1/gftype.man1.pdf | Bin 20347 -> 20243 bytes Master/texmf-dist/doc/man/man1/inimf.man1.pdf | Bin 39582 -> 39601 bytes Master/texmf-dist/doc/man/man1/initex.man1.pdf | Bin 43526 -> 43542 bytes Master/texmf-dist/doc/man/man1/kpseaccess.1 | 2 +- Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf | Bin 15936 -> 15835 bytes Master/texmf-dist/doc/man/man1/kpsereadlink.1 | 2 +- .../texmf-dist/doc/man/man1/kpsereadlink.man1.pdf | Bin 14484 -> 14387 bytes Master/texmf-dist/doc/man/man1/kpsestat.1 | 2 +- Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf | Bin 15216 -> 15114 bytes Master/texmf-dist/doc/man/man1/kpsewhich.1 | 2 +- Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf | Bin 22561 -> 22386 bytes Master/texmf-dist/doc/man/man1/latex-dev.1 | 2 +- Master/texmf-dist/doc/man/man1/latex-dev.man1.pdf | Bin 15812 -> 15712 bytes Master/texmf-dist/doc/man/man1/latex.1 | 2 +- Master/texmf-dist/doc/man/man1/latex.man1.pdf | Bin 22097 -> 21991 bytes Master/texmf-dist/doc/man/man1/luahbtex.man1.pdf | Bin 34606 -> 34615 bytes .../texmf-dist/doc/man/man1/luajithbtex.man1.pdf | Bin 34606 -> 34615 bytes Master/texmf-dist/doc/man/man1/luajittex.man1.pdf | Bin 34606 -> 34615 bytes .../texmf-dist/doc/man/man1/lualatex-dev.man1.pdf | Bin 15706 -> 15712 bytes Master/texmf-dist/doc/man/man1/lualatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/luatex.1 | 2 +- Master/texmf-dist/doc/man/man1/luatex.man1.pdf | Bin 34953 -> 34615 bytes Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf | Bin 39582 -> 39601 bytes Master/texmf-dist/doc/man/man1/mf.1 | 2 +- Master/texmf-dist/doc/man/man1/mf.man1.pdf | Bin 40014 -> 39620 bytes Master/texmf-dist/doc/man/man1/mft.1 | 2 +- Master/texmf-dist/doc/man/man1/mft.man1.pdf | Bin 24240 -> 24059 bytes Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf | Bin 32781 -> 30017 bytes Master/texmf-dist/doc/man/man1/mpost.1 | 2 +- Master/texmf-dist/doc/man/man1/mpost.man1.pdf | Bin 29126 -> 28945 bytes Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf | Bin 20809 -> 20815 bytes Master/texmf-dist/doc/man/man1/odvitype.man1.pdf | Bin 23270 -> 23282 bytes Master/texmf-dist/doc/man/man1/ofm2opl.1 | 2 +- Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf | Bin 23628 -> 23447 bytes Master/texmf-dist/doc/man/man1/opl2ofm.1 | 2 +- Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf | Bin 22279 -> 22173 bytes Master/texmf-dist/doc/man/man1/otangle.man1.pdf | Bin 26418 -> 26417 bytes Master/texmf-dist/doc/man/man1/ovf2ovp.1 | 2 +- Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf | Bin 22964 -> 22789 bytes Master/texmf-dist/doc/man/man1/ovp2ovf.1 | 2 +- Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf | Bin 23309 -> 23132 bytes Master/texmf-dist/doc/man/man1/patgen.1 | 2 +- Master/texmf-dist/doc/man/man1/patgen.man1.pdf | Bin 29923 -> 29666 bytes Master/texmf-dist/doc/man/man1/pdfcslatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/pdfetex.1 | 2 +- Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf | Bin 15602 -> 15503 bytes .../texmf-dist/doc/man/man1/pdflatex-dev.man1.pdf | Bin 15706 -> 15712 bytes Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf | Bin 39633 -> 39635 bytes Master/texmf-dist/doc/man/man1/pdftex.1 | 2 +- Master/texmf-dist/doc/man/man1/pdftex.man1.pdf | Bin 40040 -> 39639 bytes Master/texmf-dist/doc/man/man1/pdftosrc.1 | 2 +- Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf | Bin 25807 -> 25542 bytes Master/texmf-dist/doc/man/man1/pktogf.1 | 2 +- Master/texmf-dist/doc/man/man1/pktogf.man1.pdf | Bin 21022 -> 20913 bytes Master/texmf-dist/doc/man/man1/pktype.1 | 2 +- Master/texmf-dist/doc/man/man1/pktype.man1.pdf | Bin 19159 -> 19050 bytes Master/texmf-dist/doc/man/man1/platex-dev.man1.pdf | Bin 15706 -> 15712 bytes Master/texmf-dist/doc/man/man1/platex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/pltotf.1 | 2 +- Master/texmf-dist/doc/man/man1/pltotf.man1.pdf | Bin 21392 -> 21284 bytes Master/texmf-dist/doc/man/man1/pooltype.1 | 2 +- Master/texmf-dist/doc/man/man1/pooltype.man1.pdf | Bin 17486 -> 17384 bytes Master/texmf-dist/doc/man/man1/ppltotf.1 | 2 +- Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf | Bin 19986 -> 19884 bytes Master/texmf-dist/doc/man/man1/ptex.1 | 2 +- Master/texmf-dist/doc/man/man1/ptex.man1.pdf | Bin 21197 -> 21092 bytes Master/texmf-dist/doc/man/man1/ptftopl.1 | 2 +- Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf | Bin 20134 -> 20031 bytes Master/texmf-dist/doc/man/man1/t1ascii.1 | 2 +- Master/texmf-dist/doc/man/man1/t1ascii.man1.pdf | Bin 19414 -> 19314 bytes Master/texmf-dist/doc/man/man1/t1asm.1 | 2 +- Master/texmf-dist/doc/man/man1/t1asm.man1.pdf | Bin 23657 -> 23482 bytes Master/texmf-dist/doc/man/man1/t1binary.1 | 2 +- Master/texmf-dist/doc/man/man1/t1binary.man1.pdf | Bin 19020 -> 19013 bytes Master/texmf-dist/doc/man/man1/t1disasm.1 | 2 +- Master/texmf-dist/doc/man/man1/t1disasm.man1.pdf | Bin 23098 -> 22925 bytes Master/texmf-dist/doc/man/man1/t1mac.1 | 2 +- Master/texmf-dist/doc/man/man1/t1mac.man1.pdf | Bin 18637 -> 18628 bytes Master/texmf-dist/doc/man/man1/t1unmac.1 | 2 +- Master/texmf-dist/doc/man/man1/t1unmac.man1.pdf | Bin 19531 -> 19522 bytes Master/texmf-dist/doc/man/man1/tangle.1 | 2 +- Master/texmf-dist/doc/man/man1/tangle.man1.pdf | Bin 26599 -> 26417 bytes Master/texmf-dist/doc/man/man1/tex.1 | 4 +- Master/texmf-dist/doc/man/man1/tex.man1.pdf | Bin 43953 -> 43542 bytes Master/texmf-dist/doc/man/man1/texlua.man1.pdf | Bin 34606 -> 34615 bytes Master/texmf-dist/doc/man/man1/texluac.man1.pdf | Bin 34606 -> 34615 bytes Master/texmf-dist/doc/man/man1/tftopl.1 | 2 +- Master/texmf-dist/doc/man/man1/tftopl.man1.pdf | Bin 23309 -> 23202 bytes Master/texmf-dist/doc/man/man1/tie.1 | 5 +- Master/texmf-dist/doc/man/man1/tie.man1.pdf | Bin 17400 -> 17706 bytes Master/texmf-dist/doc/man/man1/ttf2afm.1 | 2 +- Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf | Bin 21086 -> 20913 bytes Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf | Bin 41535 -> 37660 bytes .../texmf-dist/doc/man/man1/updmap-user.man1.pdf | Bin 41535 -> 37660 bytes Master/texmf-dist/doc/man/man1/updmap.1 | 196 +-- Master/texmf-dist/doc/man/man1/updmap.man1.pdf | Bin 41535 -> 37660 bytes .../texmf-dist/doc/man/man1/uplatex-dev.man1.pdf | Bin 15706 -> 15712 bytes Master/texmf-dist/doc/man/man1/uplatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf | Bin 19872 -> 19884 bytes Master/texmf-dist/doc/man/man1/uptex.man1.pdf | Bin 21083 -> 21094 bytes Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf | Bin 20026 -> 20031 bytes Master/texmf-dist/doc/man/man1/vftovp.1 | 2 +- Master/texmf-dist/doc/man/man1/vftovp.man1.pdf | Bin 21621 -> 21516 bytes Master/texmf-dist/doc/man/man1/vptovf.1 | 2 +- Master/texmf-dist/doc/man/man1/vptovf.man1.pdf | Bin 19005 -> 18899 bytes Master/texmf-dist/doc/man/man1/weave.1 | 2 +- Master/texmf-dist/doc/man/man1/weave.man1.pdf | Bin 20684 -> 20578 bytes .../texmf-dist/doc/man/man1/xelatex-dev.man1.pdf | Bin 15706 -> 15712 bytes Master/texmf-dist/doc/man/man1/xelatex.man1.pdf | Bin 21984 -> 21991 bytes Master/texmf-dist/doc/man/man1/xetex.1 | 2 +- Master/texmf-dist/doc/man/man1/xetex.man1.pdf | Bin 20274 -> 20172 bytes Master/texmf-dist/doc/man/man1/xml2pmx.1 | 59 + Master/texmf-dist/doc/man/man1/xml2pmx.man1.pdf | Bin 0 -> 17495 bytes Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html | 345 ++-- Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf | Bin 508822 -> 519572 bytes Master/texmf-dist/doc/web2c/web2c.html | 834 +++++---- Master/texmf-dist/doc/web2c/web2c.pdf | Bin 469172 -> 474842 bytes Master/tlpkg/doc/releng.txt | 17 +- 186 files changed, 3669 insertions(+), 3470 deletions(-) create mode 100644 Master/texmf-dist/doc/man/man1/arara.man1.pdf create mode 100644 Master/texmf-dist/doc/man/man1/xml2pmx.1 create mode 100644 Master/texmf-dist/doc/man/man1/xml2pmx.man1.pdf diff --git a/Build/source/README.1prerequisites b/Build/source/README.1prerequisites index 443a4826ecc..98617641b9a 100644 --- a/Build/source/README.1prerequisites +++ b/Build/source/README.1prerequisites @@ -15,9 +15,9 @@ notably FreeType; all the TL-maintained directories (and Automake/Autoconf output in general) work with any reasonable 'make'. A C++11 compiler is similarly required because of the third-party -libraries ICU and Poppler; the program 'dvisvgm' also requires C++11. -It is possible to build everything else with older compilers, but you -have to remove the C++11-dependent sources. *Note Build one package::. +library ICU; the program 'dvisvgm' also requires C++11. It is possible +to build everything else with older compilers, but you have to remove +the C++11-dependent sources. *Note Build one package::. A few programs in the tree have additional requirements: diff --git a/Build/source/README.2building b/Build/source/README.2building index d797d72ed19..b72be147761 100644 --- a/Build/source/README.2building +++ b/Build/source/README.2building @@ -87,8 +87,8 @@ invoked to build an individual program or library, first building any required libraries. Here is an example from start to finish for working on 'dvipdfm-x'. -(Unfortunately, this does not suffice for building one, or a subset, of -the TeX engines; see the next section.) +(Unfortunately, this does not suffice for building the TeX engines; see +the next section.) mkdir mydir && cd mydir # new working directory @@ -142,7 +142,7 @@ an older compiler lacking such support, you need to (re)move those source directories; specifying '--disable' for them does not suffice, unfortunately. Specifically, before running 'configure': - rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm + rm -rf libs/icu libs/graphite2 texk/dvisvgm Also, even with '--disable-all-pkgs', dependencies are (currently) checked. For instance, if a (non-MacOSX) system does not have @@ -165,19 +165,31 @@ wanting to build one, or a subset, of the TeX engines (or other Web2c programs). The simplest way to do this is to disable everything and then -explicitly specify what to make. For example, to build only LuaTeX: - - ./configure --disable-all-pkgs # or ./Build - cd Work/texk/web2c # build directory - make luatex # specify target - - This works because the 'make' automatically runs 'configure' as -necessary for the dependencies and target. Furthermore, the source tree -can be cut down to just what is needed for the given engine (the -separate pdfTeX and LuaTeX source repositories do this, if you want to -peruse examples). - - We hope to improve the situation in the future. Patches are welcome. +explicitly specify what to make. For example, to build only the +original TeX: + + cd Work # top build directory + ../configure --without-x --disable-shared --disable-all-pkgs \ + --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g + make + cd texk/web2c # cd engine build directory + make tex # must specify target + + The first 'make' run will configure everything, and even build the +libraries, even though the packages are disabled. The source tree can +be cut down to just what is needed for the given engine (the separate +pdfTeX and LuaTeX source repositories do this, for example), but see +caveats in previous section. + + If you want to debug an X-related program or shared library setup, or +other variants, change the 'configure' options accordingly. Either +'../Build' or '../configure' can be run. + + Then it is necessary to again specify the target engine ('tex', in +the above) in the 'make'. + + All this is somewhat unfortunate. We hope to improve the situation +in the future. Patches are welcome. 4.7 Cross compilation ===================== diff --git a/Build/source/README.4layout b/Build/source/README.4layout index 64ca8aaf1a4..407c00d98db 100644 --- a/Build/source/README.4layout +++ b/Build/source/README.4layout @@ -28,8 +28,8 @@ many extra hassles, so don't do that, tempting as it may be. Currently the versions we use are: autoconf (GNU Autoconf) 2.69 - automake (GNU automake) 1.16.1 - bison (GNU Bison) 3.5.2 + automake (GNU automake) 1.16.2 + bison (GNU Bison) 3.7.4 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 @@ -504,7 +504,8 @@ In that case, as above, we put the upstream sources into a subdirectory 'configure' in this original '...-src' directory, but only in our own directory; but we do compile using the source files in '...-src'. - So, to summarize the files that we must (usually) create: + So, to summarize the files that must (usually) be created inside a +new TL source directory ('texk/newprog' or 'utils/newprog'): 'ac/withenable.ac' The 'KPSE_ENABLE_PROG' call just explained. @@ -512,37 +513,67 @@ directory; but we do compile using the source files in '...-src'. 'configure.ac' 'Makefile.am' By merging the contents of the original 'configure.ac' (if - provided) and a comparable program already in TL. There is no magic - recipe, it's necessary to think about needs to be done in the - original vs. in TeX Live. + provided) and a comparable program already in TL. In the above + example, one line that will be needed in 'configure.ac' (can be + added before the 'AC_CONFIG_FILES' at the end) is: + + AC_SUBST([NEWPROG_TREE], [newprog-src]) + + and then use '@NEWPROG_TREE@' in 'Makefile.am' where needed. + + In general, there is no magic recipe for this part of the job. + It's necessary to think about what needs to be done in the original + vs. in TeX Live. It's useful to look at the setup for the most + comparable programs already in TL that you can find. It's also + useful to grep the entire 'Build/source' tree for whatever you can + think of to investigate how something is done. Most of the + TL-specific macros are defined in 'Build/source/m4/*'. 'TLpatches/TL-Changes' - Actions taken after getting the original source tree; typically - removal of derived or unused common files. + First actions taken after getting the original source tree; + typically removal of derived or unused common files. 'TLpatches/patch-...' If any changes are needed to the original sources, record the - patches here so they can be applied next time. And send them - upstream so that perhaps they won't have to be. + patches here so they can be applied next time. Also, send them + upstream so that we don't have to maintain them forever. 'ChangeLog' Record all TL-specific changes, now and in the future. - Then, run GNU 'autoreconf' in the new directory (*note Build system -tools::). After that works, '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 not have to run any autotools, but can simply run -'configure'.) - - Then, run the TL tool 'reautoconf' in the top-level TL 'source/' -directory, to incorporate the new program into the build tree. - - Then, run (and rerun) a build until the program compiles and tests -successfully, probably involving rerunning autoreconf in the source -directory, 'make' in the build directory, etc. - - After final success, don't forget to commit. + 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 +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 +not have to run any autotools, but can simply run 'configure'.) + + To reiterate: do not fail to commit the generated 'configure' and +other files. The m4 code in 'kpse-pkgs.m4' uses the existence of +'configure' to determine whether to descend into (and configure) a given +subdirectory. + + Then, run the TL tool 'reautoconf' in the top-level TL +'Build/source/' directory, to incorporate the new program into the build +tree. It is good to then rebuild the whole tree (e.g., using TL's +'Build/Build' script) to get all the necessary files generated. + + It will probably fail. So then you need to keep at it until the +program compiles and tests successfully. The most efficient way is to +rerun 'autoreconf' as needed in the new source directory +('Build/source/.../newprog'), then 'make' in the corresponding build +directory ('Build/work/.../newprog'), then 'make check', etc. In the +end, also make sure that the whole tree builds from scratch. + + After final success, don't forget to commit. (Or email the TL +maintainers with the patch.) + + Caveat: adding a new TeX engine is not completely different, but it's +not all that similar, either. In that case, the work is done inside a +new subdirectory of 'texk/web2c/'. Many things are common to all the +engines, other things need to be copied and possibly modified for each +one, yet others are unique to each. No general recipe is possible. 6.6.2 Adding a new generic library module ----------------------------------------- diff --git a/Build/source/README.5configure b/Build/source/README.5configure index b1e00daac07..0959a4c547b 100644 --- a/Build/source/README.5configure +++ b/Build/source/README.5configure @@ -71,9 +71,7 @@ of 'DVI' and 'GF' files must always be <2GB, due to the file format specifications. With LFS, there is no fixed limit on the size of PDF files created by -'pdftex' or PostScript files created by 'dvips'. The size of PDF images -included by 'pdftex' or 'luatex' must, however, be <2GB when using -'poppler' version 0.22 or before (even on 64-bit systems with LFS). +'pdftex' or PostScript files created by 'dvips'. 7.1.4 '--disable-missing' ------------------------- @@ -362,21 +360,6 @@ is one of: to generate the specified type of file dynamically. The default can be overridden by the user in any case (*note kpathsea library::). -7.3.2 Configure options for system 'poppler' --------------------------------------------- - -Building XeTeX requires 'poppler', either from the TL tree or system -headers and library. Building pdfTeX requires either 'xpdf' from the -TeX Live tree or system 'poppler' headers and library. - -'--with-system-poppler' -Use a system version (0.18 or newer) of 'poppler' for LuaTeX (or -LuaJITTeX) and XeTeX, and use 'pkg-config' to obtain the required flags. - -'--with-system-xpdf' -Use a system version (0.12 or newer) of 'poppler' (and 'pkg-config') for -pdfTeX instead of 'xpdf' from the TL tree. *Note --disable-largefile::. - 7.4 Variables for configure =========================== diff --git a/Build/source/doc/tlbuild-incl/install-tl.texi b/Build/source/doc/tlbuild-incl/install-tl.texi index 6e0e4d00997..79876653eef 100644 --- a/Build/source/doc/tlbuild-incl/install-tl.texi +++ b/Build/source/doc/tlbuild-incl/install-tl.texi @@ -81,46 +81,24 @@ following modules are supported: @item @code{text} @anchor{install-tl @code{text}} -The text mode user interface (default on Unix systems). Same as the -@code{-no-gui} option. +The text mode user interface (default on Unix systems, including Macs). +Same as the @code{-no-gui} option. -@item @code{tcl} -@anchor{install-tl @code{tcl}} +@item @code{tcl} (or "perltk" or "wizard" or "expert" or nothing) +@anchor{install-tl @code{tcl} (or "perltk" or "wizard" or "expert" or nothing)} -The Tcl/Tk user interface (default on Macs and Windows). It starts +The Tcl/Tk user interface (default on Windows). It starts with a small number of configuration options, roughly equivalent -to what the wizard option below offers, but a button @code{Advanced} -takes you to a screen with roughly the same options as the @code{perltk} -interface. - -@item @code{wizard} -@anchor{install-tl @code{wizard}} - -The wizard mode user interface, asking only minimal questions before -installing all of TeX Live. - -@item @code{expert} -@anchor{install-tl @code{expert}} - -A generic name for, currently, @code{perltk}; it may select a different GUI -in the future. - -@item @code{perltk} -@anchor{install-tl @code{perltk}} - -The expert GUI installer, providing access to more options. +to what the former wizard option offers, but a button @code{Advanced} +takes you to a screen with roughly the same options as the former +@code{perltk} interface. @end table -The @code{perltk} and @code{wizard} modules require the Perl/Tk module -(@url{https://tug.org/texlive/distro.html#perltk}). if Perl/Tk is not -available, installation continues in text mode, except on Windows, -where all gui options except @code{text} are diverted to the default -@code{tcl} GUI. - -The @code{tcl} GUI requires Tcl/Tk. This is standard on Macs and is often -already installed on GNU/Linux. For Windows, TeX Live provides a Tcl/Tk -runtime. +The default GUI requires Tcl/Tk. This is standard on Macs (although it +is considered deprecated since Catalina) and is often already installed +on GNU/Linux, or can be easily installed through a distro package +manager. For Windows, TeX Live provides a Tcl/Tk runtime. @item @strong{-no-gui} @anchor{install-tl @strong{-no-gui}} @@ -130,10 +108,8 @@ Use the text mode installer (default except on Windows and Macs). @item @strong{-lang} @emph{llcode} @anchor{install-tl @strong{-lang} @emph{llcode}} -By default, the GUI tries to deduce your language from the -environment. The Tcl GUI uses the language detection built into -Tcl/Tk; the Perl/Tk GUIs use the @code{LC_MESSAGES} environment -variable. If that fails you can select a different language by +By default, the Tcl GUI uses the language detection built into +Tcl/Tk. If that fails you can select a different language by giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), Italian @@ -165,8 +141,8 @@ will be adjusted accordingly. @anchor{install-tl @strong{-select-repository}} This option allows you to choose a particular mirror from the current -list of active CTAN mirrors. This option is supported in the @code{text}, -@code{wizard} and @code{perltk} installer modes, and will also offer to install +list of active CTAN mirrors. This option is supported in the @code{text} +and @code{gui} installer modes, and will also offer to install from local media if available, or from a repository specified on the command line. It's useful when the (default) automatic redirection does not choose a good host for you. @@ -199,9 +175,10 @@ building TeX Live, see @url{https://tug.org/texlive/build.html}. @item @strong{-debug-translation} @anchor{install-tl @strong{-debug-translation}} -In the Perl/Tk GUI modes, this option reports any missing, or more -likely untranslated, messages to standard error. Helpful for -translators to see what remains to be done. +In the former Perl/Tk GUI modes, this option reported any missing, +or more likely untranslated, messages to standard error. Not yet +implemented for the Tcl interface. Helpful for translators to see +what remains to be done. @item @strong{-force-platform} @emph{platform} @anchor{install-tl @strong{-force-platform} @emph{platform}} @@ -517,8 +494,8 @@ variables. Omit creating the ConTeXt cache. This is useful for redistributors. -@item @code{TEXLIVE_INSTALL_NO_IMPORT} -@anchor{install-tl @code{TEXLIVE_INSTALL_NO_IMPORT}} +@item @code{TEXLIVE_INSTALL_NO_RESUME} +@anchor{install-tl @code{TEXLIVE_INSTALL_NO_RESUME}} Omit check for installing on top of a previous installation and then asking about importing previous settings. @@ -529,6 +506,12 @@ asking about importing previous settings. Omit printing the welcome message after successful installation, e.g., when testing. +@item @code{TEXLIVE_INSTALL_PAPER} +@anchor{install-tl @code{TEXLIVE_INSTALL_PAPER}} + +Set the default paper size for all relevant programs; must be either +@code{letter} or @code{a4}. The default is @code{a4}. + @item @code{TEXLIVE_INSTALL_PREFIX} @anchor{install-tl @code{TEXLIVE_INSTALL_PREFIX}} @@ -573,5 +556,5 @@ This script and its documentation were written for the TeX Live distribution (@url{https://tug.org/texlive}) and both are licensed under the GNU General Public License Version 2 or later. -$Id: install-tl 54143 2020-03-06 23:51:18Z karl $ +$Id: install-tl 57970 2021-02-27 14:17:34Z siepo $ diff --git a/Build/source/doc/tlbuild-incl/tlmgr.texi b/Build/source/doc/tlbuild-incl/tlmgr.texi index 690b33848d6..45a1011100c 100644 --- a/Build/source/doc/tlbuild-incl/tlmgr.texi +++ b/Build/source/doc/tlbuild-incl/tlmgr.texi @@ -244,6 +244,14 @@ necessarily completely translated) are: @w{English (en, default)}, tlshell shares its message catalog with tlmgr. +@item @strong{--command-logfile} @emph{file} +@anchor{tlmgr @strong{--command-logfile} @emph{file}} + +@code{tlmgr} logs the output of all programs invoked (mktexlr, mtxrun, fmtutil, +updmap) to a separate log file, by default +@code{TEXMFSYSVAR/web2c/tlmgr-commands.log}. This option allows you to specify a +different file for the log. + @item @strong{--debug-translation} @anchor{tlmgr @strong{--debug-translation}} @@ -832,21 +840,36 @@ is available in a remote repository using @anchor{tlmgr @strong{--data @code{item1@comma{}item2@comma{}...}}} If the option @code{--data} is given, its argument must be a comma separated -list of field names from: @code{name}, @code{category}, @code{localrev}, @code{remoterev}, -@code{shortdesc}, @code{longdesc}, @code{installed}, @code{size}, @code{relocatable}, @code{depends}, -@code{cat-version}, @code{cat-date}, or @code{cat-license}. In this case the requested -packages' information is listed in CSV format one package per line, and the -column information is given by the @code{itemN}. The @code{depends} column contains -the name of all dependencies separated by @code{:}. +list of field names from: @code{name}, @code{category}, @code{localrev}, +@code{remoterev}, @code{shortdesc}, @code{longdesc}, @code{installed}, @code{size}, +@code{relocatable}, @code{depends}, @code{cat-version}, @code{cat-date}, @code{cat-license}, +plus various @code{cat-contact-*} fields (see below). + +The @code{cat-*} fields all come from the TeX Catalogue +(@url{https://ctan.org/pkg/catalogue}). For each, there are two more +variants with prefix @code{l} and @code{r}, e.g., @code{lcat-version} and +@code{rcat-version}, which indicate the local and remote information, +respectively. The variants without @code{l} and @code{r} show the most current +one, which is normally the remote value. + +The requested packages' information is listed in CSV format, one package +per line, and the column information is given by the @code{itemN}. The +@code{depends} column contains the names of all the dependencies separated +by @code{:} characters. + +At this writing, the @code{cat-contact-*} fields include: @code{home}, +@code{repository}, @code{support}, @code{bugs}, @code{announce}, @code{development}. Each +may be empty or a url value. A brief description is on the CTAN upload +page for new packages: @url{https://ctan.org/upload}. @item @strong{--json} @anchor{tlmgr @strong{--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 -@code{tlpkg/doc/JSON-formats.txt}, format definition: @code{TLPOBJINFO}. -If both @code{--json} and @code{--data} are given, @code{--json} takes precedence. +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 +@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 @@ -1842,12 +1865,12 @@ If the package on the server is older than the package already installed (e.g., if the selected mirror is out of date), @code{tlmgr} does not downgrade. Also, packages for uninstalled platforms are not installed. -@code{tlmgr} saves a copy of the @code{texlive.tlpdb} file used for an update -with a suffix representing the repository url, as in -@code{tlpkg/texlive.tlpdb.}@emph{long-hash-string}. These can be useful for -fallback information, but if you don't like them accumulating (e.g., -@code{mirror.ctan.org} resolves to many different hosts, each resulting in -a possibly different hash), it's harmless to delete them. +@code{tlmgr} saves one copy of the main @code{texlive.tlpdb} file used for an +update with a suffix representing the repository url, as in +@code{tlpkg/texlive.tlpdb.main.}@emph{long-hash-string}. Thus, even when many +mirrors are used, only one main @code{tlpdb} backup is kept. For non-main +repositories, which do not generally have (m)any mirrors, no pruning of +backups is done. This action does not automatically add or remove new symlinks in system directories; you need to run @code{tlmgr} @ref{tlmgr path,, path} yourself if you are using @@ -1897,6 +1920,9 @@ The allowed keys are: @item @code{require-verification}, value 0 or 1 (default 0), same as command-line option. @anchor{tlmgr @code{require-verification}@comma{} value 0 or 1 (default 0)@comma{} same as command-line option.} +@item @code{tkfontscale}, value any float. Controls the scaling of fonts in the Tk based frontends. +@anchor{tlmgr @code{tkfontscale}@comma{} value any float. Controls the scaling of fonts in the Tk based frontends.} + @item @code{update-exclude}, value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}. @anchor{tlmgr @code{update-exclude}@comma{} value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}.} @@ -2738,5 +2764,5 @@ This script and its documentation were written for the TeX Live distribution (@url{https://tug.org/texlive}) and both are licensed under the GNU General Public License Version 2 or later. -$Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ +$Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $ diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info index 6adbef66513..2a386027bc7 100644 --- a/Build/source/doc/tlbuild.info +++ b/Build/source/doc/tlbuild.info @@ -1,4 +1,4 @@ -This is tlbuild.info, produced by makeinfo version 5.1 from +This is tlbuild.info, produced by makeinfo version 6.7 from tlbuild.texi. This file documents the TeX Live build system and more. @@ -322,8 +322,8 @@ File: tlbuild.info, Node: Build one package, Next: Build one engine, Prev: Bu ===================== To build one package, the basic idea is to use the 'configure' option -'--disable-all-pkgs' (*note '--disable-all-pkgs'::). Then all program -and library modules are configured but none are made. However, the +'--disable-all-pkgs' (*note --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 required libraries. @@ -1050,13 +1050,13 @@ structure and variation. * Menu: -* 'png' library:: 'libs/libpng' -* 'zlib' library:: 'libs/zlib' -* 'freetype' library:: 'libs/freetype2' -* 'kpathsea' library:: 'texk/kpathsea' +* png library:: 'libs/libpng' +* zlib library:: 'libs/zlib' +* freetype library:: 'libs/freetype2' +* kpathsea library:: 'texk/kpathsea'  -File: tlbuild.info, Node: 'png' library, Next: 'zlib' library, Up: Library modules +File: tlbuild.info, Node: png library, Next: zlib library, Up: Library modules 6.4.1 The 'png' library in 'libs/libpng' ---------------------------------------- @@ -1112,7 +1112,7 @@ the 'make' rules to rebuild the library. flags required for the system library.  -File: tlbuild.info, Node: 'zlib' library, Next: 'freetype' library, Prev: 'png' library, Up: Library modules +File: tlbuild.info, Node: zlib library, Next: freetype library, Prev: png library, Up: Library modules 6.4.2 The 'zlib' library in 'libs/zlib' --------------------------------------- @@ -1124,7 +1124,7 @@ supplies the configure option '--with-system-zlib', as well as locations of the 'zlib' headers and/or library.  -File: tlbuild.info, Node: 'freetype' library, Next: 'kpathsea' library, Prev: 'zlib' library, Up: Library modules +File: tlbuild.info, Node: freetype library, Next: kpathsea library, Prev: zlib library, Up: Library modules 6.4.3 The 'freetype' library in 'libs/freetype2' ------------------------------------------------ @@ -1140,7 +1140,7 @@ system provided by upstream (possibly patched). 'freetype-config'.  -File: tlbuild.info, Node: 'kpathsea' library, Prev: 'freetype' library, Up: Library modules +File: tlbuild.info, Node: kpathsea library, Prev: freetype library, Up: Library modules 6.4.4 The 'kpathsea' library in 'texk/kpathsea' ----------------------------------------------- @@ -1178,13 +1178,13 @@ for a few of the programs in TL. * Menu: -* 't1utils' package:: 'utils/t1utils' -* 'xindy' package:: 'utils/xindy' -* 'xdvik' package:: 'texk/xdvik' -* 'asymptote':: 'utils/asymptote' +* t1utils package:: 'utils/t1utils' +* xindy package:: 'utils/xindy' +* xdvik package:: 'texk/xdvik' +* asymptote:: 'utils/asymptote'  -File: tlbuild.info, Node: 't1utils' package, Next: 'xindy' package, Up: Program modules +File: tlbuild.info, Node: t1utils package, Next: xindy package, Up: Program modules 6.5.1 The 't1utils' package in 'utils/t1utils' ---------------------------------------------- @@ -1200,7 +1200,7 @@ specifying the module name without any dependencies, and supplies the configure option '--disable-t1utils'.  -File: tlbuild.info, Node: 'xindy' package, Next: 'xdvik' package, Prev: 't1utils' package, Up: Program modules +File: tlbuild.info, Node: xindy package, Next: xdvik package, Prev: t1utils package, Up: Program modules 6.5.2 The 'xindy' package in 'utils/xindy' ------------------------------------------ @@ -1226,7 +1226,7 @@ built if explicitly enabled by the user with 'configure --enable-xindy' included by 'configure.ac'.  -File: tlbuild.info, Node: 'xdvik' package, Next: 'asymptote', Prev: 'xindy' package, Up: Program modules +File: tlbuild.info, Node: xdvik package, Next: asymptote, Prev: xindy package, Up: Program modules 6.5.3 The 'xdvik' package in 'texk/xdvik' ----------------------------------------- @@ -1251,7 +1251,7 @@ system whereas the auxiliary program 'squeeze/squeeze' has to run on the also seen at the top level.  -File: tlbuild.info, Node: 'asymptote', Prev: 'xdvik' package, Up: Program modules +File: tlbuild.info, Node: asymptote, Prev: xdvik package, Up: Program modules 6.5.4 The subdirectory 'utils/asymptote' ---------------------------------------- @@ -1499,21 +1499,21 @@ Here are the global configure options. * Menu: -* '--disable-native-texlive-build':: -* '--prefix' '--bindir' ...:: -* '--disable-largefile':: -* '--disable-missing':: -* '--enable-compiler-warnings='LEVEL:: -* '--enable-cxx-runtime-hack':: -* '--enable-maintainer-mode':: -* '--enable-multiplatform':: -* '--enable-shared':: -* '--enable-silent-rules':: -* '--without-ln-s':: -* '--without-x':: +* --disable-native-texlive-build:: +* --prefix --bindir ...:: +* --disable-largefile:: +* --disable-missing:: +* --enable-compiler-warnings=LEVEL:: +* --enable-cxx-runtime-hack:: +* --enable-maintainer-mode:: +* --enable-multiplatform:: +* --enable-shared:: +* --enable-silent-rules:: +* --without-ln-s:: +* --without-x::  -File: tlbuild.info, Node: '--disable-native-texlive-build', Next: '--prefix' '--bindir' ..., Up: Global configure options +File: tlbuild.info, Node: --disable-native-texlive-build, Next: --prefix --bindir ..., Up: Global configure options 7.1.1 '--disable-native-texlive-build' -------------------------------------- @@ -1534,7 +1534,7 @@ also be built independently from the TL tree (such as 'utils/xindy' and TL-specific adaptations, such as installation paths.  -File: tlbuild.info, Node: '--prefix' '--bindir' ..., Next: '--disable-largefile', Prev: '--disable-native-texlive-build', Up: Global configure options +File: tlbuild.info, Node: --prefix --bindir ..., Next: --disable-largefile, Prev: --disable-native-texlive-build, Up: Global configure options 7.1.2 '--prefix', '--bindir', ... --------------------------------- @@ -1547,7 +1547,7 @@ set, on the 'make' command line (*note Installation in a temporary location: (automake)Staged Installs.).  -File: tlbuild.info, Node: '--disable-largefile', Next: '--disable-missing', Prev: '--prefix' '--bindir' ..., Up: Global configure options +File: tlbuild.info, Node: --disable-largefile, Next: --disable-missing, Prev: --prefix --bindir ..., Up: Global configure options 7.1.3 '--disable-largefile' --------------------------- @@ -1561,7 +1561,7 @@ specifications. 'pdftex' or PostScript files created by 'dvips'.  -File: tlbuild.info, Node: '--disable-missing', Next: '--enable-compiler-warnings='LEVEL, Prev: '--disable-largefile', Up: Global configure options +File: tlbuild.info, Node: --disable-missing, Next: --enable-compiler-warnings=LEVEL, Prev: --disable-largefile, Up: Global configure options 7.1.4 '--disable-missing' ------------------------- @@ -1571,7 +1571,7 @@ feature must be disabled, e.g., due to missing libraries. This can help when figuring out a specific (sub)set of modules to enable.  -File: tlbuild.info, Node: '--enable-compiler-warnings='LEVEL, Next: '--enable-cxx-runtime-hack', Prev: '--disable-missing', Up: Global configure options +File: tlbuild.info, Node: --enable-compiler-warnings=LEVEL, Next: --enable-cxx-runtime-hack, Prev: --disable-missing, Up: Global configure options 7.1.5 '--enable-compiler-warnings='LEVEL ---------------------------------------- @@ -1584,7 +1584,7 @@ variables are not consistently used in all library and program modules. At present, these warning flags assume options from the GNU compilers.  -File: tlbuild.info, Node: '--enable-cxx-runtime-hack', Next: '--enable-maintainer-mode', Prev: '--enable-compiler-warnings='LEVEL, Up: Global configure options +File: tlbuild.info, Node: --enable-cxx-runtime-hack, Next: --enable-maintainer-mode, Prev: --enable-compiler-warnings=LEVEL, Up: Global configure options 7.1.6 '--enable-cxx-runtime-hack' --------------------------------- @@ -1594,7 +1594,7 @@ statically link with 'libstdc++', thus improving portability of the resulting binary. *Note Macros for compilers::.  -File: tlbuild.info, Node: '--enable-maintainer-mode', Next: '--enable-multiplatform', Prev: '--enable-cxx-runtime-hack', Up: Global configure options +File: tlbuild.info, Node: --enable-maintainer-mode, Next: --enable-multiplatform, Prev: --enable-cxx-runtime-hack, Up: Global configure options 7.1.7 '--enable-maintainer-mode' -------------------------------- @@ -1606,7 +1606,7 @@ rebuilds infrastructure files as needed. *Note 'missing' and 'AM_MAINTAINER_MODE': (automake)maintainer-mode.  -File: tlbuild.info, Node: '--enable-multiplatform', Next: '--enable-shared', Prev: '--enable-maintainer-mode', Up: Global configure options +File: tlbuild.info, Node: --enable-multiplatform, Next: --enable-shared, Prev: --enable-maintainer-mode, Up: Global configure options 7.1.8 '--enable-multiplatform' ------------------------------ @@ -1619,7 +1619,7 @@ the values for 'bindir' and 'libdir' are automatically propagated to all subdirectories.  -File: tlbuild.info, Node: '--enable-shared', Next: '--enable-silent-rules', Prev: '--enable-multiplatform', Up: Global configure options +File: tlbuild.info, Node: --enable-shared, Next: --enable-silent-rules, Prev: --enable-multiplatform, Up: Global configure options 7.1.9 '--enable-shared' ----------------------- @@ -1629,7 +1629,7 @@ Build shared versions of the TeX-specific libraries such as '--disable-native-texlive-build' must also be specified).  -File: tlbuild.info, Node: '--enable-silent-rules', Next: '--without-ln-s', Prev: '--enable-shared', Up: Global configure options +File: tlbuild.info, Node: --enable-silent-rules, Next: --without-ln-s, Prev: --enable-shared, Up: Global configure options 7.1.10 '--enable-silent-rules' ------------------------------ @@ -1640,7 +1640,7 @@ can specify 'V=1' on the 'make' command line to get more verbosity, or 'V=0' to get less, regardless of this option.  -File: tlbuild.info, Node: '--without-ln-s', Next: '--without-x', Prev: '--enable-silent-rules', Up: Global configure options +File: tlbuild.info, Node: --without-ln-s, Next: --without-x, Prev: --enable-silent-rules, Up: Global configure options 7.1.11 '--without-ln-s' ----------------------- @@ -1650,7 +1650,7 @@ for a Unix-like system. However, 'make install' will not create anything useful, and might fail.  -File: tlbuild.info, Node: '--without-x', Prev: '--without-ln-s', Up: Global configure options +File: tlbuild.info, Node: --without-x, Prev: --without-ln-s, Up: Global configure options 7.1.12 '--without-x' -------------------- @@ -1667,18 +1667,18 @@ Here are (some of) the program-specific 'configure' options. * Menu: -* '--enable-PROG' '--disable-PROG':: -* '--disable-all-pkgs':: -* Configure options for 'texk/web2c':: -* Configure options for 'texk/bibtex-x':: -* Configure options for 'texk/dvipdfm-x':: -* Configure options for 'texk/dvisvgm':: -* Configure options for 'texk/texlive':: -* Configure options for 'texk/xdvik':: -* Configure options for 'utils/xindy':: +* --enable-PROG --disable-PROG:: +* --disable-all-pkgs:: +* Configure options for texk/web2c:: +* Configure options for texk/bibtex-x:: +* Configure options for texk/dvipdfm-x:: +* Configure options for texk/dvisvgm:: +* Configure options for texk/texlive:: +* Configure options for texk/xdvik:: +* Configure options for utils/xindy::  -File: tlbuild.info, Node: '--enable-PROG' '--disable-PROG', Next: '--disable-all-pkgs', Up: Program-specific configure options +File: tlbuild.info, Node: --enable-PROG --disable-PROG, Next: --disable-all-pkgs, Up: Program-specific configure options 7.2.1 '--enable-PROG', '--disable-PROG' --------------------------------------- @@ -1686,7 +1686,7 @@ File: tlbuild.info, Node: '--enable-PROG' '--disable-PROG', Next: '--disable-a Do or do not build and install the program(s) of module 'PROG'.  -File: tlbuild.info, Node: '--disable-all-pkgs', Next: Configure options for 'texk/web2c', Prev: '--enable-PROG' '--disable-PROG', Up: Program-specific configure options +File: tlbuild.info, Node: --disable-all-pkgs, Next: Configure options for texk/web2c, Prev: --enable-PROG --disable-PROG, Up: Program-specific configure options 7.2.2 '--disable-all-pkgs' -------------------------- @@ -1703,7 +1703,7 @@ explicitly disabled or specify 'disable' in their 'ac/withenable.ac' fragment.  -File: tlbuild.info, Node: Configure options for 'texk/web2c', Next: Configure options for 'texk/bibtex-x', Prev: '--disable-all-pkgs', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/web2c, Next: Configure options for texk/bibtex-x, Prev: --disable-all-pkgs, Up: Program-specific configure options 7.2.3 Configure options for 'texk/web2c' ---------------------------------------- @@ -1770,7 +1770,7 @@ native TeX Live build. Defaults are defined in Do not build the 'SyncTeX' library and tool.  -File: tlbuild.info, Node: Configure options for 'texk/bibtex-x', Next: Configure options for 'texk/dvipdfm-x', Prev: Configure options for 'texk/web2c', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/bibtex-x, Next: Configure options for texk/dvipdfm-x, Prev: Configure options for texk/web2c, Up: Program-specific configure options 7.2.4 Configure options for 'texk/bibtex-x' ------------------------------------------- @@ -1786,7 +1786,7 @@ Do not build the 'bibtexu' program (building 'bibtexu' requires 'ICU' libraries).  -File: tlbuild.info, Node: Configure options for 'texk/dvipdfm-x', Next: Configure options for 'texk/dvisvgm', Prev: Configure options for 'texk/bibtex-x', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/dvipdfm-x, Next: Configure options for texk/dvisvgm, Prev: Configure options for texk/bibtex-x, Up: Program-specific configure options 7.2.5 Configure options for 'texk/dvipdfm-x' -------------------------------------------- @@ -1804,7 +1804,7 @@ Do not build the 'dvipdfmx' program or make the 'dvipdfm' symlink. Do not build the 'xdvipdfmx' program.  -File: tlbuild.info, Node: Configure options for 'texk/dvisvgm', Next: Configure options for 'texk/texlive', Prev: Configure options for 'texk/dvipdfm-x', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/dvisvgm, Next: Configure options for texk/texlive, Prev: Configure options for texk/dvipdfm-x, Up: Program-specific configure options 7.2.6 Configure options for 'texk/dvisvgm' ------------------------------------------ @@ -1824,7 +1824,7 @@ result can crash due to library incompatibilities, e.g., on CentOS 5. Specify non-standard locations of the Ghostscript headers and library.  -File: tlbuild.info, Node: Configure options for 'texk/texlive', Next: Configure options for 'texk/xdvik', Prev: Configure options for 'texk/dvisvgm', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/texlive, Next: Configure options for texk/xdvik, Prev: Configure options for texk/dvisvgm, Up: Program-specific configure options 7.2.7 Configure options for 'texk/texlive' ------------------------------------------ @@ -1834,7 +1834,7 @@ Do not install the "linked scripts" (*note Linked scripts::), except for the TL scripts required to run 'texlinks'.  -File: tlbuild.info, Node: Configure options for 'texk/xdvik', Next: Configure options for 'utils/xindy', Prev: Configure options for 'texk/texlive', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for texk/xdvik, Next: Configure options for utils/xindy, Prev: Configure options for texk/texlive, Up: Program-specific configure options 7.2.8 Configure options for 'texk/xdvik' ---------------------------------------- @@ -1851,7 +1851,7 @@ Use XInput 2.1 "smooth scrolling" if available (default: yes, except for a native TL build).  -File: tlbuild.info, Node: Configure options for 'utils/xindy', Prev: Configure options for 'texk/xdvik', Up: Program-specific configure options +File: tlbuild.info, Node: Configure options for utils/xindy, Prev: Configure options for texk/xdvik, Up: Program-specific configure options 7.2.9 Configure options for 'utils/xindy' ----------------------------------------- @@ -1897,10 +1897,10 @@ required system libraries and bails out if tests fail. * Menu: -* Configure options for 'kpathsea':: +* Configure options for kpathsea::  -File: tlbuild.info, Node: Configure options for 'kpathsea', Up: Library-specific configure options +File: tlbuild.info, Node: Configure options for kpathsea, Up: Library-specific configure options 7.3.1 Configure options for 'kpathsea' -------------------------------------- @@ -1924,7 +1924,7 @@ is one of: (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 (*note kpathsea library::).  File: tlbuild.info, Node: Variables for configure, Prev: Library-specific configure options, Up: Configure options @@ -2300,40 +2300,22 @@ by either a space or '='. 'text' - The text mode user interface (default on Unix systems). Same - as the '-no-gui' option. + The text mode user interface (default on Unix systems, + including Macs). Same as the '-no-gui' option. - 'tcl' + 'tcl' (or "perltk" or "wizard" or "expert" or nothing) - The Tcl/Tk user interface (default on Macs and Windows). It - starts with a small number of configuration options, roughly - equivalent to what the wizard option below offers, but a + The Tcl/Tk user interface (default on Windows). It starts + with a small number of configuration options, roughly + equivalent to what the former wizard option offers, but a button 'Advanced' takes you to a screen with roughly the same - options as the 'perltk' interface. + options as the former 'perltk' interface. - 'wizard' - - The wizard mode user interface, asking only minimal questions - before installing all of TeX Live. - - 'expert' - - A generic name for, currently, 'perltk'; it may select a - different GUI in the future. - - 'perltk' - - The expert GUI installer, providing access to more options. - - The 'perltk' and 'wizard' modules require the Perl/Tk module - (). if Perl/Tk is not - available, installation continues in text mode, except on Windows, - where all gui options except 'text' are diverted to the default - 'tcl' GUI. - - The 'tcl' GUI requires Tcl/Tk. This is standard on Macs and is - often already installed on GNU/Linux. For Windows, TeX Live - provides a Tcl/Tk runtime. + The default GUI requires Tcl/Tk. This is standard on Macs + (although it is considered deprecated since Catalina) and is often + already installed on GNU/Linux, or can be easily installed through + a distro package manager. For Windows, TeX Live provides a Tcl/Tk + runtime. *-no-gui* @@ -2341,10 +2323,8 @@ by either a space or '='. *-lang* _llcode_ - By default, the GUI tries to deduce your language from the - environment. The Tcl GUI uses the language detection built into - Tcl/Tk; the Perl/Tk GUIs use the 'LC_MESSAGES' environment - variable. If that fails you can select a different language by + By default, the Tcl GUI uses the language detection built into + Tcl/Tk. If that fails you can select a different language by giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), @@ -2375,11 +2355,10 @@ by either a space or '='. This option allows you to choose a particular mirror from the current list of active CTAN mirrors. This option is supported in - the 'text', 'wizard' and 'perltk' installer modes, and will also - offer to install from local media if available, or from a - repository specified on the command line. It's useful when the - (default) automatic redirection does not choose a good host for - you. + the 'text' and 'gui' installer modes, and will also offer to + install from local media if available, or from a repository + specified on the command line. It's useful when the (default) + automatic redirection does not choose a good host for you. *-all-options* @@ -2406,9 +2385,10 @@ by either a space or '='. *-debug-translation* - In the Perl/Tk GUI modes, this option reports any missing, or more - likely untranslated, messages to standard error. Helpful for - translators to see what remains to be done. + In the former Perl/Tk GUI modes, this option reported any missing, + or more likely untranslated, messages to standard error. Not yet + implemented for the Tcl interface. Helpful for translators to see + what remains to be done. *-force-platform* _platform_ @@ -2697,7 +2677,7 @@ user installations. Omit creating the ConTeXt cache. This is useful for redistributors. -'TEXLIVE_INSTALL_NO_IMPORT' +'TEXLIVE_INSTALL_NO_RESUME' Omit check for installing on top of a previous installation and then asking about importing previous settings. @@ -2707,6 +2687,11 @@ user installations. Omit printing the welcome message after successful installation, e.g., when testing. +'TEXLIVE_INSTALL_PAPER' + + Set the default paper size for all relevant programs; must be + either 'letter' or 'a4'. The default is 'a4'. + 'TEXLIVE_INSTALL_PREFIX' 'TEXLIVE_INSTALL_TEXDIR' @@ -2744,7 +2729,7 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the GNU General Public License Version 2 or later. - $Id: install-tl 54143 2020-03-06 23:51:18Z karl $ + $Id: install-tl 57970 2021-02-27 14:17:34Z siepo $  File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top @@ -2983,6 +2968,13 @@ name and its value. tlshell shares its message catalog with tlmgr. +*-command-logfile* _file_ + + 'tlmgr' logs the output of all programs invoked (mktexlr, mtxrun, + fmtutil, updmap) to a separate log file, by default + 'TEXMFSYSVAR/web2c/tlmgr-commands.log'. This option allows you to + specify a different file for the log. + *-debug-translation* In GUI mode, this switch tells 'tlmgr' to report any untranslated @@ -3529,10 +3521,26 @@ B.6.10 info separated list of field names from: 'name', 'category', 'localrev', 'remoterev', 'shortdesc', 'longdesc', 'installed', 'size', 'relocatable', 'depends', 'cat-version', 'cat-date', - or 'cat-license'. In this case the requested packages' - information is listed in CSV format one package per line, and - the column information is given by the 'itemN'. The 'depends' - column contains the name of all dependencies separated by ':'. + 'cat-license', plus various 'cat-contact-*' fields (see + below). + + The 'cat-*' fields all come from the TeX Catalogue + (). For each, there are two + more variants with prefix 'l' and 'r', e.g., 'lcat-version' + and 'rcat-version', which indicate the local and remote + information, respectively. The variants without 'l' and 'r' + show the most current one, which is normally the remote value. + + The requested packages' information is listed in CSV format, + one package per line, and the column information is given by + the 'itemN'. The 'depends' column contains the names of all + the dependencies separated by ':' characters. + + At this writing, the 'cat-contact-*' fields include: 'home', + 'repository', 'support', 'bugs', 'announce', 'development'. + Each may be empty or a url value. A brief description is on + the CTAN upload page for new packages: + . *-json* @@ -4465,12 +4473,12 @@ installed (e.g., if the selected mirror is out of date), 'tlmgr' does not downgrade. Also, packages for uninstalled platforms are not installed. - 'tlmgr' saves a copy of the 'texlive.tlpdb' file used for an update -with a suffix representing the repository url, as in -'tlpkg/texlive.tlpdb.'_long-hash-string_. These can be useful for -fallback information, but if you don't like them accumulating (e.g., -'mirror.ctan.org' resolves to many different hosts, each resulting in a -possibly different hash), it's harmless to delete them. + 'tlmgr' saves one copy of the main 'texlive.tlpdb' file used for an +update with a suffix representing the repository url, as in +'tlpkg/texlive.tlpdb.main.'_long-hash-string_. Thus, even when many +mirrors are used, only one main 'tlpdb' backup is kept. For non-main +repositories, which do not generally have (m)any mirrors, no pruning of +backups is done. This action does not automatically add or remove new symlinks in system directories; you need to run 'tlmgr' *note path: tlmgr path. @@ -4513,6 +4521,8 @@ ignored. All other lines must look like: 'require-verification', value 0 or 1 (default 0), same as command-line option. +'tkfontscale', value any float. Controls the scaling of fonts in the Tk based frontends. + 'update-exclude', value: comma-separated list of packages (no space allowed). Same as the command line option '--exclude' for the action 'update'. 'verify-downloads', value 0 or 1 (default 1), same as command-line option. @@ -5097,11 +5107,11 @@ _pkg_..., and *note option: tlmgr option. actions. * Menu: -* tlmgr Machine-readable 'update' and 'install' output:: -* tlmgr Machine-readable 'option' output:: +* tlmgr Machine-readable update and install output:: +* tlmgr Machine-readable option output::  -File: tlbuild.info, Node: tlmgr Machine-readable 'update' and 'install' output, Next: tlmgr Machine-readable 'option' output, Up: tlmgr MACHINE-READABLE OUTPUT +File: tlbuild.info, Node: tlmgr Machine-readable update and install output, Next: tlmgr Machine-readable option output, Up: tlmgr MACHINE-READABLE OUTPUT B.12.1 Machine-readable 'update' and 'install' output ----------------------------------------------------- @@ -5219,7 +5229,7 @@ _esttot_ The estimated total time.  -File: tlbuild.info, Node: tlmgr Machine-readable 'option' output, Prev: tlmgr Machine-readable 'update' and 'install' output, Up: tlmgr MACHINE-READABLE OUTPUT +File: tlbuild.info, Node: tlmgr Machine-readable option output, Prev: tlmgr Machine-readable update and install output, Up: tlmgr MACHINE-READABLE OUTPUT B.12.2 Machine-readable 'option' output --------------------------------------- @@ -5329,7 +5339,7 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the GNU General Public License Version 2 or later. - $Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ + $Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $  File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top @@ -5340,115 +5350,113 @@ Index [index] * Menu: -* --bindir configure option: '--prefix' '--bindir' .... +* --bindir configure option: --prefix --bindir .... (line 6) -* --bindir configure option <1>: '--enable-multiplatform'. +* --bindir configure option <1>: --enable-multiplatform. (line 6) * --build=HOST: Cross configuring. (line 6) * --disable-all-packages: Build one package. (line 6) -* --disable-all-pkgs: '--disable-all-pkgs'. - (line 6) -* --disable-bibtex8: Configure options for 'texk/bibtex-x'. +* --disable-all-pkgs: --disable-all-pkgs. (line 6) +* --disable-bibtex8: Configure options for texk/bibtex-x. (line 9) -* --disable-bibtexu: Configure options for 'texk/bibtex-x'. +* --disable-bibtexu: Configure options for texk/bibtex-x. (line 12) -* --disable-dump-share: Configure options for 'texk/web2c'. +* --disable-dump-share: Configure options for texk/web2c. (line 27) -* --disable-dvipdfmx: Configure options for 'texk/dvipdfm-x'. +* --disable-dvipdfmx: Configure options for texk/dvipdfm-x. (line 12) -* --disable-etex-synctex: Configure options for 'texk/web2c'. +* --disable-etex-synctex: Configure options for texk/web2c. (line 59) -* --disable-ipc: Configure options for 'texk/web2c'. +* --disable-ipc: Configure options for texk/web2c. (line 31) -* --disable-largefile: '--disable-largefile'. - (line 6) -* --disable-linked-scripts: Configure options for 'texk/texlive'. +* --disable-largefile: --disable-largefile. (line 6) +* --disable-linked-scripts: Configure options for texk/texlive. (line 6) -* --disable-mf-nowin: Configure options for 'texk/web2c'. +* --disable-mf-nowin: Configure options for texk/web2c. (line 34) -* --disable-missing: '--disable-missing'. (line 6) -* --disable-native-texlive-build: '--disable-native-texlive-build'. +* --disable-missing: --disable-missing. (line 6) +* --disable-native-texlive-build: --disable-native-texlive-build. (line 6) -* --disable-PROG: '--enable-PROG' '--disable-PROG'. +* --disable-PROG: --enable-PROG --disable-PROG. (line 6) -* --disable-synctex: Configure options for 'texk/web2c'. +* --disable-synctex: Configure options for texk/web2c. (line 64) -* --disable-tex: Configure options for 'texk/web2c'. +* --disable-tex: Configure options for texk/web2c. (line 37) -* --disable-web-progs: Configure options for 'texk/web2c'. +* --disable-web-progs: Configure options for texk/web2c. (line 41) -* --disable-xdvipdfmx: Configure options for 'texk/dvipdfm-x'. +* --disable-xdvipdfmx: Configure options for texk/dvipdfm-x. (line 15) -* --enable-*win for Metafont window support: Configure options for 'texk/web2c'. +* --enable-*win for Metafont window support: Configure options for texk/web2c. (line 55) -* --enable-auto-core: Configure options for 'texk/web2c'. +* --enable-auto-core: Configure options for texk/web2c. (line 45) -* --enable-compiler-warnings=LEVEL: '--enable-compiler-warnings='LEVEL. +* --enable-compiler-warnings=LEVEL: --enable-compiler-warnings=LEVEL. (line 6) * --enable-cxx-runtime-hack: Macros for compilers. (line 29) -* --enable-etex: Configure options for 'texk/web2c'. +* --enable-etex: Configure options for texk/web2c. (line 37) -* --enable-libtool-hack: Configure options for 'texk/web2c'. +* --enable-libtool-hack: Configure options for texk/web2c. (line 50) * --enable-maintainer-mode: Build system tools. (line 28) -* --enable-maintainer-mode <1>: '--enable-maintainer-mode'. +* --enable-maintainer-mode <1>: --enable-maintainer-mode. (line 6) * --enable-missing to ignore dependencies: Build one package. (line 71) -* --enable-mktextfm-default: 'kpathsea' library. (line 18) -* --enable-multiplatform: '--enable-multiplatform'. +* --enable-mktextfm-default: kpathsea library. (line 18) +* --enable-multiplatform: --enable-multiplatform. (line 6) -* --enable-PROG: '--enable-PROG' '--disable-PROG'. +* --enable-PROG: --enable-PROG --disable-PROG. (line 6) -* --enable-shared: '--enable-shared'. (line 6) -* --enable-silent-rules: '--enable-silent-rules'. +* --enable-shared: --enable-shared. (line 6) +* --enable-silent-rules: --enable-silent-rules. (line 6) -* --enable-tex-synctex: Configure options for 'texk/web2c'. +* --enable-tex-synctex: Configure options for texk/web2c. (line 59) -* --enable-texlive-build: '--disable-native-texlive-build'. +* --enable-texlive-build: --disable-native-texlive-build. (line 15) -* --enable-xi2-scrolling: Configure options for 'texk/xdvik'. +* --enable-xi2-scrolling: Configure options for texk/xdvik. (line 13) -* --enable-xindy-docs: Configure options for 'utils/xindy'. +* --enable-xindy-docs: Configure options for utils/xindy. (line 10) -* --enable-xindy-rules: Configure options for 'utils/xindy'. +* --enable-xindy-rules: Configure options for utils/xindy. (line 6) * --host=HOST: Cross configuring. (line 6) -* --libdir configure option: '--enable-multiplatform'. +* --libdir configure option: --enable-multiplatform. (line 6) * --no-clean Build option: Build problems. (line 6) -* --prefix configure option: '--prefix' '--bindir' .... +* --prefix configure option: --prefix --bindir .... (line 6) -* --with-banner-add=STR: Configure options for 'texk/web2c'. +* --with-banner-add=STR: Configure options for texk/web2c. (line 6) -* --with-clisp-runtime=FILENAME: Configure options for 'utils/xindy'. +* --with-clisp-runtime=FILENAME: Configure options for utils/xindy. (line 14) -* --with-editor=CMD: Configure options for 'texk/web2c'. +* --with-editor=CMD: Configure options for texk/web2c. (line 11) -* --with-fontconfig-includes=DIR: Configure options for 'texk/web2c'. +* --with-fontconfig-includes=DIR: Configure options for texk/web2c. (line 16) -* --with-fontconfig-libdir=DIR: Configure options for 'texk/web2c'. +* --with-fontconfig-libdir=DIR: Configure options for texk/web2c. (line 16) -* --with-gs=FILENAME: Configure options for 'texk/xdvik'. +* --with-gs=FILENAME: Configure options for texk/xdvik. (line 6) * --with-LIB-includes=DIR, -libdir: Library-specific configure options. (line 16) -* --with-libgs-includes, -libdir: Configure options for 'texk/dvisvgm'. +* --with-libgs-includes, -libdir: Configure options for texk/dvisvgm. (line 17) -* --with-system-kpathsea: 'kpathsea' library. (line 13) +* --with-system-kpathsea: kpathsea library. (line 13) * --with-system-LIB: Adding a new generic library module. (line 34) * --with-system-LIB <1>: Library-specific configure options. (line 9) -* --with-system-libgs: Configure options for 'texk/dvisvgm'. +* --with-system-libgs: Configure options for texk/dvisvgm. (line 6) -* --with-xdvi-x-toolkit: 'xdvik' package. (line 21) -* --with-xdvi-x-toolkit=KIT: Configure options for 'texk/xdvik'. +* --with-xdvi-x-toolkit: xdvik package. (line 21) +* --with-xdvi-x-toolkit=KIT: Configure options for texk/xdvik. (line 9) -* --without-libgs: Configure options for 'texk/dvisvgm'. +* --without-libgs: Configure options for texk/dvisvgm. (line 12) -* --without-ln-s: '--without-ln-s'. (line 6) -* --without-x: '--without-x'. (line 6) +* --without-ln-s: --without-ln-s. (line 6) +* --without-x: --without-x. (line 6) * -C configure option: Build in parallel. (line 11) * -j make option: Build in parallel. (line 6) * ac/withenable.ac: Adding a new program module. @@ -5461,14 +5469,14 @@ Index * adding a new TeX-specific library: Adding a new TeX-specific library module. (line 6) * adding to TeX Live: Extending TeX Live. (line 6) -* 'am/' top-level directory: Top-level directories. +* am/ top-level directory: Top-level directories. (line 14) * ANSI C: Declarations and definitions. (line 6) -* 'ApplicationServices' Mac framework, required by 'xetex': Prerequisites. +* ApplicationServices Mac framework, required by xetex: Prerequisites. (line 31) * asymptote: Linked scripts. (line 23) -* asymptote <1>: 'asymptote'. (line 6) +* asymptote <1>: asymptote. (line 6) * Autoconf: Overview of build system. (line 6) * autoconf macros: Autoconf macros. (line 6) @@ -5477,11 +5485,11 @@ Index * autoreconf, for new program: Adding a new program module. (line 76) * biber: Linked scripts. (line 23) -* bibtex-x: Configure options for 'texk/bibtex-x'. +* bibtex-x: Configure options for texk/bibtex-x. (line 6) -* bibtex8: Configure options for 'texk/bibtex-x'. +* bibtex8: Configure options for texk/bibtex-x. (line 6) -* bibtexu: Configure options for 'texk/bibtex-x'. +* bibtexu: Configure options for texk/bibtex-x. (line 6) * BSD distro: Distro builds. (line 6) * build directory, required: Building. (line 17) @@ -5493,7 +5501,7 @@ Index * Build script: Building. (line 6) * build system, design of: Overview of build system. (line 6) -* 'build-aux/' top-level directory: Top-level directories. +* build-aux/ top-level directory: Top-level directories. (line 30) * BUILDCC, BUILDCFLAGS, ...: Cross configuring. (line 42) * building: Building. (line 6) @@ -5505,8 +5513,8 @@ Index (line 6) * C99, avoided: Declarations and definitions. (line 6) -* cache file, for 'configure': Build in parallel. (line 11) -* cache for 'configure': Build in parallel. (line 6) +* cache file, for configure: Build in parallel. (line 11) +* cache for configure: Build in parallel. (line 6) * callexe.c: Macros for Windows. (line 32) * CC: Variables for configure. (line 10) @@ -5520,43 +5528,43 @@ Index (line 18) * CLISP: Variables for configure. (line 17) -* CLISP <1>: Configure options for 'utils/xindy'. +* CLISP <1>: Configure options for utils/xindy. (line 14) -* 'clisp', required by 'xindy': Prerequisites. (line 35) -* 'Cocoa' Mac framework, required by 'xetex': Prerequisites. (line 31) +* clisp, required by xindy: Prerequisites. (line 35) +* Cocoa Mac framework, required by xetex: Prerequisites. (line 31) * coding conventions: Coding conventions. (line 6) * compilers, C and C++11: Prerequisites. (line 6) * config.guess, config.sub, ...: Top-level directories. (line 30) -* 'configure' options: Configure options. (line 6) -* 'configure' options, for 'bibtex-x': Configure options for 'texk/bibtex-x'. +* configure options: Configure options. (line 6) +* configure options, for bibtex-x: Configure options for texk/bibtex-x. (line 6) -* 'configure' options, for 'dvipdfm-x': Configure options for 'texk/dvipdfm-x'. +* configure options, for dvipdfm-x: Configure options for texk/dvipdfm-x. (line 6) -* 'configure' options, for 'dvisvgm': Configure options for 'texk/dvisvgm'. +* configure options, for dvisvgm: Configure options for texk/dvisvgm. (line 6) -* 'configure' options, for 'kpathsea': Configure options for 'kpathsea'. +* configure options, for kpathsea: Configure options for kpathsea. (line 6) -* 'configure' options, for 'texk/texlive': Configure options for 'texk/texlive'. +* configure options, for texk/texlive: Configure options for texk/texlive. (line 6) -* 'configure' options, for 'web2c': Configure options for 'texk/web2c'. +* configure options, for web2c: Configure options for texk/web2c. (line 6) -* 'configure' options, for 'xdvik': Configure options for 'texk/xdvik'. +* configure options, for xdvik: Configure options for texk/xdvik. (line 6) -* 'configure' options, for 'xindy': Configure options for 'utils/xindy'. +* configure options, for xindy: Configure options for utils/xindy. (line 6) -* 'configure' options, global: Global configure options. +* configure options, global: Global configure options. (line 6) -* 'configure' options, library-specific: Library-specific configure options. +* configure options, library-specific: Library-specific configure options. (line 6) -* 'configure' options, program-specific: Program-specific configure options. +* configure options, program-specific: Program-specific configure options. (line 6) -* 'configure' variables: Variables for configure. +* configure variables: Variables for configure. (line 6) * configure.ac: Adding a new program module. (line 45) * configuring, for cross compilation: Cross configuring. (line 6) -* 'const': Const. (line 6) +* const: Const. (line 6) * continuous integration: Continuous integration. (line 6) * conventions, coding: Coding conventions. (line 6) @@ -5565,7 +5573,7 @@ Index * cross compilation: Cross compilation. (line 6) * cross compilation configuring: Cross configuring. (line 6) * cross compilation problems: Cross problems. (line 6) -* cross compilation, with host binary: 'xdvik' package. (line 14) +* cross compilation, with host binary: xdvik package. (line 14) * ctangle: Cross problems. (line 26) * CXX: Variables for configure. (line 11) @@ -5575,40 +5583,39 @@ Index * declarations before statements, avoiding: Declarations and definitions. (line 6) * dependencies, with several output files: Build in parallel. (line 6) -* DESTDIR: '--prefix' '--bindir' .... +* DESTDIR: --prefix --bindir .... (line 9) * directories, for installation: Installation directories. (line 6) * directories, top-level: Top-level directories. (line 6) * discards qualifiers warning: Const. (line 30) -* 'dist' and 'distcheck' targets for 'make': Build distribution. - (line 6) +* dist and distcheck targets for make: Build distribution. (line 6) * distribution tarball, making: Build distribution. (line 6) * distro, building for: Distro builds. (line 6) -* dvipdfm-x: Configure options for 'texk/dvipdfm-x'. +* dvipdfm-x: Configure options for texk/dvipdfm-x. (line 6) -* dvipdfmx: Configure options for 'texk/dvipdfm-x'. +* dvipdfmx: Configure options for texk/dvipdfm-x. (line 6) -* dvisvgm: Configure options for 'texk/dvisvgm'. +* dvisvgm: Configure options for texk/dvisvgm. (line 6) * engine, adding new: Adding a new program module. (line 104) * engine, building one: Build one engine. (line 6) -* environment variables, for 'configure': Configure options. (line 16) -* exec_prefix: '--enable-multiplatform'. +* environment variables, for configure: Configure options. (line 16) +* exec_prefix: --enable-multiplatform. (line 6) * extending TeX Live: Extending TeX Live. (line 6) -* 'extern' functions: Declarations and definitions. +* extern functions: Declarations and definitions. (line 41) * failure to build: Build problems. (line 6) * flags, macros for library and header: Macros for library and header flags. (line 6) -* 'fontconfig' library, required by 'xetex': Prerequisites. (line 31) +* fontconfig library, required by xetex: Prerequisites. (line 31) * FreeType: Prerequisites. (line 11) -* 'freetype' cross compiling: Cross problems. (line 13) -* freetype library: 'freetype' library. (line 6) -* freetype-config: 'freetype' library. (line 13) +* freetype cross compiling: Cross problems. (line 13) +* freetype library: freetype library. (line 6) +* freetype-config: freetype library. (line 13) * freetype-config <1>: Variables for configure. (line 24) * FT2_CONFIG: Variables for configure. @@ -5618,14 +5625,14 @@ Index (line 6) * generic library module, adding: Adding a new generic library module. (line 6) -* Ghostscript location for Xdvik: Configure options for 'texk/xdvik'. +* Ghostscript location for Xdvik: Configure options for texk/xdvik. (line 6) * git-svn: Transfer from Subversion to Github. (line 6) -* global 'configure' options: Global configure options. +* global configure options: Global configure options. (line 6) -* 'gmake', required: Prerequisites. (line 11) -* GNU 'make', required: Prerequisites. (line 11) +* gmake, required: Prerequisites. (line 11) +* GNU make, required: Prerequisites. (line 11) * GNU tools, needed for building: Build system tools. (line 6) * GNU/Linux distro: Distro builds. (line 6) * Gnulib, used for common files: Top-level directories. @@ -5638,23 +5645,23 @@ Index * ICU_CONFIG: Variables for configure. (line 22) * infrastructure, tools needed for: Build system tools. (line 6) -* 'inst/' top-level directory: Top-level directories. +* inst/ top-level directory: Top-level directories. (line 39) * install-tl, TeX Live installer: Installing. (line 8) * installation directories: Installation directories. (line 6) * installing: Installing. (line 6) -* interprocess communication: Configure options for 'texk/web2c'. +* interprocess communication: Configure options for texk/web2c. (line 31) * introduction: Introduction. (line 6) -* iteration through sources, by 'configure' and 'make': Build iteration. +* iteration through sources, by configure and make: Build iteration. (line 6) -* kpathsea library: 'kpathsea' library. (line 6) -* kpathsea.ac: 'kpathsea' library. (line 18) -* kpse-libpng-flags.m4: 'png' library. (line 46) +* kpathsea library: kpathsea library. (line 6) +* kpathsea.ac: kpathsea library. (line 18) +* kpse-libpng-flags.m4: png library. (line 46) * kpse-pkgs.m4: Overview of build system. (line 30) -* kpse-zlib-flags.m4: 'zlib' library. (line 6) +* kpse-zlib-flags.m4: zlib library. (line 6) * kpsewhich: Variables for configure. (line 30) * KPSEWHICH: Variables for configure. @@ -5693,7 +5700,7 @@ Index (line 8) * KPSE_LIBPNG_FLAGS: Macros for library and header flags. (line 10) -* KPSE_LIBPNG_FLAGS <1>: 'png' library. (line 46) +* KPSE_LIBPNG_FLAGS <1>: png library. (line 46) * kpse_libs_pkgs: Adding a new generic library module. (line 6) * KPSE_LIB_FLAGS: Macros for library and header flags. @@ -5709,10 +5716,10 @@ Index (line 6) * kpse_texlibs_pkgs: Adding a new TeX-specific library module. (line 11) -* KPSE_TRY_LIB: 'png' library. (line 18) +* KPSE_TRY_LIB: png library. (line 18) * KPSE_TRY_LIB <1>: Adding a new generic library module. (line 20) -* KPSE_TRY_LIBXX: 'png' library. (line 31) +* KPSE_TRY_LIBXX: png library. (line 31) * KPSE_TRY_LIBXX <1>: Adding a new generic library module. (line 20) * kpse_utils_pkgs: Adding a new program module. @@ -5722,46 +5729,44 @@ Index (line 11) * KPSE_WITH_TEXLIB: Adding a new TeX-specific library module. (line 14) -* large file support: '--disable-largefile'. - (line 6) +* large file support: --disable-largefile. (line 6) * LATEX: Variables for configure. (line 40) * layout of sources: Layout and infrastructure. (line 6) -* LFS (large file support): '--disable-largefile'. - (line 6) -* libexpat, dependency of 'libfontconfig': Configure options for 'texk/web2c'. +* LFS (large file support): --disable-largefile. (line 6) +* libexpat, dependency of libfontconfig: Configure options for texk/web2c. (line 50) -* libfontconfig, hack for avoiding linking dependencies: Configure options for 'texk/web2c'. +* libfontconfig, hack for avoiding linking dependencies: Configure options for texk/web2c. (line 50) * libfreetype: Variables for configure. (line 24) -* 'libfreetype', and 'const': Const. (line 21) -* libpng library: 'png' library. (line 6) +* libfreetype, and const: Const. (line 21) +* libpng library: png library. (line 6) * library module, generic, adding: Adding a new generic library module. (line 6) * library module, TeX-specific, adding: Adding a new TeX-specific library module. (line 6) * library modules: Library modules. (line 6) -* library-specific 'configure' options: Library-specific configure options. +* library-specific configure options: Library-specific configure options. (line 6) -* 'libsigsegv', required by 'xindy': Prerequisites. (line 35) +* libsigsegv, required by xindy: Prerequisites. (line 35) * libstc++, statically linking: Macros for compilers. (line 29) * Libtool: Overview of build system. (line 6) -* libtool, hack for avoiding excessive linking: Configure options for 'texk/web2c'. +* libtool, hack for avoiding excessive linking: Configure options for texk/web2c. (line 50) -* libXt: Configure options for 'texk/web2c'. +* libXt: Configure options for texk/web2c. (line 22) * linked scripts: Linked scripts. (line 6) * linking C++ libraries statically: Macros for compilers. (line 29) -* lisp.run, lisp.exe: Configure options for 'utils/xindy'. +* lisp.run, lisp.exe: Configure options for utils/xindy. (line 14) -* LittleEndian architectures: Configure options for 'texk/web2c'. +* LittleEndian architectures: Configure options for texk/web2c. (line 27) -* 'm4/' top-level directory: Top-level directories. +* m4/ top-level directory: Top-level directories. (line 14) * macros, for compilers: Macros for compilers. (line 6) @@ -5776,19 +5781,19 @@ Index * MAKE: Variables for configure. (line 33) * make -t: Build system tools. (line 43) -* 'make' rules, verbose vs. silent: '--enable-silent-rules'. +* make rules, verbose vs. silent: --enable-silent-rules. (line 6) * Makefile.am: Adding a new program module. (line 46) -* mf-nowin: Configure options for 'texk/web2c'. +* mf-nowin: Configure options for texk/web2c. (line 34) -* 'mingw32': Cross configuring. (line 27) +* mingw32: Cross configuring. (line 27) * MINGW32, Automake conditional: Macros for Windows. (line 20) -* mktex.ac: 'kpathsea' library. (line 18) -* mktextfm: 'kpathsea' library. (line 18) +* mktex.ac: kpathsea library. (line 18) +* mktextfm: kpathsea library. (line 18) * modules, for libraries: Library modules. (line 6) * modules, for programs: Program modules. (line 6) -* motif: Configure options for 'texk/xdvik'. +* motif: Configure options for texk/xdvik. (line 9) * native cross compilation: Cross compilation. (line 10) * NEWPROG-SRC, original source subdirectory: Adding a new program module. @@ -5796,52 +5801,49 @@ Index * OBJCXX=OBJC-COMPILER: Build one package. (line 78) * one engine, building: Build one engine. (line 6) * one package, building: Build one package. (line 6) -* OpenGL, required for Asymptote: 'asymptote'. (line 6) +* OpenGL, required for Asymptote: asymptote. (line 6) * operating system distribution, building for: Distro builds. (line 6) * otangle: Cross problems. (line 26) * overall build process: Building. (line 6) * parallel build: Build in parallel. (line 6) * paths, for installation: Installation directories. (line 6) -* PDF files, size of: '--disable-largefile'. - (line 11) +* PDF files, size of: --disable-largefile. (line 11) * PDFLATEX: Variables for configure. (line 41) * PERL: Variables for configure. (line 39) -* 'perl', required by 'web2c', etc.: Prerequisites. (line 23) +* perl, required by web2c, etc.: Prerequisites. (line 23) * PKG_CONFIG: Variables for configure. (line 23) * plain.tex, not in source tree: Installing. (line 8) -* png library: 'png' library. (line 6) -* PostScript files, size of: '--disable-largefile'. - (line 11) +* png library: png library. (line 6) +* PostScript files, size of: --disable-largefile. (line 11) * Preining, Norbert: Distro builds. (line 54) -* preloaded binaries: Configure options for 'texk/web2c'. +* preloaded binaries: Configure options for texk/web2c. (line 45) * prerequisites for building: Prerequisites. (line 6) * problems with build: Build problems. (line 6) * program module, adding: Adding a new program module. (line 6) * program modules: Program modules. (line 6) -* program-specific 'configure' options: Program-specific configure options. +* program-specific configure options: Program-specific configure options. (line 6) -* proxy build system: 'png' library. (line 36) +* proxy build system: png library. (line 36) * reautoconf: Build system tools. (line 28) * reautoconf, for new program: Adding a new program module. (line 89) * requirements for building: Prerequisites. (line 6) * runscript.exe: Macros for Windows. (line 25) * scripts, linked and not maintained: Linked scripts. (line 6) -* scrolling, smooth: Configure options for 'texk/xdvik'. +* scrolling, smooth: Configure options for texk/xdvik. (line 13) * SED: Variables for configure. (line 34) * setup macros, general: General setup macros. (line 6) * shared libraries, using vs. avoiding: Distro builds. (line 11) -* size of PDF and PS files: '--disable-largefile'. - (line 11) +* size of PDF and PS files: --disable-largefile. (line 11) * size of source tree: Build one package. (line 53) * source code declarations: Declarations and definitions. (line 6) @@ -5849,8 +5851,8 @@ Index * source tree: Layout and infrastructure. (line 6) * squeeze: Cross problems. (line 13) -* squeeze/configure.ac: 'xdvik' package. (line 14) -* 'static' functions: Declarations and definitions. +* squeeze/configure.ac: xdvik package. (line 14) +* static functions: Declarations and definitions. (line 35) * static linking for C++: Macros for compilers. (line 29) @@ -5859,12 +5861,12 @@ Index * Subversion repository: Build system tools. (line 38) * support files, separate from build: Installing. (line 8) * symlinks, used for scripts: Linked scripts. (line 6) -* synctex: Configure options for 'texk/web2c'. +* synctex: Configure options for texk/web2c. (line 59) -* synctex <1>: Configure options for 'texk/web2c'. +* synctex <1>: Configure options for texk/web2c. (line 64) * system distribution, building for: Distro builds. (line 6) -* t1utils package: 't1utils' package. (line 6) +* t1utils package: t1utils package. (line 6) * tangle: Cross problems. (line 26) * tests, running: Overview of build system. (line 6) @@ -5889,13 +5891,13 @@ Index * use-commit-times, Subversion: Build system tools. (line 38) * variable declarations, in source code: Declarations and definitions. (line 52) -* variables for 'configure': Variables for configure. +* variables for configure: Variables for configure. (line 6) * warning, discards qualifiers: Const. (line 30) * WARNING_C[XX]FLAGS: Macros for compilers. (line 9) * web2c program: Cross problems. (line 13) -* web2c.ac: Configure options for 'texk/web2c'. +* web2c.ac: Configure options for texk/web2c. (line 37) * wget: Linked scripts. (line 23) * WIN32, Automake conditional: Macros for Windows. (line 16) @@ -5904,33 +5906,33 @@ Index * Windows, macros for: Macros for Windows. (line 6) * withenable.ac, for new modules: Adding a new program module. (line 14) -* 'Work/' top-level directory: Top-level directories. +* Work/ top-level directory: Top-level directories. (line 39) * wrapper binary for scripts on Windows: Linked scripts. (line 6) -* wrapper build system: 'freetype' library. (line 6) -* X toolkit: Configure options for 'texk/web2c'. +* wrapper build system: freetype library. (line 6) +* X toolkit: Configure options for texk/web2c. (line 22) * X11 development, required by X clients: Prerequisites. (line 27) -* X11 headers, and 'const': Const. (line 21) -* xasy: 'asymptote'. (line 6) -* xaw: Configure options for 'texk/xdvik'. +* X11 headers, and const: Const. (line 21) +* xasy: asymptote. (line 6) +* xaw: Configure options for texk/xdvik. (line 9) -* xdvik: 'xdvik' package. (line 6) -* xdvik <1>: Configure options for 'texk/xdvik'. +* xdvik: xdvik package. (line 6) +* xdvik <1>: Configure options for texk/xdvik. (line 6) -* xdvipdfmx: Configure options for 'texk/dvipdfm-x'. +* xdvipdfmx: Configure options for texk/dvipdfm-x. (line 6) * xindy: Linked scripts. (line 23) -* xindy <1>: 'xindy' package. (line 6) -* xindy <2>: Configure options for 'utils/xindy'. +* xindy <1>: xindy package. (line 6) +* xindy <2>: Configure options for utils/xindy. (line 6) -* 'xindy' cross compiling requires 'clisp': Cross problems. (line 33) -* XInput: Configure options for 'texk/xdvik'. +* xindy cross compiling requires clisp: Cross problems. (line 33) +* XInput: Configure options for texk/xdvik. (line 13) -* Xlib: Configure options for 'texk/web2c'. +* Xlib: Configure options for texk/web2c. (line 22) * xz: Linked scripts. (line 23) -* zlib library: 'zlib' library. (line 6) +* zlib library: zlib library. (line 6)  @@ -5945,391 +5947,396 @@ Node: Build problems11020 Node: Build in parallel11474 Node: Build distribution12078 Node: Build one package12726 -Node: Build one engine16373 -Node: Cross compilation17887 -Node: Cross configuring19167 -Node: Cross problems20844 -Node: Installing22506 -Node: Installation directories23526 -Node: Linked scripts25344 -Node: Distro builds26835 -Node: Layout and infrastructure29211 -Node: Build system tools30042 -Node: Top-level directories32259 -Node: Autoconf macros34495 -Node: General setup macros35257 -Node: Macros for programs36132 -Node: Macros for compilers36933 -Node: Macros for libraries38341 -Node: Macros for library and header flags38767 -Node: Macros for Windows40678 -Node: Library modules42265 -Node: 'png' library42762 -Node: 'zlib' library45114 -Node: 'freetype' library45635 -Node: 'kpathsea' library46337 -Node: Program modules47720 -Node: 't1utils' package48156 -Node: 'xindy' package48705 -Node: 'xdvik' package49825 -Node: 'asymptote'50890 -Node: Extending TeX Live51390 -Node: Adding a new program module52173 -Node: Adding a new generic library module57306 -Node: Adding a new TeX-specific library module59535 -Node: Configure options60233 -Node: Global configure options61614 -Node: '--disable-native-texlive-build'62182 -Node: '--prefix' '--bindir' ...63150 -Node: '--disable-largefile'63698 -Node: '--disable-missing'64248 -Node: '--enable-compiler-warnings='LEVEL64655 -Node: '--enable-cxx-runtime-hack'65317 -Node: '--enable-maintainer-mode'65743 -Node: '--enable-multiplatform'66278 -Node: '--enable-shared'66857 -Node: '--enable-silent-rules'67234 -Node: '--without-ln-s'67692 -Node: '--without-x'68045 -Node: Program-specific configure options68237 -Node: '--enable-PROG' '--disable-PROG'68900 -Node: '--disable-all-pkgs'69179 -Node: Configure options for 'texk/web2c'69970 -Node: Configure options for 'texk/bibtex-x'72514 -Node: Configure options for 'texk/dvipdfm-x'73063 -Node: Configure options for 'texk/dvisvgm'73845 -Node: Configure options for 'texk/texlive'74732 -Node: Configure options for 'texk/xdvik'75159 -Node: Configure options for 'utils/xindy'75786 -Node: Library-specific configure options76680 -Node: Configure options for 'kpathsea'77643 -Node: Variables for configure78351 -Node: Coding conventions79777 -Node: Declarations and definitions80492 -Node: Const82666 -Node: Continuous integration84530 -Node: Transfer from Subversion to Github85194 -Node: Automatic update of the Git mirror87356 -Node: CI testing on Travis-CI87938 -Node: Releases on Github88647 -Node: install-tl89087 -Node: install-tl NAME89456 -Node: install-tl SYNOPSIS89614 -Node: install-tl DESCRIPTION89872 -Node: install-tl REFERENCES90932 -Node: install-tl OPTIONS91456 -Ref: install-tl *-gui* [[=]_module_]91797 -Ref: install-tl 'text'92005 -Ref: install-tl 'tcl'92125 -Ref: install-tl 'wizard'92467 -Ref: install-tl 'expert'92600 -Ref: install-tl 'perltk'92722 -Ref: install-tl *-no-gui*93268 -Ref: install-tl *-lang* _llcode_93358 -Ref: install-tl *-repository* _url|path_94114 -Ref: install-tl *-select-repository*95002 -Ref: install-tl *-all-options*95438 -Ref: install-tl *-custom-bin* _path_95693 -Ref: install-tl *-debug-translation*96527 -Ref: install-tl *-force-platform* _platform_96746 -Ref: install-tl *-help*, *--help*, *-?*96990 -Ref: install-tl *-in-place*97403 -Ref: install-tl *-init-from-profile* _profile_file_97948 -Ref: install-tl *-logfile* _file_98217 -Ref: install-tl *-no-cls*98568 -Ref: install-tl *-no-persistent-downloads*98716 -Ref: install-tl *-persistent-downloads*98741 -Ref: install-tl *-no-verify-downloads*99359 -Ref: install-tl *-non-admin*99722 -Ref: install-tl *-portable*99815 -Ref: install-tl *-print-platform*99954 -Ref: install-tl *-profile* _profile_file_100152 -Ref: install-tl *-q*100373 -Ref: install-tl *-scheme* _scheme_100435 -Ref: install-tl *-v*100909 -Ref: install-tl *-version*, *--version*101064 -Node: install-tl PROFILES101198 -Ref: install-tl 'instopt_adjustpath' (default 0 on Unix, 1 on Windows)104064 -Ref: install-tl 'instopt_adjustrepo' (default 1)104140 -Ref: install-tl 'instopt_letter' (default 0)104277 -Ref: install-tl 'instopt_portable' (default 0)104368 -Ref: install-tl 'instopt_write18_restricted' (default 1)104464 -Node: install-tl ENVIRONMENT VARIABLES105803 -Ref: install-tl 'TEXLIVE_DOWNLOADER'106181 -Ref: install-tl 'TL_DOWNLOAD_PROGRAM'106204 -Ref: install-tl 'TL_DOWNLOAD_ARGS'106224 -Ref: install-tl 'TEXLIVE_INSTALL_ENV_NOCHECK'106428 -Ref: install-tl 'TEXLIVE_INSTALL_NO_CONTEXT_CACHE'106630 -Ref: install-tl 'TEXLIVE_INSTALL_NO_IMPORT'106739 -Ref: install-tl 'TEXLIVE_INSTALL_NO_WELCOME'106891 -Ref: install-tl 'TEXLIVE_INSTALL_PREFIX'107013 -Ref: install-tl 'TEXLIVE_INSTALL_TEXDIR'107039 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFCONFIG'107070 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFVAR'107098 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFHOME'107127 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFLOCAL'107157 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSCONFIG'107191 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSVAR'107222 -Ref: install-tl 'NOPERLDOC'107593 -Node: install-tl AUTHORS AND COPYRIGHT107657 -Node: tlmgr108070 -Node: tlmgr NAME108555 -Node: tlmgr SYNOPSIS108687 -Node: tlmgr DESCRIPTION108877 -Node: tlmgr EXAMPLES109976 -Ref: tlmgr 'tlmgr option repository ctan'110227 -Ref: tlmgr 'tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet'110299 -Ref: tlmgr 'tlmgr update --list'110904 -Ref: tlmgr 'tlmgr update --all'110997 -Ref: tlmgr 'tlmgr info' _what_111154 -Node: tlmgr OPTIONS111416 -Ref: tlmgr *--repository* _url|path_111936 -Ref: tlmgr '/some/local/dir'113122 -Ref: tlmgr 'file:/some/local/dir'113151 -Ref: tlmgr 'ctan'113224 -Ref: tlmgr 'http://mirror.ctan.org/systems/texlive/tlnet'113277 -Ref: tlmgr 'http://server/path/to/tlnet'113618 -Ref: tlmgr 'https://server/path/to/tlnet'113999 -Ref: tlmgr 'ftp://server/path/to/tlnet'114467 -Ref: tlmgr 'user@machine:/path/to/tlnet'114599 -Ref: tlmgr 'scp://user@machine/path/to/tlnet'114640 -Ref: tlmgr 'ssh://user@machine/path/to/tlnet'114681 -Ref: tlmgr *--gui* [_action_]115074 -Ref: tlmgr *--gui-lang* _llcode_115887 -Ref: tlmgr *--debug-translation*116623 -Ref: tlmgr *--machine-readable*116826 -Ref: tlmgr *--no-execute-actions*117094 -Ref: tlmgr *--package-logfile* _file_117287 -Ref: tlmgr *--pause*117541 -Ref: tlmgr *--persistent-downloads*117696 -Ref: tlmgr *--no-persistent-downloads*117724 -Ref: tlmgr *--pin-file*118218 -Ref: tlmgr *--usermode*118436 -Ref: tlmgr *--usertree* _dir_118556 -Ref: tlmgr *--verify-repo=[none|main|all]*118682 -Node: tlmgr ACTIONS119581 -Node: tlmgr help120442 -Node: tlmgr version120919 -Node: tlmgr backup121182 -Ref: tlmgr *backup [_option_...] --all*121353 -Ref: tlmgr *backup [_option_...] _pkg_...*121386 -Ref: tlmgr *--backupdir* _directory_122452 -Ref: tlmgr *--all*122669 -Ref: tlmgr *--clean*[=_N_]122921 -Ref: tlmgr *--dry-run*123248 -Node: tlmgr candidates _pkg_123378 -Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]123733 -Ref: tlmgr *depends*124247 -Ref: tlmgr *executes*124589 -Ref: tlmgr *files*124704 -Ref: tlmgr *runfiles*124840 -Ref: tlmgr *texmfdbs*124977 -Ref: tlmgr - all items in 'TEXMFDBS' have the '!!' prefix.125207 -Ref: tlmgr - all items in 'TEXMFBDS' have an 'ls-R' file (if they exist at all).125283 -Ref: tlmgr - all items in 'TEXMF' with '!!' are listed in 'TEXMFDBS'.125348 -Ref: tlmgr - all items in 'TEXMF' with an 'ls-R' file are listed in 'TEXMFDBS'.125423 -Ref: tlmgr *--use-svn*125448 -Node: tlmgr conf125589 -Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*125877 -Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*125941 -Node: tlmgr dump-tlpdb [_option_...] [--json]128356 -Ref: tlmgr *--local*128789 -Ref: tlmgr *--remote*128828 -Ref: tlmgr *--json*128866 -Node: tlmgr generate129437 -Ref: tlmgr *generate [_option_...] language*129633 -Ref: tlmgr *generate [_option_...] language.dat*129672 -Ref: tlmgr *generate [_option_...] language.def*129711 -Ref: tlmgr *generate [_option_...] language.dat.lua*129754 -Ref: tlmgr *--dest* _output_file_132081 -Ref: tlmgr *--localcfg* _local_conf_file_132657 -Ref: tlmgr *--rebuild-sys*132780 -Node: tlmgr gui133595 -Node: tlmgr info133773 -Ref: tlmgr *info [_option_...] _pkg_...*133935 -Ref: tlmgr *info [_option_...] collections*133969 -Ref: tlmgr *info [_option_...] schemes*133999 -Ref: tlmgr *--list*135529 -Ref: tlmgr *--only-installed*135843 -Ref: tlmgr *--only-remote*136031 -Ref: tlmgr *--data 'item1,item2,...'*136335 -Ref: tlmgr *--json* 1136916 -Node: tlmgr init-usertree137299 -Node: tlmgr install [_option_...] _pkg_...137680 -Ref: tlmgr *--dry-run* 1138188 -Ref: tlmgr *--file*138305 -Ref: tlmgr *--force*138527 -Ref: tlmgr *--no-depends*138747 -Ref: tlmgr *--no-depends-at-all*138906 -Ref: tlmgr *--reinstall*139306 -Ref: tlmgr *--with-doc*139684 -Ref: tlmgr *--with-src*139697 -Node: tlmgr key140425 -Ref: tlmgr *key list*140583 -Ref: tlmgr *key add _file_*140601 -Ref: tlmgr *key remove _keyid_*140623 -Node: tlmgr list141217 -Node: tlmgr option141379 -Ref: tlmgr *option [--json] [show]*141534 -Ref: tlmgr *option [--json] showall|help*141565 -Ref: tlmgr *option _key_ [_value_]*141591 -Node: tlmgr paper146169 -Ref: tlmgr *paper [a4|letter]*146318 -Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>146394 -Ref: tlmgr *paper --json*146409 -Node: tlmgr path147624 -Ref: tlmgr *path [--w32mode=user|admin] add*147785 -Ref: tlmgr *path [--w32mode=user|admin] remove*147822 -Node: tlmgr pinning149307 -Ref: tlmgr 'pinning show'149548 -Ref: tlmgr 'pinning add' _repo_ _pkgglob_...149621 -Ref: tlmgr 'pinning remove' _repo_ _pkgglob_...149740 -Ref: tlmgr 'pinning remove _repo_ --all'149893 -Node: tlmgr platform149947 -Ref: tlmgr *platform list|add|remove _platform_...*150133 -Ref: tlmgr *platform set _platform_*150160 -Ref: tlmgr *platform set auto*150181 -Ref: tlmgr *--dry-run* 2151058 -Node: tlmgr postaction151177 -Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*151407 -Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*151481 -Ref: tlmgr *--w32mode=[user|admin]*151796 -Ref: tlmgr *--fileassocmode=[1|2]*152212 -Ref: tlmgr *--all* 1152497 -Node: tlmgr print-platform152552 -Node: tlmgr print-platform-info152883 -Node: tlmgr remove [_option_...] _pkg_...153183 -Ref: tlmgr *--all* 2153667 -Ref: tlmgr *--backup*153777 -Ref: tlmgr *--backupdir* _directory_ 1153803 -Ref: tlmgr *--no-depends* 1154208 -Ref: tlmgr *--no-depends-at-all* 1154270 -Ref: tlmgr *--force* 1154373 -Ref: tlmgr *--dry-run* 3154846 -Node: tlmgr repository155182 -Ref: tlmgr *repository list*155370 -Ref: tlmgr *repository list _path|url|tag_*155404 -Ref: tlmgr *repository add _path_ [_tag_]*155437 -Ref: tlmgr *repository remove _path|tag_*155469 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*155523 -Ref: tlmgr *repository status*155544 -Ref: tlmgr The tag (which can be the same as the url);156771 -Node: tlmgr restore157249 -Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*157428 -Ref: tlmgr *restore [_option_...] --all*157458 -Ref: tlmgr *--all* 3158158 -Ref: tlmgr *--backupdir* _directory_ 2158372 -Ref: tlmgr *--dry-run* 4158553 -Ref: tlmgr *--force* 2158685 -Ref: tlmgr *--json* 2158731 -Node: tlmgr search159058 -Ref: tlmgr *search [_option_...] _what_*159222 -Ref: tlmgr *search [_option_...] --file _what_*159259 -Ref: tlmgr *search [_option_...] --all _what_*159295 -Ref: tlmgr *--file* 1159515 -Ref: tlmgr *--all* 4159577 -Ref: tlmgr *--global*159666 -Ref: tlmgr *--word*159793 -Node: tlmgr shell160108 -Ref: tlmgr protocol160843 -Ref: tlmgr help 1160907 -Ref: tlmgr version 1160960 -Ref: tlmgr quit, end, bye, byebye, EOF161028 -Ref: tlmgr restart161049 -Ref: tlmgr load [local|remote]161172 -Ref: tlmgr save161242 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]161365 -Node: tlmgr show161966 -Node: tlmgr uninstall162133 -Node: tlmgr update [_option_...] [_pkg_...]162363 -Ref: tlmgr *--all* 5162734 -Ref: tlmgr *--self*164913 -Ref: tlmgr *--dry-run* 5165677 -Ref: tlmgr *--list* [_pkg_]165854 -Ref: tlmgr *--exclude* _pkg_166543 -Ref: tlmgr *--no-auto-remove* [_pkg_...]167343 -Ref: tlmgr *--no-auto-install* [_pkg_...]167827 -Ref: tlmgr *--reinstall-forcibly-removed*168589 -Ref: tlmgr *--backup* 1169124 -Ref: tlmgr *--backupdir* _directory_ 3169150 -Ref: tlmgr *--no-depends* 2170316 -Ref: tlmgr *--no-depends-at-all* 2170519 -Ref: tlmgr *--force* 3170622 -Node: tlmgr CONFIGURATION FILE FOR TLMGR171642 -Ref: tlmgr 'auto-remove', value 0 or 1 (default 1), same as command-line option.172649 -Ref: tlmgr 'gui-expertmode', value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.172786 -Ref: tlmgr 'gui-lang' _llcode_, with a language code value as with the command-line option.172868 -Ref: tlmgr 'no-checksums', value 0 or 1 (default 0, see below).172922 -Ref: tlmgr 'persistent-downloads', value 0 or 1 (default 1), same as command-line option.173002 -Ref: tlmgr 'require-verification', value 0 or 1 (default 0), same as command-line option.173082 -Ref: tlmgr 'update-exclude', value: comma-separated list of packages (no space allowed). Same as the command line option '--exclude' for the action 'update'.173230 -Ref: tlmgr 'verify-downloads', value 0 or 1 (default 1), same as command-line option.173306 -Ref: tlmgr 'allowed-actions' _action1_ [,_action_,...] The value is a comma-separated list of 'tlmgr' actions which are allowed to be executed when 'tlmgr' is invoked in system mode (that is, without '--usermode').173575 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION174663 -Node: tlmgr Configuration of GnuPG invocation176836 -Node: tlmgr USER MODE177474 -Node: tlmgr User mode install180320 -Node: tlmgr User mode backup, restore, remove, update181464 -Node: tlmgr User mode generate, option, paper181906 -Node: tlmgr MULTIPLE REPOSITORIES182282 -Node: tlmgr Pinning184011 -Node: tlmgr GUI FOR TLMGR185934 -Node: tlmgr Main display187583 -Node: tlmgr Display configuration area187835 -Ref: tlmgr Status188196 -Ref: tlmgr Category188360 -Ref: tlmgr Match188546 -Ref: tlmgr Selection188727 -Ref: tlmgr Display configuration buttons188931 -Node: tlmgr Package list area189114 -Ref: tlmgr a checkbox189698 -Ref: tlmgr package name189834 -Ref: tlmgr local revision (and version)189933 -Ref: tlmgr remote revision (and version)190308 -Ref: tlmgr short description190605 -Node: tlmgr Main display action buttons190650 -Ref: tlmgr Update all installed190916 -Ref: tlmgr Update191288 -Ref: tlmgr Install191338 -Ref: tlmgr Remove191524 -Ref: tlmgr Backup191702 -Node: tlmgr Menu bar191859 -Ref: tlmgr 'tlmgr' menu192082 -Ref: tlmgr 'Options menu'192390 -Ref: tlmgr 'Actions menu'193473 -Ref: tlmgr 'Help menu'193901 -Node: tlmgr GUI options194035 -Ref: tlmgr '-background' _color_194281 -Ref: tlmgr '-font "' _fontname_ _fontsize_ '"'194346 -Ref: tlmgr '-foreground' _color_194504 -Ref: tlmgr '-geometry' _geomspec_194556 -Ref: tlmgr '-xrm' _xresource_194748 -Node: tlmgr MACHINE-READABLE OUTPUT195017 -Node: tlmgr Machine-readable 'update' and 'install' output195833 -Ref: tlmgr 'location-url' _location_197115 -Ref: tlmgr 'total-bytes' _count_197331 -Ref: tlmgr _pkgname_197741 -Ref: tlmgr _status_197951 -Ref: tlmgr 'd'198029 -Ref: tlmgr 'f'198089 -Ref: tlmgr 'u'198268 -Ref: tlmgr 'r'198314 -Ref: tlmgr 'a'198437 -Ref: tlmgr 'i'198615 -Ref: tlmgr 'I'198734 -Ref: tlmgr _localrev_198836 -Ref: tlmgr _serverrev_198943 -Ref: tlmgr _size_199055 -Ref: tlmgr _runtime_199224 -Ref: tlmgr _esttot_199294 -Node: tlmgr Machine-readable 'option' output199327 -Node: tlmgr ENVIRONMENT VARIABLES199845 -Ref: tlmgr 'TEXLIVE_COMPRESSOR'200356 -Ref: tlmgr 'TEXLIVE_DOWNLOADER'201204 -Ref: tlmgr 'TL_DOWNLOAD_PROGRAM'201227 -Ref: tlmgr 'TL_DOWNLOAD_ARGS'201247 -Ref: tlmgr 'TEXLIVE_PREFER_OWN'202273 -Node: tlmgr AUTHORS AND COPYRIGHT203097 -Node: Index203495 +Node: Build one engine16371 +Node: Cross compilation17885 +Node: Cross configuring19165 +Node: Cross problems20842 +Node: Installing22504 +Node: Installation directories23524 +Node: Linked scripts25342 +Node: Distro builds26833 +Node: Layout and infrastructure29209 +Node: Build system tools30040 +Node: Top-level directories32257 +Node: Autoconf macros34493 +Node: General setup macros35255 +Node: Macros for programs36130 +Node: Macros for compilers36931 +Node: Macros for libraries38339 +Node: Macros for library and header flags38765 +Node: Macros for Windows40676 +Node: Library modules42263 +Node: png library42752 +Node: zlib library45100 +Node: freetype library45615 +Node: kpathsea library46311 +Node: Program modules47690 +Node: t1utils package48118 +Node: xindy package48663 +Node: xdvik package49777 +Node: asymptote50836 +Node: Extending TeX Live51332 +Node: Adding a new program module52115 +Node: Adding a new generic library module57248 +Node: Adding a new TeX-specific library module59477 +Node: Configure options60175 +Node: Global configure options61556 +Node: --disable-native-texlive-build62098 +Node: --prefix --bindir ...63060 +Node: --disable-largefile63600 +Node: --disable-missing64142 +Node: --enable-compiler-warnings=LEVEL64543 +Node: --enable-cxx-runtime-hack65199 +Node: --enable-maintainer-mode65619 +Node: --enable-multiplatform66148 +Node: --enable-shared66721 +Node: --enable-silent-rules67092 +Node: --without-ln-s67544 +Node: --without-x67891 +Node: Program-specific configure options68079 +Node: --enable-PROG --disable-PROG68722 +Node: --disable-all-pkgs68995 +Node: Configure options for texk/web2c69778 +Node: Configure options for texk/bibtex-x72316 +Node: Configure options for texk/dvipdfm-x72859 +Node: Configure options for texk/dvisvgm73635 +Node: Configure options for texk/texlive74516 +Node: Configure options for texk/xdvik74937 +Node: Configure options for utils/xindy75558 +Node: Library-specific configure options76448 +Node: Configure options for kpathsea77409 +Node: Variables for configure78113 +Node: Coding conventions79539 +Node: Declarations and definitions80254 +Node: Const82428 +Node: Continuous integration84292 +Node: Transfer from Subversion to Github84956 +Node: Automatic update of the Git mirror87118 +Node: CI testing on Travis-CI87700 +Node: Releases on Github88409 +Node: install-tl88849 +Node: install-tl NAME89218 +Node: install-tl SYNOPSIS89376 +Node: install-tl DESCRIPTION89634 +Node: install-tl REFERENCES90694 +Node: install-tl OPTIONS91218 +Ref: install-tl *-gui* [[=]_module_]91559 +Ref: install-tl text91767 +Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)91952 +Ref: install-tl *-no-gui*92584 +Ref: install-tl *-lang* _llcode_92674 +Ref: install-tl *-repository* _url|path_93298 +Ref: install-tl *-select-repository*94186 +Ref: install-tl *-all-options*94604 +Ref: install-tl *-custom-bin* _path_94859 +Ref: install-tl *-debug-translation*95693 +Ref: install-tl *-force-platform* _platform_95969 +Ref: install-tl *-help*, *--help*, *-?*96213 +Ref: install-tl *-in-place*96626 +Ref: install-tl *-init-from-profile* _profile_file_97171 +Ref: install-tl *-logfile* _file_97440 +Ref: install-tl *-no-cls*97791 +Ref: install-tl *-no-persistent-downloads*97939 +Ref: install-tl *-persistent-downloads*97964 +Ref: install-tl *-no-verify-downloads*98582 +Ref: install-tl *-non-admin*98945 +Ref: install-tl *-portable*99038 +Ref: install-tl *-print-platform*99177 +Ref: install-tl *-profile* _profile_file_99375 +Ref: install-tl *-q*99596 +Ref: install-tl *-scheme* _scheme_99658 +Ref: install-tl *-v*100132 +Ref: install-tl *-version*, *--version*100287 +Node: install-tl PROFILES100421 +Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)103287 +Ref: install-tl instopt_adjustrepo (default 1)103363 +Ref: install-tl instopt_letter (default 0)103500 +Ref: install-tl instopt_portable (default 0)103591 +Ref: install-tl instopt_write18_restricted (default 1)103687 +Node: install-tl ENVIRONMENT VARIABLES105026 +Ref: install-tl TEXLIVE_DOWNLOADER105404 +Ref: install-tl TL_DOWNLOAD_PROGRAM105427 +Ref: install-tl TL_DOWNLOAD_ARGS105447 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK105651 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE105853 +Ref: install-tl TEXLIVE_INSTALL_NO_RESUME105962 +Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME106114 +Ref: install-tl TEXLIVE_INSTALL_PAPER106235 +Ref: install-tl TEXLIVE_INSTALL_PREFIX106381 +Ref: install-tl TEXLIVE_INSTALL_TEXDIR106407 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG106438 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR106466 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME106495 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL106525 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG106559 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR106590 +Ref: install-tl NOPERLDOC106961 +Node: install-tl AUTHORS AND COPYRIGHT107025 +Node: tlmgr107439 +Node: tlmgr NAME107924 +Node: tlmgr SYNOPSIS108056 +Node: tlmgr DESCRIPTION108246 +Node: tlmgr EXAMPLES109345 +Ref: tlmgr tlmgr option repository ctan109596 +Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet109668 +Ref: tlmgr tlmgr update --list110273 +Ref: tlmgr tlmgr update --all110366 +Ref: tlmgr tlmgr info _what_110523 +Node: tlmgr OPTIONS110785 +Ref: tlmgr *--repository* _url|path_111305 +Ref: tlmgr /some/local/dir112491 +Ref: tlmgr file:/some/local/dir112520 +Ref: tlmgr ctan112593 +Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet112646 +Ref: tlmgr http://server/path/to/tlnet112987 +Ref: tlmgr https://server/path/to/tlnet113368 +Ref: tlmgr ftp://server/path/to/tlnet113836 +Ref: tlmgr user@machine:/path/to/tlnet113968 +Ref: tlmgr scp://user@machine/path/to/tlnet114009 +Ref: tlmgr ssh://user@machine/path/to/tlnet114050 +Ref: tlmgr *--gui* [_action_]114443 +Ref: tlmgr *--gui-lang* _llcode_115256 +Ref: tlmgr *--command-logfile* _file_115997 +Ref: tlmgr *--debug-translation*116263 +Ref: tlmgr *--machine-readable*116466 +Ref: tlmgr *--no-execute-actions*116734 +Ref: tlmgr *--package-logfile* _file_116927 +Ref: tlmgr *--pause*117181 +Ref: tlmgr *--persistent-downloads*117336 +Ref: tlmgr *--no-persistent-downloads*117364 +Ref: tlmgr *--pin-file*117858 +Ref: tlmgr *--usermode*118076 +Ref: tlmgr *--usertree* _dir_118196 +Ref: tlmgr *--verify-repo=[none|main|all]*118322 +Node: tlmgr ACTIONS119221 +Node: tlmgr help120082 +Node: tlmgr version120559 +Node: tlmgr backup120822 +Ref: tlmgr *backup [_option_...] --all*120993 +Ref: tlmgr *backup [_option_...] _pkg_...*121026 +Ref: tlmgr *--backupdir* _directory_122092 +Ref: tlmgr *--all*122309 +Ref: tlmgr *--clean*[=_N_]122561 +Ref: tlmgr *--dry-run*122888 +Node: tlmgr candidates _pkg_123018 +Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]123373 +Ref: tlmgr *depends*123887 +Ref: tlmgr *executes*124229 +Ref: tlmgr *files*124344 +Ref: tlmgr *runfiles*124480 +Ref: tlmgr *texmfdbs*124617 +Ref: tlmgr - all items in TEXMFDBS have the !! prefix.124847 +Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).124923 +Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.124988 +Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.125063 +Ref: tlmgr *--use-svn*125088 +Node: tlmgr conf125229 +Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*125517 +Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*125581 +Node: tlmgr dump-tlpdb [_option_...] [--json]127996 +Ref: tlmgr *--local*128429 +Ref: tlmgr *--remote*128468 +Ref: tlmgr *--json*128506 +Node: tlmgr generate129077 +Ref: tlmgr *generate [_option_...] language*129273 +Ref: tlmgr *generate [_option_...] language.dat*129312 +Ref: tlmgr *generate [_option_...] language.def*129351 +Ref: tlmgr *generate [_option_...] language.dat.lua*129394 +Ref: tlmgr *--dest* _output_file_131721 +Ref: tlmgr *--localcfg* _local_conf_file_132297 +Ref: tlmgr *--rebuild-sys*132420 +Node: tlmgr gui133235 +Node: tlmgr info133413 +Ref: tlmgr *info [_option_...] _pkg_...*133575 +Ref: tlmgr *info [_option_...] collections*133609 +Ref: tlmgr *info [_option_...] schemes*133639 +Ref: tlmgr *--list*135169 +Ref: tlmgr *--only-installed*135483 +Ref: tlmgr *--only-remote*135671 +Ref: tlmgr *--data item1,item2,...*135975 +Ref: tlmgr *--json* 1137338 +Node: tlmgr init-usertree137721 +Node: tlmgr install [_option_...] _pkg_...138102 +Ref: tlmgr *--dry-run* 1138610 +Ref: tlmgr *--file*138727 +Ref: tlmgr *--force*138949 +Ref: tlmgr *--no-depends*139169 +Ref: tlmgr *--no-depends-at-all*139328 +Ref: tlmgr *--reinstall*139728 +Ref: tlmgr *--with-doc*140106 +Ref: tlmgr *--with-src*140119 +Node: tlmgr key140847 +Ref: tlmgr *key list*141005 +Ref: tlmgr *key add _file_*141023 +Ref: tlmgr *key remove _keyid_*141045 +Node: tlmgr list141639 +Node: tlmgr option141801 +Ref: tlmgr *option [--json] [show]*141956 +Ref: tlmgr *option [--json] showall|help*141987 +Ref: tlmgr *option _key_ [_value_]*142013 +Node: tlmgr paper146591 +Ref: tlmgr *paper [a4|letter]*146740 +Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>146816 +Ref: tlmgr *paper --json*146831 +Node: tlmgr path148046 +Ref: tlmgr *path [--w32mode=user|admin] add*148207 +Ref: tlmgr *path [--w32mode=user|admin] remove*148244 +Node: tlmgr pinning149729 +Ref: tlmgr pinning show149970 +Ref: tlmgr pinning add _repo_ _pkgglob_...150043 +Ref: tlmgr pinning remove _repo_ _pkgglob_...150162 +Ref: tlmgr pinning remove _repo_ --all150315 +Node: tlmgr platform150369 +Ref: tlmgr *platform list|add|remove _platform_...*150555 +Ref: tlmgr *platform set _platform_*150582 +Ref: tlmgr *platform set auto*150603 +Ref: tlmgr *--dry-run* 2151480 +Node: tlmgr postaction151599 +Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*151829 +Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*151903 +Ref: tlmgr *--w32mode=[user|admin]*152218 +Ref: tlmgr *--fileassocmode=[1|2]*152634 +Ref: tlmgr *--all* 1152919 +Node: tlmgr print-platform152974 +Node: tlmgr print-platform-info153305 +Node: tlmgr remove [_option_...] _pkg_...153605 +Ref: tlmgr *--all* 2154089 +Ref: tlmgr *--backup*154199 +Ref: tlmgr *--backupdir* _directory_ 1154225 +Ref: tlmgr *--no-depends* 1154630 +Ref: tlmgr *--no-depends-at-all* 1154692 +Ref: tlmgr *--force* 1154795 +Ref: tlmgr *--dry-run* 3155268 +Node: tlmgr repository155604 +Ref: tlmgr *repository list*155792 +Ref: tlmgr *repository list _path|url|tag_*155826 +Ref: tlmgr *repository add _path_ [_tag_]*155859 +Ref: tlmgr *repository remove _path|tag_*155891 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*155945 +Ref: tlmgr *repository status*155966 +Ref: tlmgr The tag (which can be the same as the url);157193 +Node: tlmgr restore157671 +Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*157850 +Ref: tlmgr *restore [_option_...] --all*157880 +Ref: tlmgr *--all* 3158580 +Ref: tlmgr *--backupdir* _directory_ 2158794 +Ref: tlmgr *--dry-run* 4158975 +Ref: tlmgr *--force* 2159107 +Ref: tlmgr *--json* 2159153 +Node: tlmgr search159480 +Ref: tlmgr *search [_option_...] _what_*159644 +Ref: tlmgr *search [_option_...] --file _what_*159681 +Ref: tlmgr *search [_option_...] --all _what_*159717 +Ref: tlmgr *--file* 1159937 +Ref: tlmgr *--all* 4159999 +Ref: tlmgr *--global*160088 +Ref: tlmgr *--word*160215 +Node: tlmgr shell160530 +Ref: tlmgr protocol161265 +Ref: tlmgr help 1161329 +Ref: tlmgr version 1161382 +Ref: tlmgr quit, end, bye, byebye, EOF161450 +Ref: tlmgr restart161471 +Ref: tlmgr load [local|remote]161594 +Ref: tlmgr save161664 +Ref: tlmgr get [_var_] =item set [_var_ [_val_]]161787 +Node: tlmgr show162388 +Node: tlmgr uninstall162555 +Node: tlmgr update [_option_...] [_pkg_...]162785 +Ref: tlmgr *--all* 5163156 +Ref: tlmgr *--self*165335 +Ref: tlmgr *--dry-run* 5166099 +Ref: tlmgr *--list* [_pkg_]166276 +Ref: tlmgr *--exclude* _pkg_166965 +Ref: tlmgr *--no-auto-remove* [_pkg_...]167765 +Ref: tlmgr *--no-auto-install* [_pkg_...]168249 +Ref: tlmgr *--reinstall-forcibly-removed*169011 +Ref: tlmgr *--backup* 1169546 +Ref: tlmgr *--backupdir* _directory_ 3169572 +Ref: tlmgr *--no-depends* 2170738 +Ref: tlmgr *--no-depends-at-all* 2170941 +Ref: tlmgr *--force* 3171044 +Node: tlmgr CONFIGURATION FILE FOR TLMGR172035 +Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.173042 +Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.173179 +Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.173261 +Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).173315 +Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.173395 +Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.173475 +Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.173565 +Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.173713 +Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.173789 +Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).174058 +Node: tlmgr CRYPTOGRAPHIC VERIFICATION175146 +Node: tlmgr Configuration of GnuPG invocation177319 +Node: tlmgr USER MODE177957 +Node: tlmgr User mode install180803 +Node: tlmgr User mode backup, restore, remove, update181947 +Node: tlmgr User mode generate, option, paper182389 +Node: tlmgr MULTIPLE REPOSITORIES182765 +Node: tlmgr Pinning184494 +Node: tlmgr GUI FOR TLMGR186417 +Node: tlmgr Main display188066 +Node: tlmgr Display configuration area188318 +Ref: tlmgr Status188679 +Ref: tlmgr Category188843 +Ref: tlmgr Match189029 +Ref: tlmgr Selection189210 +Ref: tlmgr Display configuration buttons189414 +Node: tlmgr Package list area189597 +Ref: tlmgr a checkbox190181 +Ref: tlmgr package name190317 +Ref: tlmgr local revision (and version)190416 +Ref: tlmgr remote revision (and version)190791 +Ref: tlmgr short description191088 +Node: tlmgr Main display action buttons191133 +Ref: tlmgr Update all installed191399 +Ref: tlmgr Update191771 +Ref: tlmgr Install191821 +Ref: tlmgr Remove192007 +Ref: tlmgr Backup192185 +Node: tlmgr Menu bar192342 +Ref: tlmgr tlmgr menu192565 +Ref: tlmgr Options menu192873 +Ref: tlmgr Actions menu193956 +Ref: tlmgr Help menu194384 +Node: tlmgr GUI options194518 +Ref: tlmgr -background _color_194764 +Ref: tlmgr -font " _fontname_ _fontsize_ "194829 +Ref: tlmgr -foreground _color_194987 +Ref: tlmgr -geometry _geomspec_195039 +Ref: tlmgr -xrm _xresource_195231 +Node: tlmgr MACHINE-READABLE OUTPUT195500 +Node: tlmgr Machine-readable update and install output196310 +Ref: tlmgr location-url _location_197586 +Ref: tlmgr total-bytes _count_197802 +Ref: tlmgr _pkgname_198212 +Ref: tlmgr _status_198422 +Ref: tlmgr d198500 +Ref: tlmgr f198560 +Ref: tlmgr u198739 +Ref: tlmgr r198785 +Ref: tlmgr a198908 +Ref: tlmgr i199086 +Ref: tlmgr I199205 +Ref: tlmgr _localrev_199307 +Ref: tlmgr _serverrev_199414 +Ref: tlmgr _size_199526 +Ref: tlmgr _runtime_199695 +Ref: tlmgr _esttot_199765 +Node: tlmgr Machine-readable option output199798 +Node: tlmgr ENVIRONMENT VARIABLES200310 +Ref: tlmgr TEXLIVE_COMPRESSOR200821 +Ref: tlmgr TEXLIVE_DOWNLOADER201669 +Ref: tlmgr TL_DOWNLOAD_PROGRAM201692 +Ref: tlmgr TL_DOWNLOAD_ARGS201712 +Ref: tlmgr TEXLIVE_PREFER_OWN202738 +Node: tlmgr AUTHORS AND COPYRIGHT203562 +Node: Index203961  End Tag Table + + +Local Variables: +coding: utf-8 +End: diff --git a/Master/texmf-dist/doc/dvipng/dvipng.pdf b/Master/texmf-dist/doc/dvipng/dvipng.pdf index e85e38e0ea4..c92d4407a32 100644 Binary files a/Master/texmf-dist/doc/dvipng/dvipng.pdf and b/Master/texmf-dist/doc/dvipng/dvipng.pdf differ diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index 568dbae14b4..da5842dfc30 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,7 +1,7 @@ - @@ -193,8 +193,8 @@ Next: , Up:

Dvips

-

This manual documents Dvips version 2020.1 -(January 2020), a program to translate a DVI file into +

This manual documents Dvips version 2021.1 +(February 2021), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file.

@@ -262,22 +262,15 @@ font at a different size can be used instead, although Dvips will complain loudly about the poor aesthetics of the resulting output.

One of the most important features is the support of virtual fonts, -which add an entirely new level of flexibility to TeX. Virtual fonts -are used to give Dvips its excellent PostScript font support, handling -all the font remapping in a natural, portable, elegant, and extensible -way. Dvips even comes with its own Afm2tfm program that creates -the necessary virtual fonts and TeX font metric files automatically -from the Adobe font metric files. +which add an entirely new level of flexibility to TeX. Dvips even +comes with its own Afm2tfm program that can create the virtual fonts +and TeX font metric files automatically from Adobe font metric +files.

Source is provided and freely distributable, so adding a site-specific feature is possible. Adding such features is made easier by the highly modular structure of the program.

-

There is really no reason to use another driver, and the more people use -Dvips, the less time will be spent fighting with PostScript and the -more time will be available to create beautiful documents. -So if you don’t use Dvips on your system, get it today. -

Tom Rokicki wrote and maintains the original Dvips program.

@@ -300,8 +293,7 @@ see Installatio

For solutions to common installation problems and information on how to report a bug, see the file kpathsea/BUGS (see Bugs in Kpathsea). For solutions to Dvips-specific problems, -see Debug options. Also see the Dvips home page at -http://www.radicaleye.com/dvips. +see Debug options.

Dvips does require some additional installation, detailed in the sections below. Also, to configure color devices, see Color device configuration. @@ -452,7 +444,7 @@ originally written by Peter Deutsch. It can read the PostScript produced by Dvips and render it on your monitor, or for another device (e.g., an Epson printer) that does not support PostScript, or in PDF format. The latest version is available via -http://ghostscript.com. +https://ghostscript.com.

@@ -465,7 +457,7 @@ Theisen, provides typical previewing capabilities (next page/previous page, magnification, etc.). It requires Ghostscript to run, and files in structured Postscript, specifically with ‘%%Page’ comments (no ‘N’ in config.ps). The current version is known as GV, -and is available from http://www.gnu.org/software/gv. +and is available from https://www.gnu.org/software/gv.


@@ -783,7 +775,7 @@ same fonts over and over again, it hasn’t been installed properly. See Unable to generate fonts in Kpathsea.)

Many options are available (see the next section). For a brief summary -of available options, just type +of available options, run

dvips --help
@@ -849,6 +841,7 @@ Options:
 -r*  Reverse order of pages          -R*  Run securely
 -s*  Enclose output in save/restore  -S # Max section size in pages
 -t s Paper format                    -T c Specify desired page size
+-title s Title in comment
 -u s PS mapfile                      -U*  Disable string param trick
 -v   Print version number and quit   -V*  Send downloadable PS fonts as PK
 -x # Override dvi magnification      -X # Horizontal resolution
@@ -1150,7 +1143,6 @@ with -L0, the first special wins.  See 
 
-mode mode
-

Use mode as the Metafont device name for path searching and font @@ -1404,6 +1396,18 @@ information in the output. (If you just have a single page document, you can use ‘-E’ to get pure EPSF output.) +

+
-title string
+
+ + + + +

Use string as the title in the generated PostScript +(%%Title). If not specified, the default is the basename of the +input file; for example, running dvips /foo/bar.dvi will have a +%%Title of ‘bar.dvi’. +

-T hsize,vsize
@@ -2479,7 +2483,7 @@ Next: , Previous:

Once the figure file has a bounding box comment (see the previous section) you are ready to import the graphic into a LaTeX -document. For LaTeX 2e, you can use the epsf, graphics or graphicx +document. For LaTeX2e, you can use the epsf, graphics or graphicx packages, but the last is recommended—it has the most flexible syntax, and is briefly described here. Further information can be found in grfguide or epslatex, which should be included @@ -2548,7 +2552,7 @@ Next: , Pre -

If you are using LaTeX 2e, use the ‘graphics’ or ‘graphicx’ +

If you are using LaTeX2e, use the ‘graphics’ or ‘graphicx’ package. See \includegraphics.

If you are using plain TeX or LaTeX 2.09, you need epsf.tex @@ -3410,23 +3414,19 @@ interpreters as well.) Various versions of both PC and Unix distillers are supported; Ghostscript includes limited distiller support (see Ghostscript installation).

-

Macros you can use in your TeX document to insert the specials in the -first place are available from CTAN:/support/hypertex. For -CTAN info, see unixtex.ftp in Kpathsea. +

By far the most common LaTeX package used to create hyperlinked +output is hyperref (https://ctan.org/pkg/hyperref). For +plain TeX, the Eplain package has some hyperlink support +(https://tug.org/eplain).

- - -

This hypertext support (and original form of the documentation) was written by Mark Doyle and Tanmoy Bhattacharya as the ‘dvihps’ -program. You can retrieve their software and additional documentation -via the CTAN reference above. +program.

-
@@ -3487,9 +3487,9 @@ examining the PostScript output file, looking for the section starting distribution may make those fonts available in a separate optional package (e.g., tetex-extra in Debian). Failing that, commercial versions of the Computer Modern fonts are available from -Blue Sky; public domain versions - in particular, the lm fonts, and -the cm-super fonts, are available from CTAN sites (for CTAN info, -see unixtex.ftp in Kpathsea). +Blue Sky; public domain versions, in particular, the lm +and cm-super font families, are available from CTAN and in TeX +distributions.

You can convert a PostScript file to PDF using distill, which comes with Adobe Acrobat, or ps2pdf, which comes with @@ -3529,8 +3529,8 @@ more, but copies are available elsewhere:

You may also want to check “Notes on converting (La)TeX documents -to robust PDF using Rokicki’s dvips and Acrobat Distiller” by Timothy -P. Van Zandt:
+to robust PDF using Rokicki’s dvips and Acrobat Distiller” by +Timothy P. Van Zandt:
http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html.

@@ -3858,16 +3858,16 @@ Next: , Previous: -

A virtual font is constructed by extracting characters from one or -more existing fonts and rearranging them, or synthesizing new characters -in various ways. The explanation in this manual is intended to suffice -for understanding enough about virtual fonts to use them with Dvips. It -isn’t a reference manual on virtual fonts. For more information: The -primary document on virtual fonts is Donald E. Knuth, TUGboat -11(1), Apr. 1990, pp. 13–23, “Virtual Fonts: More Fun for Grand -Wizards” (CTAN:/info/virtual-fonts.knuth; for CTAN info, -see unixtex.ftp in Kpathsea). (Don’t be intimidated by -the subtitle.) +

A virtual font is constructed by extracting characters from one +or more existing fonts and rearranging them, or synthesizing new +characters in various ways. The explanation in this manual is +intended to suffice for understanding enough about virtual fonts to +use them with Dvips. It isn’t a reference manual on virtual fonts. +For more information: The primary document on virtual fonts is +Donald E. Knuth, TUGboat 11(1), Apr. 1990, pp. 13–23, +“Virtual Fonts: More Fun for Grand Wizards” +(mirror.ctan.org/info/virtual-fonts.knuth). (Don’t be +intimidated by the subtitle.)

@@ -3894,7 +3894,18 @@ created when you run vptovf.

You can expand virtual fonts into their base fonts with DVIcopy (see dvicopy invocation in Web2c). This is useful if you are -using a DVI translator that doesn’t understand vf’s itself. +using a DVI translator that doesn’t itself understand vf’s. +

+ + + + +

If a virtual font has no entry at a given codepoint and the first +MAPFONT designates an (u)pTeX JFM, we designate the glyph of +the same codepoint in the TFM(JFM) with the smallest font ID. This +feature helps to reduce the size of Japanese virtual fonts. For more +information about the extensive support of Japanese in TeX, see +https://github.com/texjporg.


@@ -4263,9 +4274,9 @@ can also obtain special effects such as an oblique font.

Alternatives to Afm2tfm for creating virtual fonts include -fontinst http://ctan.org/pkg/fontinst, +fontinst https://ctan.org/pkg/fontinst, lcdf-typetools, particularly otftotfm -(http://ctan.org/pkg/lcdf-typetools), and afm2p +(https://ctan.org/pkg/lcdf-typetools), and afm2pl (http://tex.aanhet.net/afm2pl/), among others.

@@ -5030,10 +5041,10 @@ your plain TeX file the command:

\documentstyle[12pt,colordvi]{article}
 
-

For LaTeX 2e, these examples are not applicable. Instead, please see -the documentation for the graphics package, available from -CTAN:doc/latex/graphics/. See also -CTAN:doc/epslatex.ps. +

For LaTeX2e, these examples are not applicable. Instead, please see +the documentation for the graphics package +(https://ctan.org/pkg/graphics), and the epslatex document +(https://ctan.org/pkg/epslatex).

@@ -5483,6 +5494,7 @@ Previous: , Up: %%Page, not generating: + @@ -5524,7 +5536,6 @@ Previous: , Up: -l [=]num: - @@ -5552,6 +5563,7 @@ Previous: , Up: -T ps-tex-enc: + @@ -5755,6 +5767,7 @@ Previous: , Up: dictionary, userdict: + @@ -5876,7 +5889,6 @@ Previous: , Up: hsize (‘psfile’ special option): - @@ -5888,7 +5900,6 @@ Previous: , Up:
- @@ -5904,8 +5915,9 @@ Previous: , Up:
- + + @@ -6005,6 +6017,7 @@ Previous: , Up: output file, sectioning of: + @@ -6089,6 +6102,7 @@ Previous: , Up: pstopk: + @@ -6182,6 +6196,7 @@ Previous: , Up: tftopl: + @@ -6198,6 +6213,7 @@ Previous: , Up: uniform resource locator: + diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf index abd3c89a656..767f8e378c2 100644 Binary files a/Master/texmf-dist/doc/dvips/dvips.pdf and b/Master/texmf-dist/doc/dvips/dvips.pdf differ diff --git a/Master/texmf-dist/doc/info/dvips.info b/Master/texmf-dist/doc/info/dvips.info index 9556053fede..07bdeff39f2 100644 --- a/Master/texmf-dist/doc/info/dvips.info +++ b/Master/texmf-dist/doc/info/dvips.info @@ -1,6 +1,6 @@ -This is dvips.info, produced by makeinfo version 6.7 from dvips.texi. +This is dvips.info, produced by makeinfo version 5.1 from dvips.texi. -This manual documents Dvips version 2020.1 (January 2020), a program to +This manual documents Dvips version 2021.1 (February 2021), 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 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 2020.1 (January 2020), a program to +This manual documents Dvips version 2021.1 (February 2021), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -75,22 +75,14 @@ different size can be used instead, although Dvips will complain loudly about the poor aesthetics of the resulting output. One of the most important features is the support of virtual fonts, -which add an entirely new level of flexibility to TeX. Virtual fonts -are used to give Dvips its excellent PostScript font support, handling -all the font remapping in a natural, portable, elegant, and extensible -way. Dvips even comes with its own Afm2tfm program that creates the -necessary virtual fonts and TeX font metric files automatically from the -Adobe font metric files. +which add an entirely new level of flexibility to TeX. Dvips even comes +with its own Afm2tfm program that can create the virtual fonts and TeX +font metric files automatically from Adobe font metric files. Source is provided and freely distributable, so adding a site-specific feature is possible. Adding such features is made easier by the highly modular structure of the program. - There is really no reason to use another driver, and the more people -use Dvips, the less time will be spent fighting with PostScript and the -more time will be available to create beautiful documents. So if you -don't use Dvips on your system, get it today. - Tom Rokicki wrote and maintains the original Dvips program.  @@ -105,8 +97,7 @@ program. Therefore, for the basic steps involved, *note For solutions to common installation problems and information on how to report a bug, see the file 'kpathsea/BUGS' (*note (kpathsea)Bugs::). -For solutions to Dvips-specific problems, *note Debug options::. Also -see the Dvips home page at . +For solutions to Dvips-specific problems, *note Debug options::. Dvips does require some additional installation, detailed in the sections below. Also, to configure color devices, *note Color device @@ -217,14 +208,14 @@ Ghostscript is a PostScript interpreter freely available to end-users, originally written by Peter Deutsch. It can read the PostScript produced by Dvips and render it on your monitor, or for another device (e.g., an Epson printer) that does not support PostScript, or in PDF -format. The latest version is available via . +format. The latest version is available via . The program Ghostview, originally written by Johannes Plass and Tim Theisen, provides typical previewing capabilities (next page/previous page, magnification, etc.). It requires Ghostscript to run, and files in structured Postscript, specifically with '%%Page' comments (no 'N' in 'config.ps'). The current version is known as GV, and is available from -. +.  File: dvips.info, Node: Diagnosing problems, Prev: Ghostscript installation, Up: Installation @@ -425,9 +416,9 @@ environment variables, and command-line options. * Menu: * Basic usage:: -* Command-line options:: -* Environment variables:: -* Config files:: +* Command-line options:: +* Environment variables:: +* Config files::  File: dvips.info, Node: Basic usage, Next: Command-line options, Up: Invoking Dvips @@ -452,7 +443,7 @@ same fonts over and over again, it hasn't been installed properly. *Note (kpathsea)Unable to generate fonts::.) Many options are available (see the next section). For a brief -summary of available options, just type +summary of available options, run dvips --help @@ -508,6 +499,7 @@ Options: -r* Reverse order of pages -R* Run securely -s* Enclose output in save/restore -S # Max section size in pages -t s Paper format -T c Specify desired page size +-title s Title in comment -u s PS mapfile -U* Disable string param trick -v Print version number and quit -V* Send downloadable PS fonts as PK -x # Override dvi magnification -X # Horizontal resolution @@ -703,7 +695,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. '-L*' By default or with '-L1', the last 'papersize' special wins; with - '-L0', the first special wins. *Note papersize special::. + '-L0', the first special wins. *Note 'papersize' special::. '-m*' Specify manual feed, if supported by the output device. @@ -779,7 +771,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. '-O X-OFFSET,Y-OFFSET' Move the origin by X-OFFSET,Y-OFFSET, a comma-separated pair of - dimensions such as '.1in,-.3cm' (*note papersize special::). The + dimensions such as '.1in,-.3cm' (*note 'papersize' special::). The origin of the page is shifted from the default position (of one inch down, one inch to the right from the upper left corner of the paper) by this amount. This is usually best specified in the @@ -875,9 +867,15 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. information in the output. (If you just have a single page document, you can use '-E' to get pure EPSF output.) +'-title STRING' + Use STRING as the title in the generated PostScript ('%%Title'). + If not specified, the default is the basename of the input file; + for example, running 'dvips /foo/bar.dvi' will have a '%%Title' of + 'bar.dvi'. + '-T HSIZE,VSIZE' Set the paper size to (HSIZE,VSIZE), a comma-separated pair of - dimensions such as '.1in,-.3cm' (*note papersize special::). It + dimensions such as '.1in,-.3cm' (*note 'papersize' special::). It overrides any paper size special in the DVI file. Be careful, as the paper size will stick to a predefined size if there is one close enough. To disable this behavior, use '-tunknown'. @@ -1340,12 +1338,12 @@ attempt to override it manually. * Menu: -* papersize special:: Specifying the paper size in TeX. +* 'papersize' special:: Specifying the paper size in TeX. * Config file paper sizes:: Specifying printer- and site-specific sizes. * Paper trays:: Changing paper trays automatically.  -File: dvips.info, Node: papersize special, Next: Config file paper sizes, Up: Paper size and landscape +File: dvips.info, Node: 'papersize' special, Next: Config file paper sizes, Up: Paper size and landscape 4.1 'papersize' special ======================= @@ -1388,7 +1386,7 @@ the first special wins--this was the behavior of Dvips prior to the 2017 release.  -File: dvips.info, Node: Config file paper sizes, Next: Paper trays, Prev: papersize special, Up: Paper size and landscape +File: dvips.info, Node: Config file paper sizes, Next: Paper trays, Prev: 'papersize' special, Up: Paper size and landscape 4.2 Configuration file paper size command ========================================= @@ -1632,7 +1630,7 @@ File: dvips.info, Node: \includegraphics, Next: EPSF macros, Prev: Bounding b Once the figure file has a bounding box comment (see the previous section) you are ready to import the graphic into a LaTeX document. For -LaTeX 2e, you can use the epsf, graphics or graphicx packages, but the +LaTeX2e, you can use the epsf, graphics or graphicx packages, but the last is recommended--it has the most flexible syntax, and is briefly described here. Further information can be found in 'grfguide' or 'epslatex', which should be included in your LaTeX distribution in DVI, @@ -1685,7 +1683,7 @@ File: dvips.info, Node: EPSF macros, Next: psfile special, Prev: \includegrap 5.1.3 Using the EPSF macros --------------------------- -If you are using LaTeX 2e, use the 'graphics' or 'graphicx' package. +If you are using LaTeX2e, use the 'graphics' or 'graphicx' package. *Note \includegraphics::. If you are using plain TeX or LaTeX 2.09, you need 'epsf.tex' (for @@ -1732,8 +1730,8 @@ terminal when it processes each figure, give the command: * Menu: -* EPSF scaling:: -* EPSF clipping:: +* EPSF scaling:: +* EPSF clipping::  File: dvips.info, Node: EPSF scaling, Next: EPSF clipping, Up: EPSF macros @@ -2005,8 +2003,8 @@ header files are included. * Menu: -* Including headers from TeX:: -* Including headers from the command line:: +* Including headers from TeX:: +* Including headers from the command line:: * Headers and memory usage::  @@ -2294,14 +2292,13 @@ interpreters as well.) Various versions of both PC and Unix distillers are supported; Ghostscript includes limited distiller support (*note Ghostscript installation::). - Macros you can use in your TeX document to insert the specials in the -first place are available from 'CTAN:/support/hypertex'. For CTAN info, -*note (kpathsea)unixtex.ftp::. + By far the most common LaTeX package used to create hyperlinked +output is 'hyperref' (). For plain TeX, +the Eplain package has some hyperlink support +(). This hypertext support (and original form of the documentation) was written by Mark Doyle and Tanmoy Bhattacharya as the 'dvihps' program. -You can retrieve their software and additional documentation via the -CTAN reference above. * Menu: @@ -2351,9 +2348,8 @@ starting '%%BeginFont: CMR10' followed by an entry '/FontType 1 def'. distribution may make those fonts available in a separate optional package (e.g., 'tetex-extra' in Debian). Failing that, commercial versions of the Computer Modern fonts are available from Blue Sky; -public domain versions - in particular, the lm fonts, and the cm-super -fonts, are available from CTAN sites (for CTAN info, *note -(kpathsea)unixtex.ftp::). +public domain versions, in particular, the lm and cm-super font +families, are available from CTAN and in TeX distributions. You can convert a PostScript file to PDF using 'distill', which comes with Adobe Acrobat, or 'ps2pdf', which comes with Ghostscript. The @@ -2625,8 +2621,8 @@ for understanding enough about virtual fonts to use them with Dvips. It isn't a reference manual on virtual fonts. For more information: The primary document on virtual fonts is Donald E. Knuth, 'TUGboat' 11(1), Apr. 1990, pp. 13-23, "Virtual Fonts: More Fun for Grand Wizards" -('CTAN:/info/virtual-fonts.knuth'; for CTAN info, *note -(kpathsea)unixtex.ftp::). (Don't be intimidated by the subtitle.) +(). (Don't be intimidated by +the subtitle.) A virtual font ('.vf') file specifies, for each character in the virtual font, a recipe for typesetting that character. A VF file, like @@ -2647,7 +2643,14 @@ when you run 'vptovf'. You can "expand" virtual fonts into their base fonts with DVIcopy (*note (web2c)dvicopy invocation::). This is useful if you are using a -DVI translator that doesn't understand vf's itself. +DVI translator that doesn't itself understand vf's. + + If a virtual font has no entry at a given codepoint and the first +'MAPFONT' designates an (u)pTeX JFM, we designate the glyph of the same +codepoint in the TFM(JFM) with the smallest font ID. This feature helps +to reduce the size of Japanese virtual fonts. For more information +about the extensive support of Japanese in TeX, see +.  File: dvips.info, Node: Encodings, Next: Bitmap font encodings, Prev: Virtual fonts, Up: Font concepts @@ -2934,8 +2937,8 @@ especially by the reencodings you can specify with those options. You can also obtain special effects such as an oblique font. Alternatives to Afm2tfm for creating virtual fonts include 'fontinst' -, 'lcdf-typetools', particularly -'otftotfm' (), and 'afm2p' +, 'lcdf-typetools', particularly +'otftotfm' (), and 'afm2pl' (), among others. * Menu: @@ -3474,9 +3477,10 @@ plain TeX file the command: \input colordvi For (the obsolete) LaTeX 2.09, add the 'colordvi' style option as in: \documentstyle[12pt,colordvi]{article} -For LaTeX 2e, these examples are not applicable. Instead, please see -the documentation for the graphics package, available from -'CTAN:doc/latex/graphics/'. See also 'CTAN:doc/epslatex.ps'. +For LaTeX2e, these examples are not applicable. Instead, please see the +documentation for the graphics package +(), and the epslatex document +(). These macros provide two basic kinds of color macros: ones for local color changes (a few words, a single symbol) and one for global color @@ -3778,6 +3782,7 @@ Index * %%Page, removing: Option details. (line 165) * %%Page, required by Ghostview: Ghostscript installation. (line 12) +* %%Title: Option details. (line 357) * %%VMusage: Headers and memory usage. (line 12) * %*Font: Fonts in figures. (line 6) @@ -3815,7 +3820,6 @@ Index * -l [=]NUM: Option details. (line 174) * -m: Option details. (line 187) * -M: Option details. (line 199) -* -mode: Option details. (line 190) * -mode MODE: Option details. (line 190) * -N: Option details. (line 212) * -n NUM: Option details. (line 209) @@ -3841,26 +3845,27 @@ Index * -s SLANT: Afm2tfm options. (line 61) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 357) +* -T HSIZE,VSIZE: Option details. (line 363) * -t PAPERTYPE: Option details. (line 337) * -T PS-TEX-ENC: Afm2tfm options. (line 71) * -t TEX-ENC: Changing TeX encodings. (line 6) * -t TEX-ENC <1>: Afm2tfm options. (line 66) -* -U: Option details. (line 372) +* -title STR: Option details. (line 357) +* -U: Option details. (line 378) * -u: Afm2tfm options. (line 75) -* -u PSMAPFILE: Option details. (line 364) -* -v: Option details. (line 380) -* -V: Option details. (line 383) +* -u PSMAPFILE: Option details. (line 370) +* -v: Option details. (line 386) +* -V: Option details. (line 389) * -v VPL-FILE: Afm2tfm options. (line 81) * -V VPL-FILE: Afm2tfm options. (line 84) -* -x NUM: Option details. (line 392) -* -X NUM: Option details. (line 400) -* -Y NUM: Option details. (line 407) +* -x NUM: Option details. (line 398) +* -X NUM: Option details. (line 406) +* -Y NUM: Option details. (line 413) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 416) -* -z for recognizing hyperdvi: Option details. (line 410) -* ..-relative filenames: Option details. (line 317) +* -Z for compressing bitmap fonts: Option details. (line 422) +* -z for recognizing hyperdvi: Option details. (line 416) +* '..'-relative filenames: Option details. (line 317) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3897,7 +3902,7 @@ Index (line 43) * \AA: Reencoding with Afm2tfm. (line 43) -* \COLORNAME: Color macro files. (line 30) +* \COLORNAME: Color macro files. (line 31) * \dot: Reencoding with Afm2tfm. (line 43) * \epsffile macro: EPSF macros. (line 38) @@ -3911,7 +3916,7 @@ Index * \leavevmode: EPSF macros. (line 26) * \magnification: EPSF scaling. (line 62) * \rotninety: Literal examples. (line 27) -* \textCOLORNAME: Color macro files. (line 45) +* \textCOLORNAME: Color macro files. (line 46) * | starting output filename: Option details. (line 247) * a config command (conserve memory): Configuration file commands. (line 21) @@ -3924,8 +3929,8 @@ Index * A4size paper size: Config file paper sizes. (line 90) * absolute filenames, disabling: Option details. (line 317) -* absolute page number, and -l: Option details. (line 174) -* absolute page number, and -p: Option details. (line 277) +* absolute page number, and '-l': Option details. (line 174) +* absolute page number, and '-p': Option details. (line 277) * accent height adjustment, omitting: Afm2tfm options. (line 33) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) @@ -3941,7 +3946,7 @@ Index * Aladdin Ghostscript: Ghostscript installation. (line 6) * Anderson, Laurie: Hypertext specials. (line 42) -* angle (psfile special option): psfile special. (line 36) +* angle ('psfile' special option): psfile special. (line 36) * arcs: Glyph files. (line 17) * ASCII character codes, used by PostScript: PostScript typesetting. (line 31) @@ -3954,7 +3959,7 @@ Index * bbfig: Bounding box. (line 37) * before header, inserting code: Including headers from TeX. (line 28) -* Bhattacharya, Tanmoy: Hypertext. (line 21) +* Bhattacharya, Tanmoy: Hypertext. (line 22) * big points: Bounding box. (line 11) * binary files, not supported: Including graphics fails. (line 23) @@ -3992,7 +3997,7 @@ Index (line 6) * CharStrings Type 1 dictionary: PostScript typesetting. (line 51) -* clip (psfile special option): psfile special. (line 39) +* clip ('psfile' special option): psfile special. (line 39) * clipping of EPSF: EPSF clipping. (line 6) * CODINGSCHEME: Reencoding with Afm2tfm. (line 51) @@ -4001,8 +4006,8 @@ Index * color configuration: Color device configuration. (line 6) * color macros: Color macro files. (line 6) -* color names, mixed case: Color macro files. (line 16) -* color nesting level: Color macro files. (line 38) +* color names, mixed case: Color macro files. (line 17) +* color nesting level: Color macro files. (line 39) * color separations: Option details. (line 31) * color specifications: Color specifications. (line 6) @@ -4020,7 +4025,7 @@ Index * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 416) +* compressing bitmap fonts: Option details. (line 422) * Computer Modern in PostScript: Hypertext caveats. (line 6) * Computer Modern, encoding of: Encodings. (line 15) * condensed fonts: Afm2tfm options. (line 47) @@ -4057,7 +4062,7 @@ Index * copies, collated: Option details. (line 51) * copies, duplicated page bodies: Option details. (line 31) * copies, uncollated: Option details. (line 46) -* Crayola crayon box: Color macro files. (line 16) +* Crayola crayon box: Color macro files. (line 17) * crop.pro: Option details. (line 157) * cropmarks: Option details. (line 157) * current font, in PostScript: PostScript typesetting. @@ -4078,26 +4083,27 @@ Index (line 6) * device dependency, and virtual fonts: Configuration file commands. (line 186) -* dictionary, CharStrings: PostScript typesetting. +* dictionary, 'CharStrings': PostScript typesetting. (line 51) * dictionary, PostScript language: PostScript typesetting. (line 35) -* dictionary, SDict: Literal headers. (line 6) -* dictionary, userdict: Header files. (line 21) -* distillation, and -z: Option details. (line 410) +* dictionary, 'SDict': Literal headers. (line 6) +* dictionary, 'userdict': Header files. (line 21) +* distillation, and '-z': Option details. (line 416) * distiller, for PDF files: Hypertext. (line 11) +* document title, specifying: Option details. (line 357) * dot accent: Reencoding with Afm2tfm. (line 32) * double-sided printing: Option details. (line 37) * downloading fonts partially: psfonts.map. (line 55) * downloading PostScript fonts: psfonts.map. (line 6) -* Doyle, Mark: Hypertext. (line 21) +* Doyle, Mark: Hypertext. (line 22) * draft copies: PostScript hooks. (line 16) * dual paper trays: Paper trays. (line 6) * duplex printers: Including headers from the command line. (line 13) * DVI magnification: EPSF scaling. (line 62) -* dvihps, hyperdvi to PostScript: Hypertext. (line 21) +* dvihps, hyperdvi to PostScript: Hypertext. (line 22) * Dvips configuration file options: Configuration file commands. (line 6) * dvips-all.enc: Bitmap font encodings. @@ -4217,7 +4223,7 @@ Index (line 6) * ghostview: Ghostscript installation. (line 12) -* Ghostview, and no N: Ghostscript installation. +* Ghostview, and no 'N': Ghostscript installation. (line 12) * glyph files: Glyph files. (line 6) * GLYPHFONTS, overrides P: Configuration file commands. @@ -4229,7 +4235,7 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 384) +* gsftopk: Option details. (line 390) * h config command (download additional header): Configuration file commands. (line 57) * H config command (PostScript header path): Configuration file commands. @@ -4249,18 +4255,17 @@ Index (line 6) * hints: PostScript typesetting. (line 55) -* hoffset (psfile special option): psfile special. (line 18) +* hoffset ('psfile' special option): psfile special. (line 18) * HP4Si printer and paper trays: Paper trays. (line 6) * href: Hypertext specials. (line 32) -* hscale (psfile special option): psfile special. (line 30) -* hsize (psfile special option): psfile special. (line 24) +* hscale ('psfile' special option): psfile special. (line 30) +* hsize ('psfile' special option): psfile special. (line 24) * html specials: Hypertext. (line 6) -* html specials, and -z: Option details. (line 410) -* http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21) -* http://xxx.lanl.gov/hypertex: Hypertext. (line 21) +* html specials, and '-z': Option details. (line 416) +* 'http://xxx.lanl.gov/hypertex': Hypertext. (line 22) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 410) +* hyperdvi extensions, enabling: Option details. (line 416) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext caveats <1>: Hypertext caveats. (line 6) @@ -4268,7 +4273,6 @@ Index * hypertext support: Hypertext. (line 6) * i config command (pages/section): Configuration file commands. (line 64) -* idvi Java DVI reader: Hypertext. (line 21) * Illustrator, workaround for: Including graphics fails. (line 10) * img: Hypertext specials. (line 52) @@ -4278,7 +4282,7 @@ Index (line 6) * including headers in TeX: Including headers from TeX. (line 6) -* installation of config.ps: config.ps installation. +* installation of 'config.ps': config.ps installation. (line 6) * installation of PostScript fonts: PostScript font installation. (line 6) @@ -4291,8 +4295,9 @@ Index * invoking Dvips: Invoking Dvips. (line 6) * j config command (partial font downloading): Configuration file commands. (line 68) -* Java DVI reader: Hypertext. (line 21) +* Japanese font metric file: Virtual fonts. (line 37) * Jeffrey, Alan: Invoking afm2tfm. (line 13) +* JFM file, and virtual font fallback: Virtual fonts. (line 37) * K config command (comment removal): Configuration file commands. (line 72) * kerning, defined: Metric files. (line 15) @@ -4303,11 +4308,11 @@ Index * landscape orientation, defined: Paper size and landscape. (line 11) * landscape papertype: Option details. (line 337) -* landscape, as \special: papersize special. (line 16) +* landscape, as '\special': 'papersize' special. (line 16) * last page printed: Option details. (line 174) -* last-resort font scaling, with DVIPSSIZES: Environment variables. +* last-resort font scaling, with 'DVIPSSIZES': Environment variables. (line 47) -* last-resort scaling, with R: Configuration file commands. +* last-resort scaling, with 'R': Configuration file commands. (line 147) * ledger papertype: Option details. (line 337) * legal papertype: Option details. (line 337) @@ -4327,8 +4332,8 @@ Index * literal headers: Literal headers. (line 6) * literal PostScript, examples: Literal examples. (line 6) * literal PostScript, using: Literal PS. (line 6) -* llx (psfile special option): psfile special. (line 42) -* lly (psfile special option): psfile special. (line 42) +* llx ('psfile' special option): psfile special. (line 42) +* lly ('psfile' special option): psfile special. (line 42) * long documents not printing: Long documents fail. (line 6) * low characters, shifting: Option details. (line 122) * lpr spooler, MS-DOS emulation: Option details. (line 247) @@ -4340,8 +4345,8 @@ Index * macros for epsf inclusion: \includegraphics. (line 6) * macros for epsf inclusion <1>: EPSF macros. (line 6) * magnification, DVI: EPSF scaling. (line 62) -* magnification, overriding DVI: Option details. (line 392) -* magnification, vertical: Option details. (line 403) +* magnification, overriding DVI: Option details. (line 398) +* magnification, vertical: Option details. (line 409) * mailcap and hypertext: Hypertext specials. (line 53) * manual feed: Option details. (line 187) * maxdrift: Option details. (line 76) @@ -4370,7 +4375,7 @@ Index * mktexpk, changing name: Environment variables. (line 36) * mode name, specifying: Option details. (line 190) -* mtpk: Option details. (line 384) +* mtpk: Option details. (line 390) * multiple master fonts: psfonts.map. (line 60) * multiple output files: Option details. (line 132) * multiple paper trays: Paper trays. (line 6) @@ -4382,7 +4387,7 @@ Index * no output at all: No output. (line 6) * non-printing characters, shifting: Option details. (line 122) * non-resident fonts: psfonts.map. (line 6) -* nopaper, paper format for -t: Config file paper sizes. +* nopaper, paper format for '-t': Config file paper sizes. (line 74) * o config command (output destination): Configuration file commands. (line 115) @@ -4408,6 +4413,7 @@ Index * output file, setting: Configuration file commands. (line 115) * output files, multiple: Option details. (line 132) +* output title, specifying: Option details. (line 357) * output, inverted: Small or inverted. (line 6) * output, none: No output. (line 6) * output, redirecting: Option details. (line 242) @@ -4422,7 +4428,7 @@ Index * pages, maximum printed: Option details. (line 209) * PaintType: Special font effects. (line 50) -* Pantone colors: Color macro files. (line 16) +* Pantone colors: Color macro files. (line 17) * paper size configuration file command: Config file paper sizes. (line 6) * paper size, default: config.ps installation. @@ -4431,15 +4437,15 @@ Index (line 6) * paper trays: Paper trays. (line 6) * paper type: Option details. (line 337) -* papersize special: papersize special. (line 6) -* papersize special, and no -t: Option details. (line 337) -* papersize special, first vs. last: Option details. (line 183) +* papersize special: 'papersize' special. (line 6) +* papersize special, and no '-t': Option details. (line 337) +* 'papersize' special, first vs. last: Option details. (line 183) * partial font downloading: psfonts.map. (line 55) * PDF files, font quality: Hypertext caveats. (line 6) * PDF files, making: Ghostscript installation. (line 6) * PDF files, making <1>: Hypertext. (line 11) -* PDF files, option for: Option details. (line 410) +* PDF files, option for: Option details. (line 416) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4447,14 +4453,14 @@ Index * pfm files: Metric files. (line 48) * Phaser printer, used for color calibration: Color device configuration. (line 18) -* physical page number, and -l: Option details. (line 174) -* physical page number, and -p: Option details. (line 277) -* physical page number, and bop-hook: PostScript hooks. (line 26) +* physical page number, and '-l': Option details. (line 174) +* physical page number, and '-p': Option details. (line 277) +* physical page number, and 'bop-hook': PostScript hooks. (line 26) * pipes, not readable: Option details. (line 103) * pk files: Glyph files. (line 35) * PKFONTS, overrides P: Configuration file commands. (line 135) -* plotfile, ps subspecial: ps special. (line 29) +* plotfile, 'ps' subspecial: ps special. (line 29) * pltotf: Metric files. (line 39) * popen for output: Option details. (line 247) * portrait orientation, defined: Paper size and landscape. @@ -4466,7 +4472,7 @@ Index * PostScript encoding: Encodings. (line 27) * PostScript encoding, changing: Changing PostScript encodings. (line 6) -* PostScript font alias file: Option details. (line 364) +* PostScript font alias file: Option details. (line 370) * PostScript font alias file <1>: Configuration file commands. (line 126) * PostScript fonts: PostScript fonts. (line 6) @@ -4499,7 +4505,7 @@ Index * printer offset: Option details. (line 259) * PRINTER, and config file searching: Configuration file searching. (line 36) -* PRINTER, avoided with -f: Option details. (line 103) +* PRINTER, avoided with '-f': Option details. (line 103) * printer, driving directly: Option details. (line 115) * problems: Diagnosing problems. (line 6) * property list files: Metric files. (line 39) @@ -4513,10 +4519,11 @@ Index (line 19) * psfonts.map <2>: psfonts.map. (line 6) * psheaderdir: Header files. (line 12) -* psi character missing: Hypertext caveats. (line 54) -* pstopk: Option details. (line 384) +* psi character missing: Hypertext caveats. (line 53) +* pstopk: Option details. (line 390) * pTeX extensions: Option details. (line 220) * pTeX extensions <1>: Option details. (line 226) +* ptex JFM: Virtual fonts. (line 37) * q config command (quiet): Configuration file commands. (line 141) * Q config command (quiet): Configuration file commands. @@ -4536,17 +4543,17 @@ Index * remapping: Reencoding with Afm2tfm. (line 6) * resident fonts, different in different printers: Option details. - (line 364) + (line 370) * resident fonts, different in different printers <1>: Configuration file commands. (line 126) -* resolution: Option details. (line 400) -* resolution <1>: Option details. (line 407) +* resolution: Option details. (line 406) +* resolution <1>: Option details. (line 413) * resolution, setting: Option details. (line 63) * reverse pagination: Option details. (line 314) -* rhi (psfile special option): psfile special. (line 46) -* Rokicki, Tomas: Why Dvips. (line 60) +* rhi ('psfile' special option): psfile special. (line 46) +* Rokicki, Tomas: Why Dvips. (line 52) * rotate.tex: ps special. (line 33) -* rwi (psfile special option): psfile special. (line 46) +* rwi ('psfile' special option): psfile special. (line 46) * s config command (global save/restore): Configuration file commands. (line 169) * S config command (pict path): Configuration file commands. @@ -4587,7 +4594,7 @@ Index * small caps fonts: Special font effects. (line 34) * Smith, Arthur: Hypertext specials. (line 6) -* spaces, dropped trailing: Hypertext caveats. (line 54) +* spaces, dropped trailing: Hypertext caveats. (line 53) * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) * spooler, lacking: Option details. (line 115) @@ -4640,10 +4647,11 @@ Index * Theisen, Tim: Ghostscript installation. (line 12) * tight bounding box, finding: Option details. (line 87) +* title, specifying: Option details. (line 357) * too-small output: Small or inverted. (line 6) * trademark character, accessing: Changing PostScript encodings. (line 18) -* trailing spaces, dropped: Hypertext caveats. (line 54) +* trailing spaces, dropped: Hypertext caveats. (line 53) * TranScript: Option details. (line 212) * transforming downloaded fonts: psfonts.map. (line 19) * trouble: Diagnosing problems. (line 6) @@ -4656,13 +4664,14 @@ Index * uncompressing PostScript: Dynamic creation of graphics. (line 6) * uniform resource locator: Hypertext specials. (line 20) -* unknown, paper format for -t: papersize special. (line 29) -* unknown, paper format for -t <1>: Config file paper sizes. +* unknown, paper format for '-t': 'papersize' special. (line 29) +* unknown, paper format for '-t' <1>: Config file paper sizes. (line 69) +* uptex JFM: Virtual fonts. (line 37) * URL, definition: Hypertext specials. (line 27) * URL, extended for TeX: Hypertext specials. (line 20) -* urx (psfile special option): psfile special. (line 42) -* ury (psfile special option): psfile special. (line 42) +* urx ('psfile' special option): psfile special. (line 42) +* ury ('psfile' special option): psfile special. (line 42) * usage, basic: Basic usage. (line 6) * user-definable colors: User-definable colors. (line 6) @@ -4680,12 +4689,12 @@ Index * VM exhausted: Printer errors. (line 14) * VMusage: Headers and memory usage. (line 12) -* voffset (psfile special option): psfile special. (line 21) +* voffset ('psfile' special option): psfile special. (line 21) * vpl files: Virtual fonts. (line 16) * vptovf: Making a font available. (line 52) -* vscale (psfile special option): psfile special. (line 33) -* vsize (psfile special option): psfile special. (line 27) +* vscale ('psfile' special option): psfile special. (line 33) +* vsize ('psfile' special option): psfile special. (line 27) * W config command (emit warning): Configuration file commands. (line 191) * warning messages, defining: Configuration file commands. @@ -4695,7 +4704,7 @@ Index * wide fonts: psfonts.map. (line 19) * X config command (horizontal resolution): Configuration file commands. (line 198) -* Xerox 4045: Option details. (line 372) +* Xerox 4045: Option details. (line 378) * Y config command (vertical resolution): Configuration file commands. (line 201) * Z config command (compress fonts): Configuration file commands. @@ -4706,88 +4715,83 @@ Index  Tag Table: -Node: Top520 -Node: Why Dvips1269 -Node: Installation4286 -Node: config.ps installation5289 -Node: PostScript font installation7896 -Node: Ghostscript installation8816 -Node: Diagnosing problems9753 -Node: Debug options10844 -Node: No output11848 -Node: Small or inverted13314 -Node: Printer errors14032 -Node: Long documents fail15364 -Node: Including graphics fails15705 -Node: Invoking Dvips16944 -Node: Basic usage17535 -Node: Command-line options18539 -Node: Option summary18987 -Node: Option details21236 -Node: Environment variables41202 -Node: Config files44063 -Node: Configuration file searching44733 -Node: Configuration file commands47930 -Node: Paper size and landscape55904 -Node: papersize special57529 -Node: Config file paper sizes59237 -Node: Paper trays63393 -Node: Interaction with PostScript64727 -Node: PostScript figures65380 -Node: Bounding box66106 -Node: \includegraphics69478 -Node: EPSF macros71771 -Node: EPSF scaling73740 -Node: EPSF clipping76310 -Node: psfile special76952 -Node: Dynamic creation of graphics79344 -Node: Fonts in figures80662 -Node: Header files82312 -Node: Including headers from TeX83518 -Node: Including headers from the command line85556 -Node: Headers and memory usage86655 -Node: Literal PS87866 -Node: " special88448 -Node: ps special89189 -Node: Literal headers90687 -Node: PostScript hooks91396 -Node: Literal examples93492 -Node: Hypertext94946 -Node: Hypertext caveats96175 -Node: Hypertext specials100563 -Node: PostScript fonts103197 -Node: Font concepts104314 -Node: Metric files105544 -Node: Glyph files108324 -Node: Virtual fonts110683 -Node: Encodings112509 -Node: Bitmap font encodings114911 -Node: PostScript typesetting117441 -Node: Making a font available120538 -Node: Invoking afm2tfm125572 -Node: Changing font encodings126589 -Node: Changing TeX encodings127380 -Node: Changing PostScript encodings128482 -Node: Changing both encodings129826 -Node: Reencoding with Afm2tfm130500 -Node: Encoding file format133603 -Node: Special font effects137807 -Node: Afm2tfm options140067 -Node: psfonts.map143592 -Node: Color148322 -Node: Color macro files149366 -Node: User-definable colors152559 -Node: Color subtleties153835 -Node: Ted Turner155487 -Node: Color device configuration156712 -Node: Color support details159156 -Node: Color specifications159534 -Node: Color specials160938 -Node: Index163067 +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 usage17068 +Node: Command-line options18066 +Node: Option summary18514 +Node: Option details20789 +Node: Environment variables41006 +Node: Config files43867 +Node: Configuration file searching44537 +Node: Configuration file commands47734 +Node: Paper size and landscape55708 +Node: 'papersize' special57335 +Node: Config file paper sizes59045 +Node: Paper trays63203 +Node: Interaction with PostScript64537 +Node: PostScript figures65190 +Node: Bounding box65916 +Node: \includegraphics69288 +Node: EPSF macros71580 +Node: EPSF scaling73579 +Node: EPSF clipping76149 +Node: psfile special76791 +Node: Dynamic creation of graphics79183 +Node: Fonts in figures80501 +Node: Header files82151 +Node: Including headers from TeX83361 +Node: Including headers from the command line85399 +Node: Headers and memory usage86498 +Node: Literal PS87709 +Node: " special88291 +Node: ps special89032 +Node: Literal headers90530 +Node: PostScript hooks91239 +Node: Literal examples93335 +Node: Hypertext94789 +Node: Hypertext caveats95963 +Node: Hypertext specials100319 +Node: PostScript fonts102953 +Node: Font concepts104070 +Node: Metric files105300 +Node: Glyph files108080 +Node: Virtual fonts110439 +Node: Encodings112594 +Node: Bitmap font encodings114996 +Node: PostScript typesetting117526 +Node: Making a font available120623 +Node: Invoking afm2tfm125657 +Node: Changing font encodings126677 +Node: Changing TeX encodings127468 +Node: Changing PostScript encodings128570 +Node: Changing both encodings129914 +Node: Reencoding with Afm2tfm130588 +Node: Encoding file format133691 +Node: Special font effects137895 +Node: Afm2tfm options140155 +Node: psfonts.map143680 +Node: Color148410 +Node: Color macro files149454 +Node: User-definable colors152664 +Node: Color subtleties153940 +Node: Ted Turner155592 +Node: Color device configuration156817 +Node: Color support details159261 +Node: Color specifications159639 +Node: Color specials161043 +Node: Index163172  End Tag Table - - -Local Variables: -coding: utf-8 -End: diff --git a/Master/texmf-dist/doc/info/kpathsea.info b/Master/texmf-dist/doc/info/kpathsea.info index 2744e1176d4..66b0a4e2f90 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -1,9 +1,9 @@ -This is kpathsea.info, produced by makeinfo version 6.7 from +This is kpathsea.info, produced by makeinfo version 5.1 from kpathsea.texi. This file documents the Kpathsea library for path searching. - Copyright (C) 1996-2020 Karl Berry & Olaf Weber. + Copyright (C) 1996-2021 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 @@ Kpathsea library **************** This manual documents the Kpathsea library for path searching. It -corresponds to version 6.3.2, released in March 2020. +corresponds to version 6.3.3, released in February 2021. * Menu: @@ -61,8 +61,8 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T 1 Introduction ************** -This manual corresponds to version 6.3.2 of the Kpathsea library, -released in March 2020. +This manual corresponds to version 6.3.3 of the Kpathsea library, +released in February 2021. 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 @@ -3038,7 +3038,7 @@ Index * !! and casefolding: Casefolding examples. (line 57) * !! in path specifications: ls-R. (line 57) -* !! in TEXMFDBS: ls-R. (line 11) +* !! in 'TEXMFDBS': ls-R. (line 11) * $ expansion: Variable expansion. (line 6) * --all: Path searching options. (line 12) @@ -3046,7 +3046,7 @@ Index (line 19) * --cnf-line: Path searching options. (line 28) -* --cnf-line, source for path: Path sources. (line 9) +* '--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. @@ -3092,12 +3092,12 @@ Index * --without-mktexpk-default: mktex configuration. (line 12) * --without-mktextfm-default: mktex configuration. (line 12) * -1 debugging value: Debugging. (line 23) -* -A option to ls: ls-R. (line 39) +* -A option to 'ls': ls-R. (line 39) * -D NUM: Path searching options. (line 49) * -iname, find predicate: Casefolding examples. (line 78) -* -L option to ls: ls-R. (line 44) +* -L option to 'ls': ls-R. (line 44) * . directories, ignored: ls-R. (line 39) * . files: ls-R. (line 39) * .2602gf: Unable to generate fonts. @@ -3174,7 +3174,7 @@ Index (line 195) * .pro: Supported file formats. (line 169) -* .PROGNAME qualifier in texmf.cnf: Config files. (line 50) +* .PROGNAME qualifier in 'texmf.cnf': Config files. (line 50) * .rhosts, writable by TeX: Security. (line 10) * .ris: Supported file formats. (line 173) @@ -3184,7 +3184,7 @@ Index (line 42) * .tex: Supported file formats. (line 180) -* .tex file, included in ls-R: ls-R. (line 39) +* .tex file, included in 'ls-R': ls-R. (line 39) * .tfm: Supported file formats. (line 199) * .ttc: Supported file formats. @@ -3212,9 +3212,9 @@ Index * 8.3 filenames, using: mktex configuration. (line 68) * : may not be :: Searching overview. (line 13) * :: expansion: Default expansion. (line 6) -* ; translated to : in texmf.cnf: Config files. (line 66) -* = omitted in texmf.cnf and misparsing: Config files. (line 93) -* \, line continuation in texmf.cnf: Config files. (line 37) +* ; translated to ':' in 'texmf.cnf': Config files. (line 66) +* = omitted in 'texmf.cnf' and misparsing: Config files. (line 93) +* \, line continuation in 'texmf.cnf': Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. (line 31) @@ -3237,15 +3237,15 @@ Index * announcement mailing list: Mailing lists. (line 6) * API, re-entrant: Programming overview. (line 16) -* append-only directories and mktexpk: Security. (line 36) +* append-only directories and 'mktexpk': Security. (line 36) * appendonlydir: mktex configuration. (line 60) * Apple filesystem, case-insensitive: Casefolding rationale. (line 6) -* arguments to mktex: mktex script arguments. +* arguments to 'mktex': mktex script arguments. (line 6) * argv[0]: Calling sequence. (line 14) * autoconf, recommended: Calling sequence. (line 117) -* automounter, and ls-R: ls-R. (line 46) +* automounter, and 'ls-R': ls-R. (line 46) * auxiliary tasks: Auxiliary tasks. (line 6) * Bach, Johann Sebastian: Default expansion. (line 41) * backslash-newline: Config files. (line 37) @@ -3255,7 +3255,7 @@ Index (line 30) * BIBINPUTS <1>: Supported file formats. (line 121) -* blank lines, in texmf.cnf: Config files. (line 35) +* blank lines, in 'texmf.cnf': Config files. (line 35) * BLTXMLINPUTS: Supported file formats. (line 34) * brace expansion: Brace expansion. (line 6) @@ -3283,7 +3283,7 @@ Index * checksum: Suppressing warnings. (line 16) * circle fonts: Fontmap. (line 19) -* client_path in kpse->format_info: Calling sequence. (line 47) +* client_path in 'kpse->format_info': Calling sequence. (line 47) * CLUAINPUTS: Supported file formats. (line 42) * CMAPFONTS: Supported file formats. @@ -3294,7 +3294,7 @@ Index * cnf.h: Programming with config files. (line 27) * comments, in fontmap files: Fontmap. (line 27) -* comments, in texmf.cnf: Config files. (line 27) +* comments, in 'texmf.cnf': Config files. (line 27) * comments, making: Introduction. (line 29) * common features in glyph lookup: Basic glyph lookup. (line 6) * common problems: Common problems. (line 6) @@ -3320,8 +3320,9 @@ Index * configuration bugs: Bug checklist. (line 27) * configuration file, source for path: Path sources. (line 20) * configuration files as shell scripts.: Config files. (line 86) -* configuration of mktex scripts: mktex configuration. (line 6) -* configure options for mktex scripts: mktex configuration. (line 12) +* configuration of 'mktex' scripts: mktex configuration. (line 6) +* 'configure' options for 'mktex' scripts: mktex configuration. + (line 12) * context diff: Bug checklist. (line 52) * continuation character: Config files. (line 37) * core dumps, reporting: Bug checklist. (line 58) @@ -3345,7 +3346,7 @@ Index * directory permissions: Security. (line 51) * directory structure, for TeX files: TeX directory structure. (line 6) -* disabling mktex scripts: mktex configuration. (line 6) +* disabling 'mktex' scripts: mktex configuration. (line 6) * disk search: Searching overview. (line 22) * disk searching, avoiding: ls-R. (line 57) * disk usage, reducing: Logging. (line 6) @@ -3372,7 +3373,7 @@ Index (line 41) * elt-dirs.c <1>: Subdirectory expansion. (line 48) -* enabling mktex scripts: mktex configuration. (line 6) +* enabling 'mktex' scripts: mktex configuration. (line 6) * ENCFONTS: Supported file formats. (line 61) * engine name: Path searching options. @@ -3401,7 +3402,7 @@ Index * extensions, filename: File lookup. (line 24) * externally-built filename database: Filename database. (line 6) * extra colons: Default expansion. (line 6) -* failed mktex... script invocation: mktex script names. (line 35) +* failed 'mktex...' script invocation: mktex script names. (line 35) * fallback font: Fallback font. (line 6) * fallback resolutions: Fallback font. (line 6) * FAQ, Kpathsea: Common problems. (line 6) @@ -3487,7 +3488,7 @@ Index (line 151) * interface, not frozen: Introduction. (line 29) * introduction: Introduction. (line 6) -* kdebug:: Debugging. (line 105) +* 'kdebug:': Debugging. (line 105) * kdefault.c: Default expansion. (line 48) * Knuth, Donald E.: History. (line 6) * Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20) @@ -3590,9 +3591,9 @@ Index (line 20) * mkocp: mktex script names. (line 18) * mkofm: mktex script names. (line 21) -* mktex script configuration: mktex configuration. (line 6) -* mktex script names: mktex script names. (line 6) -* mktex scripts: mktex scripts. (line 6) +* 'mktex' script configuration: mktex configuration. (line 6) +* 'mktex' script names: mktex script names. (line 6) +* 'mktex' scripts: mktex scripts. (line 6) * mktex.cnf: Specially-recognized files. (line 28) * mktex.cnf <1>: mktex configuration. (line 29) @@ -3602,7 +3603,7 @@ Index * mktexfmt: mktex script names. (line 10) * mktexmf: mktex script names. (line 15) * mktexpk: mktex script names. (line 24) -* mktexpk can't guess mode: Unable to generate fonts. +* 'mktexpk' can't guess mode: Unable to generate fonts. (line 12) * mktextex: mktex script names. (line 27) * mktextfm: mktex script names. (line 30) @@ -3623,9 +3624,9 @@ Index * MT_FEATURES: mktex configuration. (line 39) * multiple TeX hierarchies: Brace expansion. (line 20) * must exist: Searching overview. (line 31) -* names for mktex scripts: mktex script names. (line 6) +* names for 'mktex' scripts: mktex script names. (line 6) * Neumann, Gustaf: History. (line 56) -* NFS and ls-R: ls-R. (line 46) +* NFS and 'ls-R': ls-R. (line 46) * nomfdrivers: mktex configuration. (line 92) * nomode: mktex configuration. (line 97) * none: Suppressing warnings. @@ -3738,7 +3739,7 @@ Index * shell variables: Variable expansion. (line 17) * shell_escape, example for code: Programming with config files. (line 10) -* site overrides for mktex...: mktex configuration. (line 29) +* site overrides for 'mktex...': mktex configuration. (line 29) * skeleton TeX directory: TeX directory structure. (line 6) * slow startup time: Slow path searching. (line 6) @@ -3773,7 +3774,7 @@ Index (line 6) * symbolic links not found: Unable to find files. (line 21) -* symbolic links, and ls-R: ls-R. (line 44) +* symbolic links, and 'ls-R': ls-R. (line 44) * symlinks, resolving: Calling sequence. (line 31) * system C compiler bugs: TeX or Metafont failing. (line 16) @@ -3839,7 +3840,7 @@ Index (line 6) * texmf.cnf: Specially-recognized files. (line 38) -* texmf.cnf missing, warning about: Config files. (line 18) +* 'texmf.cnf' missing, warning about: Config files. (line 18) * texmf.cnf, and variable expansion: Variable expansion. (line 6) * texmf.cnf, definition for: Config files. (line 6) * texmf.cnf, source for path: Path sources. (line 20) @@ -3884,7 +3885,7 @@ Index * tilde.c: Tilde expansion. (line 25) * time system call: Logging. (line 15) * tolerance for glyph lookup: Basic glyph lookup. (line 15) -* trailing / in home directory: Tilde expansion. (line 19) +* trailing '/' in home directory: Tilde expansion. (line 19) * trailing colons: Default expansion. (line 6) * translations, of path searching description: Path searching. (line 10) @@ -3910,7 +3911,7 @@ Index * unreadable file warnings: Suppressing warnings. (line 27) * unreadable files: Searching overview. (line 63) -* unusable ls-R warning: ls-R. (line 51) +* unusable 'ls-R' warning: ls-R. (line 51) * usage patterns, finding: Logging. (line 6) * USERPROFILE, as ~ expansion: Tilde expansion. (line 6) * USE_TEXMFVAR: mktex configuration. (line 128) @@ -3928,8 +3929,8 @@ Index (line 219) * Vojta, Paul: History. (line 30) * Walsh, Norman: History. (line 56) -* warning about unusable ls-R: ls-R. (line 51) -* warning, about missing texmf.cnf: Config files. (line 18) +* warning about unusable 'ls-R': ls-R. (line 51) +* warning, about missing 'texmf.cnf': Config files. (line 18) * warnings, file access: Searching overview. (line 63) * warnings, suppressing: Suppressing warnings. (line 6) @@ -3956,66 +3957,61 @@ Index  Tag Table: Node: Top1480 -Node: Introduction2260 -Node: History4327 -Node: unixtex.ftp8923 -Node: Security10393 -Node: TeX directory structure12897 -Node: Path searching16938 -Node: Searching overview17896 -Node: Path sources21715 -Node: Config files22941 -Node: Path expansion28204 -Node: Default expansion29157 -Node: Variable expansion31227 -Node: Tilde expansion32628 -Node: Brace expansion33608 -Node: KPSE_DOT expansion34547 -Node: Subdirectory expansion35060 -Node: Casefolding search37408 -Node: Casefolding rationale38177 -Node: Casefolding examples39523 -Node: Filename database44569 -Node: ls-R45551 -Node: Filename aliases49227 -Node: Database format50405 -Node: Invoking kpsewhich51418 -Node: Path searching options52373 -Node: Specially-recognized files61971 -Node: Auxiliary tasks63326 -Node: Standard options67051 -Node: TeX support67407 -Node: Supported file formats68761 -Node: File lookup76429 -Node: Glyph lookup78178 -Node: Basic glyph lookup79302 -Node: Fontmap80182 -Node: Fallback font82711 -Node: Suppressing warnings83623 -Node: mktex scripts84750 -Node: mktex configuration85965 -Node: mktex script names91768 -Node: mktex script arguments93154 -Node: Programming94033 -Node: Programming overview94606 -Node: Calling sequence97467 -Node: Program-specific files103996 -Node: Programming with config files105019 -Node: Reporting bugs106606 -Node: Bug checklist107284 -Node: Mailing lists110753 -Node: Debugging111430 -Node: Logging116507 -Node: Common problems118374 -Node: Unable to find files118851 -Node: Slow path searching121261 -Node: Unable to generate fonts122636 -Node: TeX or Metafont failing125108 -Node: Index126310 +Node: Introduction2263 +Node: History4333 +Node: unixtex.ftp8929 +Node: Security10399 +Node: TeX directory structure12903 +Node: Path searching16944 +Node: Searching overview17902 +Node: Path sources21721 +Node: Config files22947 +Node: Path expansion28210 +Node: Default expansion29163 +Node: Variable expansion31233 +Node: Tilde expansion32634 +Node: Brace expansion33614 +Node: KPSE_DOT expansion34553 +Node: Subdirectory expansion35066 +Node: Casefolding search37414 +Node: Casefolding rationale38183 +Node: Casefolding examples39529 +Node: Filename database44575 +Node: ls-R45557 +Node: Filename aliases49233 +Node: Database format50411 +Node: Invoking kpsewhich51424 +Node: Path searching options52379 +Node: Specially-recognized files61977 +Node: Auxiliary tasks63332 +Node: Standard options67057 +Node: TeX support67413 +Node: Supported file formats68767 +Node: File lookup76435 +Node: Glyph lookup78184 +Node: Basic glyph lookup79308 +Node: Fontmap80188 +Node: Fallback font82717 +Node: Suppressing warnings83629 +Node: mktex scripts84756 +Node: mktex configuration85971 +Node: mktex script names91774 +Node: mktex script arguments93160 +Node: Programming94039 +Node: Programming overview94612 +Node: Calling sequence97473 +Node: Program-specific files104002 +Node: Programming with config files105025 +Node: Reporting bugs106612 +Node: Bug checklist107290 +Node: Mailing lists110759 +Node: Debugging111436 +Node: Logging116513 +Node: Common problems118380 +Node: Unable to find files118857 +Node: Slow path searching121267 +Node: Unable to generate fonts122642 +Node: TeX or Metafont failing125114 +Node: Index126316  End Tag Table - - -Local Variables: -coding: utf-8 -End: diff --git a/Master/texmf-dist/doc/info/tlbuild.info b/Master/texmf-dist/doc/info/tlbuild.info index 6c34b8095d4..2a386027bc7 100644 --- a/Master/texmf-dist/doc/info/tlbuild.info +++ b/Master/texmf-dist/doc/info/tlbuild.info @@ -3,7 +3,7 @@ tlbuild.texi. This file documents the TeX Live build system and more. -Copyright (C) 2016-2020 Karl Berry. +Copyright (C) 2016-2021 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 @@ END-INFO-DIR-ENTRY  File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir) -Building TeX Live (2020) +Building TeX Live (2021) ************************ For an overview of this manual, *note Introduction::. @@ -59,7 +59,8 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated March 2020) corresponds to the TeX Live 2020 release. +This manual (dated February 2021) corresponds to the TeX Live 2021 +release. This manual is aimed at system installers and programmers, and focuses on how to configure, build, and develop the TeX Live (TL) @@ -167,9 +168,9 @@ notably FreeType; all the TL-maintained directories (and Automake/Autoconf output in general) work with any reasonable 'make'. A C++11 compiler is similarly required because of the third-party -libraries ICU and Poppler; the program 'dvisvgm' also requires C++11. -It is possible to build everything else with older compilers, but you -have to remove the C++11-dependent sources. *Note Build one package::. +library ICU; the program 'dvisvgm' also requires C++11. It is possible +to build everything else with older compilers, but you have to remove +the C++11-dependent sources. *Note Build one package::. A few programs in the tree have additional requirements: @@ -328,8 +329,8 @@ invoked to build an individual program or library, first building any required libraries. Here is an example from start to finish for working on 'dvipdfm-x'. -(Unfortunately, this does not suffice for building one, or a subset, of -the TeX engines; see the next section.) +(Unfortunately, this does not suffice for building the TeX engines; see +the next section.) mkdir mydir && cd mydir # new working directory @@ -383,7 +384,7 @@ an older compiler lacking such support, you need to (re)move those source directories; specifying '--disable' for them does not suffice, unfortunately. Specifically, before running 'configure': - rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm + rm -rf libs/icu libs/graphite2 texk/dvisvgm Also, even with '--disable-all-pkgs', dependencies are (currently) checked. For instance, if a (non-MacOSX) system does not have @@ -409,19 +410,31 @@ wanting to build one, or a subset, of the TeX engines (or other Web2c programs). The simplest way to do this is to disable everything and then -explicitly specify what to make. For example, to build only LuaTeX: +explicitly specify what to make. For example, to build only the +original TeX: - ./configure --disable-all-pkgs # or ./Build - cd Work/texk/web2c # build directory - make luatex # specify target + cd Work # top build directory + ../configure --without-x --disable-shared --disable-all-pkgs \ + --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g + make + cd texk/web2c # cd engine build directory + make tex # must specify target - This works because the 'make' automatically runs 'configure' as -necessary for the dependencies and target. Furthermore, the source tree -can be cut down to just what is needed for the given engine (the -separate pdfTeX and LuaTeX source repositories do this, if you want to -peruse examples). + The first 'make' run will configure everything, and even build the +libraries, even though the packages are disabled. The source tree can +be cut down to just what is needed for the given engine (the separate +pdfTeX and LuaTeX source repositories do this, for example), but see +caveats in previous section. - We hope to improve the situation in the future. Patches are welcome. + If you want to debug an X-related program or shared library setup, or +other variants, change the 'configure' options accordingly. Either +'../Build' or '../configure' can be run. + + Then it is necessary to again specify the target engine ('tex', in +the above) in the 'make'. + + All this is somewhat unfortunate. We hope to improve the situation +in the future. Patches are welcome.  File: tlbuild.info, Node: Cross compilation, Prev: Build one engine, Up: Building @@ -745,8 +758,8 @@ many extra hassles, so don't do that, tempting as it may be. Currently the versions we use are: autoconf (GNU Autoconf) 2.69 - automake (GNU automake) 1.16.1 - bison (GNU Bison) 3.5.2 + automake (GNU automake) 1.16.2 + bison (GNU Bison) 3.7.4 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 @@ -1310,7 +1323,8 @@ In that case, as above, we put the upstream sources into a subdirectory 'configure' in this original '...-src' directory, but only in our own directory; but we do compile using the source files in '...-src'. - So, to summarize the files that we must (usually) create: + So, to summarize the files that must (usually) be created inside a +new TL source directory ('texk/newprog' or 'utils/newprog'): 'ac/withenable.ac' The 'KPSE_ENABLE_PROG' call just explained. @@ -1318,37 +1332,67 @@ directory; but we do compile using the source files in '...-src'. 'configure.ac' 'Makefile.am' By merging the contents of the original 'configure.ac' (if - provided) and a comparable program already in TL. There is no magic - recipe, it's necessary to think about needs to be done in the - original vs. in TeX Live. + provided) and a comparable program already in TL. In the above + example, one line that will be needed in 'configure.ac' (can be + added before the 'AC_CONFIG_FILES' at the end) is: + + AC_SUBST([NEWPROG_TREE], [newprog-src]) + + and then use '@NEWPROG_TREE@' in 'Makefile.am' where needed. + + In general, there is no magic recipe for this part of the job. + It's necessary to think about what needs to be done in the original + vs. in TeX Live. It's useful to look at the setup for the most + comparable programs already in TL that you can find. It's also + useful to grep the entire 'Build/source' tree for whatever you can + think of to investigate how something is done. Most of the + TL-specific macros are defined in 'Build/source/m4/*'. 'TLpatches/TL-Changes' - Actions taken after getting the original source tree; typically - removal of derived or unused common files. + First actions taken after getting the original source tree; + typically removal of derived or unused common files. 'TLpatches/patch-...' If any changes are needed to the original sources, record the - patches here so they can be applied next time. And send them - upstream so that perhaps they won't have to be. + patches here so they can be applied next time. Also, send them + upstream so that we don't have to maintain them forever. 'ChangeLog' Record all TL-specific changes, now and in the future. - Then, run GNU 'autoreconf' in the new directory (*note Build system -tools::). After that works, '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 not have to run any autotools, but can simply run -'configure'.) - - Then, run the TL tool 'reautoconf' in the top-level TL 'source/' -directory, to incorporate the new program into the build tree. - - Then, run (and rerun) a build until the program compiles and tests -successfully, probably involving rerunning autoreconf in the source -directory, 'make' in the build directory, etc. - - After final success, don't forget to commit. + 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 +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 +not have to run any autotools, but can simply run 'configure'.) + + To reiterate: do not fail to commit the generated 'configure' and +other files. The m4 code in 'kpse-pkgs.m4' uses the existence of +'configure' to determine whether to descend into (and configure) a given +subdirectory. + + Then, run the TL tool 'reautoconf' in the top-level TL +'Build/source/' directory, to incorporate the new program into the build +tree. It is good to then rebuild the whole tree (e.g., using TL's +'Build/Build' script) to get all the necessary files generated. + + It will probably fail. So then you need to keep at it until the +program compiles and tests successfully. The most efficient way is to +rerun 'autoreconf' as needed in the new source directory +('Build/source/.../newprog'), then 'make' in the corresponding build +directory ('Build/work/.../newprog'), then 'make check', etc. In the +end, also make sure that the whole tree builds from scratch. + + After final success, don't forget to commit. (Or email the TL +maintainers with the patch.) + + Caveat: adding a new TeX engine is not completely different, but it's +not all that similar, either. In that case, the work is done inside a +new subdirectory of 'texk/web2c/'. Many things are common to all the +engines, other things need to be copied and possibly modified for each +one, yet others are unique to each. No general recipe is possible.  File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a new TeX-specific library module, Prev: Adding a new program module, Up: Extending TeX Live @@ -1514,9 +1558,7 @@ of 'DVI' and 'GF' files must always be <2GB, due to the file format specifications. With LFS, there is no fixed limit on the size of PDF files created by -'pdftex' or PostScript files created by 'dvips'. The size of PDF images -included by 'pdftex' or 'luatex' must, however, be <2GB when using -'poppler' version 0.22 or before (even on 64-bit systems with LFS). +'pdftex' or PostScript files created by 'dvips'.  File: tlbuild.info, Node: --disable-missing, Next: --enable-compiler-warnings=LEVEL, Prev: --disable-largefile, Up: Global configure options @@ -1856,10 +1898,9 @@ required system libraries and bails out if tests fail. * Menu: * Configure options for kpathsea:: -* Configure options for system poppler::  -File: tlbuild.info, Node: Configure options for kpathsea, Next: Configure options for system poppler, Up: Library-specific configure options +File: tlbuild.info, Node: Configure options for kpathsea, Up: Library-specific configure options 7.3.1 Configure options for 'kpathsea' -------------------------------------- @@ -1885,24 +1926,6 @@ is one of: to generate the specified type of file dynamically. The default can be overridden by the user in any case (*note kpathsea library::). - -File: tlbuild.info, Node: Configure options for system poppler, Prev: Configure options for kpathsea, Up: Library-specific configure options - -7.3.2 Configure options for system 'poppler' --------------------------------------------- - -Building XeTeX requires 'poppler', either from the TL tree or system -headers and library. Building pdfTeX requires either 'xpdf' from the -TeX Live tree or system 'poppler' headers and library. - -'--with-system-poppler' -Use a system version (0.18 or newer) of 'poppler' for LuaTeX (or -LuaJITTeX) and XeTeX, and use 'pkg-config' to obtain the required flags. - -'--with-system-xpdf' -Use a system version (0.12 or newer) of 'poppler' (and 'pkg-config') for -pdfTeX instead of 'xpdf' from the TL tree. *Note --disable-largefile::. -  File: tlbuild.info, Node: Variables for configure, Prev: Library-specific configure options, Up: Configure options @@ -2277,40 +2300,22 @@ by either a space or '='. 'text' - The text mode user interface (default on Unix systems). Same - as the '-no-gui' option. + The text mode user interface (default on Unix systems, + including Macs). Same as the '-no-gui' option. - 'tcl' + 'tcl' (or "perltk" or "wizard" or "expert" or nothing) - The Tcl/Tk user interface (default on Macs and Windows). It - starts with a small number of configuration options, roughly - equivalent to what the wizard option below offers, but a + The Tcl/Tk user interface (default on Windows). It starts + with a small number of configuration options, roughly + equivalent to what the former wizard option offers, but a button 'Advanced' takes you to a screen with roughly the same - options as the 'perltk' interface. - - 'wizard' - - The wizard mode user interface, asking only minimal questions - before installing all of TeX Live. - - 'expert' - - A generic name for, currently, 'perltk'; it may select a - different GUI in the future. - - 'perltk' - - The expert GUI installer, providing access to more options. + options as the former 'perltk' interface. - The 'perltk' and 'wizard' modules require the Perl/Tk module - (). if Perl/Tk is not - available, installation continues in text mode, except on Windows, - where all gui options except 'text' are diverted to the default - 'tcl' GUI. - - The 'tcl' GUI requires Tcl/Tk. This is standard on Macs and is - often already installed on GNU/Linux. For Windows, TeX Live - provides a Tcl/Tk runtime. + The default GUI requires Tcl/Tk. This is standard on Macs + (although it is considered deprecated since Catalina) and is often + already installed on GNU/Linux, or can be easily installed through + a distro package manager. For Windows, TeX Live provides a Tcl/Tk + runtime. *-no-gui* @@ -2318,10 +2323,8 @@ by either a space or '='. *-lang* _llcode_ - By default, the GUI tries to deduce your language from the - environment. The Tcl GUI uses the language detection built into - Tcl/Tk; the Perl/Tk GUIs use the 'LC_MESSAGES' environment - variable. If that fails you can select a different language by + By default, the Tcl GUI uses the language detection built into + Tcl/Tk. If that fails you can select a different language by giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), @@ -2352,11 +2355,10 @@ by either a space or '='. This option allows you to choose a particular mirror from the current list of active CTAN mirrors. This option is supported in - the 'text', 'wizard' and 'perltk' installer modes, and will also - offer to install from local media if available, or from a - repository specified on the command line. It's useful when the - (default) automatic redirection does not choose a good host for - you. + the 'text' and 'gui' installer modes, and will also offer to + install from local media if available, or from a repository + specified on the command line. It's useful when the (default) + automatic redirection does not choose a good host for you. *-all-options* @@ -2383,9 +2385,10 @@ by either a space or '='. *-debug-translation* - In the Perl/Tk GUI modes, this option reports any missing, or more - likely untranslated, messages to standard error. Helpful for - translators to see what remains to be done. + In the former Perl/Tk GUI modes, this option reported any missing, + or more likely untranslated, messages to standard error. Not yet + implemented for the Tcl interface. Helpful for translators to see + what remains to be done. *-force-platform* _platform_ @@ -2674,7 +2677,7 @@ user installations. Omit creating the ConTeXt cache. This is useful for redistributors. -'TEXLIVE_INSTALL_NO_IMPORT' +'TEXLIVE_INSTALL_NO_RESUME' Omit check for installing on top of a previous installation and then asking about importing previous settings. @@ -2684,6 +2687,11 @@ user installations. Omit printing the welcome message after successful installation, e.g., when testing. +'TEXLIVE_INSTALL_PAPER' + + Set the default paper size for all relevant programs; must be + either 'letter' or 'a4'. The default is 'a4'. + 'TEXLIVE_INSTALL_PREFIX' 'TEXLIVE_INSTALL_TEXDIR' @@ -2721,7 +2729,7 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the GNU General Public License Version 2 or later. - $Id: install-tl 54143 2020-03-06 23:51:18Z karl $ + $Id: install-tl 57970 2021-02-27 14:17:34Z siepo $  File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top @@ -2960,6 +2968,13 @@ name and its value. tlshell shares its message catalog with tlmgr. +*-command-logfile* _file_ + + 'tlmgr' logs the output of all programs invoked (mktexlr, mtxrun, + fmtutil, updmap) to a separate log file, by default + 'TEXMFSYSVAR/web2c/tlmgr-commands.log'. This option allows you to + specify a different file for the log. + *-debug-translation* In GUI mode, this switch tells 'tlmgr' to report any untranslated @@ -3506,10 +3521,26 @@ B.6.10 info separated list of field names from: 'name', 'category', 'localrev', 'remoterev', 'shortdesc', 'longdesc', 'installed', 'size', 'relocatable', 'depends', 'cat-version', 'cat-date', - or 'cat-license'. In this case the requested packages' - information is listed in CSV format one package per line, and - the column information is given by the 'itemN'. The 'depends' - column contains the name of all dependencies separated by ':'. + 'cat-license', plus various 'cat-contact-*' fields (see + below). + + The 'cat-*' fields all come from the TeX Catalogue + (). For each, there are two + more variants with prefix 'l' and 'r', e.g., 'lcat-version' + and 'rcat-version', which indicate the local and remote + information, respectively. The variants without 'l' and 'r' + show the most current one, which is normally the remote value. + + The requested packages' information is listed in CSV format, + one package per line, and the column information is given by + the 'itemN'. The 'depends' column contains the names of all + the dependencies separated by ':' characters. + + At this writing, the 'cat-contact-*' fields include: 'home', + 'repository', 'support', 'bugs', 'announce', 'development'. + Each may be empty or a url value. A brief description is on + the CTAN upload page for new packages: + . *-json* @@ -4442,12 +4473,12 @@ installed (e.g., if the selected mirror is out of date), 'tlmgr' does not downgrade. Also, packages for uninstalled platforms are not installed. - 'tlmgr' saves a copy of the 'texlive.tlpdb' file used for an update -with a suffix representing the repository url, as in -'tlpkg/texlive.tlpdb.'_long-hash-string_. These can be useful for -fallback information, but if you don't like them accumulating (e.g., -'mirror.ctan.org' resolves to many different hosts, each resulting in a -possibly different hash), it's harmless to delete them. + 'tlmgr' saves one copy of the main 'texlive.tlpdb' file used for an +update with a suffix representing the repository url, as in +'tlpkg/texlive.tlpdb.main.'_long-hash-string_. Thus, even when many +mirrors are used, only one main 'tlpdb' backup is kept. For non-main +repositories, which do not generally have (m)any mirrors, no pruning of +backups is done. This action does not automatically add or remove new symlinks in system directories; you need to run 'tlmgr' *note path: tlmgr path. @@ -4490,6 +4521,8 @@ ignored. All other lines must look like: 'require-verification', value 0 or 1 (default 0), same as command-line option. +'tkfontscale', value any float. Controls the scaling of fonts in the Tk based frontends. + 'update-exclude', value: comma-separated list of packages (no space allowed). Same as the command line option '--exclude' for the action 'update'. 'verify-downloads', value 0 or 1 (default 1), same as command-line option. @@ -5306,7 +5339,7 @@ This script and its documentation were written for the TeX Live distribution () and both are licensed under the GNU General Public License Version 2 or later. - $Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ + $Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $  File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top @@ -5318,960 +5351,988 @@ Index * Menu: * --bindir configure option: --prefix --bindir .... - (line 6) + (line 6) * --bindir configure option <1>: --enable-multiplatform. - (line 6) -* --build=HOST: Cross configuring. (line 6) -* --disable-all-packages: Build one package. (line 6) -* --disable-all-pkgs: --disable-all-pkgs. (line 6) + (line 6) +* --build=HOST: Cross configuring. (line 6) +* --disable-all-packages: Build one package. (line 6) +* --disable-all-pkgs: --disable-all-pkgs. (line 6) * --disable-bibtex8: Configure options for texk/bibtex-x. - (line 9) + (line 9) * --disable-bibtexu: Configure options for texk/bibtex-x. - (line 12) + (line 12) * --disable-dump-share: Configure options for texk/web2c. - (line 27) + (line 27) * --disable-dvipdfmx: Configure options for texk/dvipdfm-x. - (line 12) + (line 12) * --disable-etex-synctex: Configure options for texk/web2c. - (line 59) + (line 59) * --disable-ipc: Configure options for texk/web2c. - (line 31) -* --disable-largefile: --disable-largefile. (line 6) + (line 31) +* --disable-largefile: --disable-largefile. (line 6) * --disable-linked-scripts: Configure options for texk/texlive. - (line 6) + (line 6) * --disable-mf-nowin: Configure options for texk/web2c. - (line 34) -* --disable-missing: --disable-missing. (line 6) + (line 34) +* --disable-missing: --disable-missing. (line 6) * --disable-native-texlive-build: --disable-native-texlive-build. - (line 6) + (line 6) * --disable-PROG: --enable-PROG --disable-PROG. - (line 6) + (line 6) * --disable-synctex: Configure options for texk/web2c. - (line 64) + (line 64) * --disable-tex: Configure options for texk/web2c. - (line 37) + (line 37) * --disable-web-progs: Configure options for texk/web2c. - (line 41) + (line 41) * --disable-xdvipdfmx: Configure options for texk/dvipdfm-x. - (line 15) + (line 15) * --enable-*win for Metafont window support: Configure options for texk/web2c. - (line 55) + (line 55) * --enable-auto-core: Configure options for texk/web2c. - (line 45) + (line 45) * --enable-compiler-warnings=LEVEL: --enable-compiler-warnings=LEVEL. - (line 6) -* --enable-cxx-runtime-hack: Macros for compilers. (line 29) + (line 6) +* --enable-cxx-runtime-hack: Macros for compilers. + (line 29) * --enable-etex: Configure options for texk/web2c. - (line 37) + (line 37) * --enable-libtool-hack: Configure options for texk/web2c. - (line 50) -* --enable-maintainer-mode: Build system tools. (line 28) + (line 50) +* --enable-maintainer-mode: Build system tools. (line 28) * --enable-maintainer-mode <1>: --enable-maintainer-mode. - (line 6) -* --enable-missing to ignore dependencies: Build one package. (line 71) -* --enable-mktextfm-default: kpathsea library. (line 18) + (line 6) +* --enable-missing to ignore dependencies: Build one package. (line 71) +* --enable-mktextfm-default: kpathsea library. (line 18) * --enable-multiplatform: --enable-multiplatform. - (line 6) + (line 6) * --enable-PROG: --enable-PROG --disable-PROG. - (line 6) -* --enable-shared: --enable-shared. (line 6) + (line 6) +* --enable-shared: --enable-shared. (line 6) * --enable-silent-rules: --enable-silent-rules. - (line 6) + (line 6) * --enable-tex-synctex: Configure options for texk/web2c. - (line 59) + (line 59) * --enable-texlive-build: --disable-native-texlive-build. - (line 15) + (line 15) * --enable-xi2-scrolling: Configure options for texk/xdvik. - (line 13) + (line 13) * --enable-xindy-docs: Configure options for utils/xindy. - (line 10) + (line 10) * --enable-xindy-rules: Configure options for utils/xindy. - (line 6) -* --host=HOST: Cross configuring. (line 6) + (line 6) +* --host=HOST: Cross configuring. (line 6) * --libdir configure option: --enable-multiplatform. - (line 6) -* --no-clean Build option: Build problems. (line 6) + (line 6) +* --no-clean Build option: Build problems. (line 6) * --prefix configure option: --prefix --bindir .... - (line 6) + (line 6) * --with-banner-add=STR: Configure options for texk/web2c. - (line 6) + (line 6) * --with-clisp-runtime=FILENAME: Configure options for utils/xindy. - (line 14) + (line 14) * --with-editor=CMD: Configure options for texk/web2c. - (line 11) + (line 11) * --with-fontconfig-includes=DIR: Configure options for texk/web2c. - (line 16) + (line 16) * --with-fontconfig-libdir=DIR: Configure options for texk/web2c. - (line 16) + (line 16) * --with-gs=FILENAME: Configure options for texk/xdvik. - (line 6) + (line 6) * --with-LIB-includes=DIR, -libdir: Library-specific configure options. - (line 16) + (line 16) * --with-libgs-includes, -libdir: Configure options for texk/dvisvgm. - (line 17) -* --with-system-kpathsea: kpathsea library. (line 13) + (line 17) +* --with-system-kpathsea: kpathsea library. (line 13) * --with-system-LIB: Adding a new generic library module. - (line 34) + (line 34) * --with-system-LIB <1>: Library-specific configure options. - (line 9) + (line 9) * --with-system-libgs: Configure options for texk/dvisvgm. - (line 6) -* --with-system-poppler: Configure options for system poppler. - (line 11) -* --with-system-xpdf: Configure options for system poppler. - (line 15) -* --with-xdvi-x-toolkit: xdvik package. (line 21) + (line 6) +* --with-xdvi-x-toolkit: xdvik package. (line 21) * --with-xdvi-x-toolkit=KIT: Configure options for texk/xdvik. - (line 9) + (line 9) * --without-libgs: Configure options for texk/dvisvgm. - (line 12) -* --without-ln-s: --without-ln-s. (line 6) -* --without-x: --without-x. (line 6) -* -C configure option: Build in parallel. (line 11) -* -j make option: Build in parallel. (line 6) -* adapting TeX Live for distros: Distro builds. (line 54) + (line 12) +* --without-ln-s: --without-ln-s. (line 6) +* --without-x: --without-x. (line 6) +* -C configure option: Build in parallel. (line 11) +* -j make option: Build in parallel. (line 6) +* ac/withenable.ac: Adding a new program module. + (line 42) +* adapting TeX Live for distros: Distro builds. (line 54) * adding a new generic library: Adding a new generic library module. - (line 6) + (line 6) * adding a new program: Adding a new program module. - (line 6) + (line 6) * adding a new TeX-specific library: Adding a new TeX-specific library module. - (line 6) -* adding to TeX Live: Extending TeX Live. (line 6) + (line 6) +* adding to TeX Live: Extending TeX Live. (line 6) * am/ top-level directory: Top-level directories. - (line 14) + (line 14) * ANSI C: Declarations and definitions. - (line 6) + (line 6) * ApplicationServices Mac framework, required by xetex: Prerequisites. - (line 31) -* asymptote: Linked scripts. (line 23) -* asymptote <1>: asymptote. (line 6) + (line 31) +* asymptote: Linked scripts. (line 23) +* asymptote <1>: asymptote. (line 6) * Autoconf: Overview of build system. - (line 6) -* autoconf macros: Autoconf macros. (line 6) + (line 6) +* autoconf macros: Autoconf macros. (line 6) * Automake: Overview of build system. - (line 6) -* biber: Linked scripts. (line 23) + (line 6) +* autoreconf, for new program: Adding a new program module. + (line 76) +* biber: Linked scripts. (line 23) * bibtex-x: Configure options for texk/bibtex-x. - (line 6) + (line 6) * bibtex8: Configure options for texk/bibtex-x. - (line 6) + (line 6) * bibtexu: Configure options for texk/bibtex-x. - (line 6) -* BSD distro: Distro builds. (line 6) -* build directory, required: Building. (line 17) -* build iteration: Build iteration. (line 6) -* build on demand: Build one package. (line 6) -* build one engine: Build one engine. (line 6) -* build one package: Build one package. (line 6) -* build problems: Build problems. (line 6) -* Build script: Building. (line 6) + (line 6) +* BSD distro: Distro builds. (line 6) +* build directory, required: Building. (line 17) +* build iteration: Build iteration. (line 6) +* build on demand: Build one package. (line 6) +* build one engine: Build one engine. (line 6) +* build one package: Build one package. (line 6) +* build problems: Build problems. (line 6) +* Build script: Building. (line 6) * build system, design of: Overview of build system. - (line 6) + (line 6) * build-aux/ top-level directory: Top-level directories. - (line 30) -* BUILDCC, BUILDCFLAGS, ...: Cross configuring. (line 42) -* building: Building. (line 6) -* building a distribution: Build distribution. (line 6) -* building in parallel: Build in parallel. (line 6) -* C++11, removing dependent sources: Build one package. (line 64) -* C++11, required: Prerequisites. (line 15) + (line 30) +* BUILDCC, BUILDCFLAGS, ...: Cross configuring. (line 42) +* building: Building. (line 6) +* building a distribution: Build distribution. (line 6) +* building in parallel: Build in parallel. (line 6) +* C++11, removing dependent sources: Build one package. (line 64) +* C++11, required: Prerequisites. (line 15) * C, ANSI, required: Declarations and definitions. - (line 6) + (line 6) * C99, avoided: Declarations and definitions. - (line 6) -* cache file, for configure: Build in parallel. (line 11) -* cache for configure: Build in parallel. (line 6) -* callexe.c: Macros for Windows. (line 32) + (line 6) +* cache file, for configure: Build in parallel. (line 11) +* cache for configure: Build in parallel. (line 6) +* callexe.c: Macros for Windows. (line 32) * CC: Variables for configure. - (line 10) -* CC=C-COMPILER: Build one package. (line 78) -* CC_BUILD: Cross problems. (line 13) + (line 10) +* CC=C-COMPILER: Build one package. (line 78) +* CC_BUILD: Cross problems. (line 13) +* ChangeLog: Adding a new program module. + (line 73) * chktex: Declarations and definitions. - (line 18) + (line 18) * clisp: Variables for configure. - (line 18) + (line 18) * CLISP: Variables for configure. - (line 17) + (line 17) * CLISP <1>: Configure options for utils/xindy. - (line 14) -* clisp, required by xindy: Prerequisites. (line 35) -* Cocoa Mac framework, required by xetex: Prerequisites. (line 31) -* coding conventions: Coding conventions. (line 6) -* compilers, C and C++11: Prerequisites. (line 6) + (line 14) +* clisp, required by xindy: Prerequisites. (line 35) +* Cocoa Mac framework, required by xetex: Prerequisites. (line 31) +* coding conventions: Coding conventions. (line 6) +* compilers, C and C++11: Prerequisites. (line 6) * config.guess, config.sub, ...: Top-level directories. - (line 30) -* configure options: Configure options. (line 6) + (line 30) +* configure options: Configure options. (line 6) * configure options, for bibtex-x: Configure options for texk/bibtex-x. - (line 6) + (line 6) * configure options, for dvipdfm-x: Configure options for texk/dvipdfm-x. - (line 6) + (line 6) * configure options, for dvisvgm: Configure options for texk/dvisvgm. - (line 6) + (line 6) * configure options, for kpathsea: Configure options for kpathsea. - (line 6) -* configure options, for system poppler: Configure options for system poppler. - (line 6) + (line 6) * configure options, for texk/texlive: Configure options for texk/texlive. - (line 6) + (line 6) * configure options, for web2c: Configure options for texk/web2c. - (line 6) + (line 6) * configure options, for xdvik: Configure options for texk/xdvik. - (line 6) + (line 6) * configure options, for xindy: Configure options for utils/xindy. - (line 6) + (line 6) * configure options, global: Global configure options. - (line 6) + (line 6) * configure options, library-specific: Library-specific configure options. - (line 6) + (line 6) * configure options, program-specific: Program-specific configure options. - (line 6) + (line 6) * configure variables: Variables for configure. - (line 6) -* configuring, for cross compilation: Cross configuring. (line 6) -* const: Const. (line 6) + (line 6) +* configure.ac: Adding a new program module. + (line 45) +* configuring, for cross compilation: Cross configuring. (line 6) +* const: Const. (line 6) * continuous integration: Continuous integration. - (line 6) -* conventions, coding: Coding conventions. (line 6) + (line 6) +* conventions, coding: Coding conventions. (line 6) * CPPFLAGS: Variables for configure. - (line 12) -* cross compilation: Cross compilation. (line 6) -* cross compilation configuring: Cross configuring. (line 6) -* cross compilation problems: Cross problems. (line 6) -* cross compilation, with host binary: xdvik package. (line 14) -* ctangle: Cross problems. (line 26) + (line 12) +* cross compilation: Cross compilation. (line 6) +* cross compilation configuring: Cross configuring. (line 6) +* cross compilation problems: Cross problems. (line 6) +* cross compilation, with host binary: xdvik package. (line 14) +* ctangle: Cross problems. (line 26) * CXX: Variables for configure. - (line 11) -* CXX=C++-COMPILER: Build one package. (line 78) + (line 11) +* CXX=C++-COMPILER: Build one package. (line 78) * declarations and definitions, in source code: Declarations and definitions. - (line 6) + (line 6) * declarations before statements, avoiding: Declarations and definitions. - (line 6) -* dependencies, with several output files: Build in parallel. (line 6) + (line 6) +* dependencies, with several output files: Build in parallel. (line 6) * DESTDIR: --prefix --bindir .... - (line 9) + (line 9) * directories, for installation: Installation directories. - (line 6) + (line 6) * directories, top-level: Top-level directories. - (line 6) -* discards qualifiers warning: Const. (line 30) -* dist and distcheck targets for make: Build distribution. (line 6) -* distribution tarball, making: Build distribution. (line 6) -* distro, building for: Distro builds. (line 6) + (line 6) +* discards qualifiers warning: Const. (line 30) +* dist and distcheck targets for make: Build distribution. (line 6) +* distribution tarball, making: Build distribution. (line 6) +* distro, building for: Distro builds. (line 6) * dvipdfm-x: Configure options for texk/dvipdfm-x. - (line 6) + (line 6) * dvipdfmx: Configure options for texk/dvipdfm-x. - (line 6) + (line 6) * dvisvgm: Configure options for texk/dvisvgm. - (line 6) -* engine, building one: Build one engine. (line 6) -* environment variables, for configure: Configure options. (line 16) + (line 6) +* engine, adding new: Adding a new program module. + (line 104) +* engine, building one: Build one engine. (line 6) +* environment variables, for configure: Configure options. (line 16) * exec_prefix: --enable-multiplatform. - (line 6) -* extending TeX Live: Extending TeX Live. (line 6) + (line 6) +* extending TeX Live: Extending TeX Live. (line 6) * extern functions: Declarations and definitions. - (line 41) -* failure to build: Build problems. (line 6) + (line 41) +* failure to build: Build problems. (line 6) * flags, macros for library and header: Macros for library and header flags. - (line 6) -* fontconfig library, required by xetex: Prerequisites. (line 31) -* FreeType: Prerequisites. (line 11) -* freetype cross compiling: Cross problems. (line 13) -* freetype library: freetype library. (line 6) -* freetype-config: freetype library. (line 13) + (line 6) +* fontconfig library, required by xetex: Prerequisites. (line 31) +* FreeType: Prerequisites. (line 11) +* freetype cross compiling: Cross problems. (line 13) +* freetype library: freetype library. (line 6) +* freetype-config: freetype library. (line 13) * freetype-config <1>: Variables for configure. - (line 24) + (line 24) * FT2_CONFIG: Variables for configure. - (line 21) -* gcc, default compilers: Build one package. (line 78) -* general setup macros: General setup macros. (line 6) + (line 21) +* gcc, default compilers: Build one package. (line 78) +* general setup macros: General setup macros. + (line 6) * generic library module, adding: Adding a new generic library module. - (line 6) + (line 6) * Ghostscript location for Xdvik: Configure options for texk/xdvik. - (line 6) + (line 6) * git-svn: Transfer from Subversion to Github. - (line 6) + (line 6) * global configure options: Global configure options. - (line 6) -* gmake, required: Prerequisites. (line 11) -* GNU make, required: Prerequisites. (line 11) -* GNU tools, needed for building: Build system tools. (line 6) -* GNU/Linux distro: Distro builds. (line 6) + (line 6) +* gmake, required: Prerequisites. (line 11) +* GNU make, required: Prerequisites. (line 11) +* GNU tools, needed for building: Build system tools. (line 6) +* GNU/Linux distro: Distro builds. (line 6) * Gnulib, used for common files: Top-level directories. - (line 30) -* ICU cross compiling: Cross problems. (line 20) + (line 30) +* ICU cross compiling: Cross problems. (line 20) * ICU libraries: Variables for configure. - (line 24) + (line 24) * icu-config: Variables for configure. - (line 24) + (line 24) * ICU_CONFIG: Variables for configure. - (line 22) -* infrastructure, tools needed for: Build system tools. (line 6) + (line 22) +* infrastructure, tools needed for: Build system tools. (line 6) * inst/ top-level directory: Top-level directories. - (line 39) -* install-tl, TeX Live installer: Installing. (line 8) + (line 39) +* install-tl, TeX Live installer: Installing. (line 8) * installation directories: Installation directories. - (line 6) -* installing: Installing. (line 6) + (line 6) +* installing: Installing. (line 6) * interprocess communication: Configure options for texk/web2c. - (line 31) -* introduction: Introduction. (line 6) + (line 31) +* introduction: Introduction. (line 6) * iteration through sources, by configure and make: Build iteration. - (line 6) -* kpathsea library: kpathsea library. (line 6) -* kpathsea.ac: kpathsea library. (line 18) -* kpse-libpng-flags.m4: png library. (line 46) + (line 6) +* kpathsea library: kpathsea library. (line 6) +* kpathsea.ac: kpathsea library. (line 18) +* kpse-libpng-flags.m4: png library. (line 46) * kpse-pkgs.m4: Overview of build system. - (line 30) -* kpse-zlib-flags.m4: zlib library. (line 6) + (line 30) +* kpse-zlib-flags.m4: zlib library. (line 6) * kpsewhich: Variables for configure. - (line 30) + (line 30) * KPSEWHICH: Variables for configure. - (line 29) + (line 29) * KPSE_ADD_FLAGS: Macros for library and header flags. - (line 20) + (line 20) * KPSE_ALL_SYSTEM_FLAGS: Adding a new generic library module. - (line 34) -* KPSE_BASIC: General setup macros. (line 8) -* KPSE_CHECK_LATEX: Macros for programs. (line 8) -* KPSE_CHECK_PDFLATEX: Macros for programs. (line 15) -* KPSE_CHECK_PERL: Macros for programs. (line 18) -* KPSE_CHECK_WIN32: Macros for Windows. (line 9) -* KPSE_COMMON: General setup macros. (line 16) -* KPSE_COMPILER_VISIBILITY: Macros for compilers. (line 18) -* KPSE_COMPILER_WARNINGS: Macros for compilers. (line 8) -* KPSE_COND_MINGW32: Macros for Windows. (line 19) -* 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) -* kpse_cv_have_win32: Macros for Windows. (line 10) -* kpse_cv_visibility_c[xx]flags: Macros for compilers. (line 25) -* kpse_cv_warning_cflags: Macros for compilers. (line 15) -* KPSE_CXX_HACK: Macros for compilers. (line 28) + (line 34) +* KPSE_BASIC: General setup macros. + (line 8) +* KPSE_CHECK_LATEX: Macros for programs. (line 8) +* KPSE_CHECK_PDFLATEX: Macros for programs. (line 15) +* KPSE_CHECK_PERL: Macros for programs. (line 18) +* KPSE_CHECK_WIN32: Macros for Windows. (line 9) +* KPSE_COMMON: General setup macros. + (line 16) +* KPSE_COMPILER_VISIBILITY: Macros for compilers. + (line 18) +* KPSE_COMPILER_WARNINGS: Macros for compilers. + (line 8) +* KPSE_COND_MINGW32: Macros for Windows. (line 19) +* 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) +* kpse_cv_have_win32: Macros for Windows. (line 10) +* kpse_cv_visibility_c[xx]flags: Macros for compilers. + (line 25) +* kpse_cv_warning_cflags: Macros for compilers. + (line 15) +* KPSE_CXX_HACK: Macros for compilers. + (line 28) * KPSE_ENABLE_PROG: Adding a new program module. - (line 14) -* KPSE_LARGEFILE: Macros for libraries. (line 8) + (line 14) +* KPSE_LARGEFILE: Macros for libraries. + (line 8) * KPSE_LIBPNG_FLAGS: Macros for library and header flags. - (line 10) -* KPSE_LIBPNG_FLAGS <1>: png library. (line 46) + (line 10) +* KPSE_LIBPNG_FLAGS <1>: png library. (line 46) * kpse_libs_pkgs: Adding a new generic library module. - (line 6) + (line 6) * KPSE_LIB_FLAGS: Macros for library and header flags. - (line 6) + (line 6) * KPSE_LIB_FLAGS <1>: Adding a new generic library module. - (line 26) + (line 26) * KPSE_LIB_SYSTEM_FLAGS: Adding a new generic library module. - (line 34) -* KPSE_PROG_LEX: Macros for programs. (line 21) + (line 34) +* KPSE_PROG_LEX: Macros for programs. (line 21) * KPSE_RESTORE_FLAGS: Macros for library and header flags. - (line 24) + (line 24) * kpse_texk_pkgs: Adding a new program module. - (line 6) + (line 6) * kpse_texlibs_pkgs: Adding a new TeX-specific library module. - (line 11) -* KPSE_TRY_LIB: png library. (line 18) + (line 11) +* KPSE_TRY_LIB: png library. (line 18) * KPSE_TRY_LIB <1>: Adding a new generic library module. - (line 20) -* KPSE_TRY_LIBXX: png library. (line 31) + (line 20) +* KPSE_TRY_LIBXX: png library. (line 31) * KPSE_TRY_LIBXX <1>: Adding a new generic library module. - (line 20) + (line 20) * kpse_utils_pkgs: Adding a new program module. - (line 10) -* KPSE_WIN32_CALL: Macros for Windows. (line 31) + (line 10) +* KPSE_WIN32_CALL: Macros for Windows. (line 31) * KPSE_WITH_LIB: Adding a new generic library module. - (line 11) + (line 11) * KPSE_WITH_TEXLIB: Adding a new TeX-specific library module. - (line 14) -* large file support: --disable-largefile. (line 6) + (line 14) +* large file support: --disable-largefile. (line 6) * LATEX: Variables for configure. - (line 40) + (line 40) * layout of sources: Layout and infrastructure. - (line 6) -* LFS (large file support): --disable-largefile. (line 6) + (line 6) +* LFS (large file support): --disable-largefile. (line 6) * libexpat, dependency of libfontconfig: Configure options for texk/web2c. - (line 50) + (line 50) * libfontconfig, hack for avoiding linking dependencies: Configure options for texk/web2c. - (line 50) + (line 50) * libfreetype: Variables for configure. - (line 24) -* libfreetype, and const: Const. (line 21) -* libpng library: png library. (line 6) + (line 24) +* libfreetype, and const: Const. (line 21) +* libpng library: png library. (line 6) * library module, generic, adding: Adding a new generic library module. - (line 6) + (line 6) * library module, TeX-specific, adding: Adding a new TeX-specific library module. - (line 6) -* library modules: Library modules. (line 6) + (line 6) +* library modules: Library modules. (line 6) * library-specific configure options: Library-specific configure options. - (line 6) -* libsigsegv, required by xindy: Prerequisites. (line 35) -* libstc++, statically linking: Macros for compilers. (line 29) + (line 6) +* libsigsegv, required by xindy: Prerequisites. (line 35) +* libstc++, statically linking: Macros for compilers. + (line 29) * Libtool: Overview of build system. - (line 6) + (line 6) * libtool, hack for avoiding excessive linking: Configure options for texk/web2c. - (line 50) + (line 50) * libXt: Configure options for texk/web2c. - (line 22) -* linked scripts: Linked scripts. (line 6) -* linking C++ libraries statically: Macros for compilers. (line 29) + (line 22) +* linked scripts: Linked scripts. (line 6) +* linking C++ libraries statically: Macros for compilers. + (line 29) * lisp.run, lisp.exe: Configure options for utils/xindy. - (line 14) + (line 14) * LittleEndian architectures: Configure options for texk/web2c. - (line 27) + (line 27) * m4/ top-level directory: Top-level directories. - (line 14) -* macros, for compilers: Macros for compilers. (line 6) -* macros, for libraries: Macros for libraries. (line 6) + (line 14) +* macros, for compilers: Macros for compilers. + (line 6) +* macros, for libraries: Macros for libraries. + (line 6) * macros, for library and header flags: Macros for library and header flags. - (line 6) -* macros, for programs: Macros for programs. (line 6) -* macros, for Windows: Macros for Windows. (line 6) -* macros, general setup: General setup macros. (line 6) + (line 6) +* macros, for programs: Macros for programs. (line 6) +* macros, for Windows: Macros for Windows. (line 6) +* macros, general setup: General setup macros. + (line 6) * MAKE: Variables for configure. - (line 33) -* make -t: Build system tools. (line 43) + (line 33) +* make -t: Build system tools. (line 43) * make rules, verbose vs. silent: --enable-silent-rules. - (line 6) + (line 6) +* Makefile.am: Adding a new program module. + (line 46) * mf-nowin: Configure options for texk/web2c. - (line 34) -* mingw32: Cross configuring. (line 27) -* MINGW32, Automake conditional: Macros for Windows. (line 20) -* mktex.ac: kpathsea library. (line 18) -* mktextfm: kpathsea library. (line 18) -* modules, for libraries: Library modules. (line 6) -* modules, for programs: Program modules. (line 6) + (line 34) +* mingw32: Cross configuring. (line 27) +* MINGW32, Automake conditional: Macros for Windows. (line 20) +* mktex.ac: kpathsea library. (line 18) +* mktextfm: kpathsea library. (line 18) +* modules, for libraries: Library modules. (line 6) +* modules, for programs: Program modules. (line 6) * motif: Configure options for texk/xdvik. - (line 9) -* native cross compilation: Cross compilation. (line 10) -* OBJCXX=OBJC-COMPILER: Build one package. (line 78) -* one engine, building: Build one engine. (line 6) -* one package, building: Build one package. (line 6) -* OpenGL, required for Asymptote: asymptote. (line 6) -* operating system distribution, building for: Distro builds. (line 6) -* otangle: Cross problems. (line 26) -* overall build process: Building. (line 6) -* parallel build: Build in parallel. (line 6) + (line 9) +* native cross compilation: Cross compilation. (line 10) +* NEWPROG-SRC, original source subdirectory: Adding a new program module. + (line 33) +* OBJCXX=OBJC-COMPILER: Build one package. (line 78) +* one engine, building: Build one engine. (line 6) +* one package, building: Build one package. (line 6) +* OpenGL, required for Asymptote: asymptote. (line 6) +* operating system distribution, building for: Distro builds. (line 6) +* otangle: Cross problems. (line 26) +* overall build process: Building. (line 6) +* parallel build: Build in parallel. (line 6) * paths, for installation: Installation directories. - (line 6) -* PDF files, size of: --disable-largefile. (line 11) + (line 6) +* PDF files, size of: --disable-largefile. (line 11) * PDFLATEX: Variables for configure. - (line 41) + (line 41) * PERL: Variables for configure. - (line 39) -* perl, required by web2c, etc.: Prerequisites. (line 23) + (line 39) +* perl, required by web2c, etc.: Prerequisites. (line 23) * PKG_CONFIG: Variables for configure. - (line 23) -* plain.tex, not in source tree: Installing. (line 8) -* png library: png library. (line 6) -* poppler: Configure options for system poppler. - (line 6) -* PostScript files, size of: --disable-largefile. (line 11) -* Preining, Norbert: Distro builds. (line 54) + (line 23) +* plain.tex, not in source tree: Installing. (line 8) +* png library: png library. (line 6) +* PostScript files, size of: --disable-largefile. (line 11) +* Preining, Norbert: Distro builds. (line 54) * preloaded binaries: Configure options for texk/web2c. - (line 45) -* prerequisites for building: Prerequisites. (line 6) -* problems with build: Build problems. (line 6) + (line 45) +* prerequisites for building: Prerequisites. (line 6) +* problems with build: Build problems. (line 6) * program module, adding: Adding a new program module. - (line 6) -* program modules: Program modules. (line 6) + (line 6) +* program modules: Program modules. (line 6) * program-specific configure options: Program-specific configure options. - (line 6) -* proxy build system: png library. (line 36) -* reautoconf: Build system tools. (line 28) -* requirements for building: Prerequisites. (line 6) -* runscript.exe: Macros for Windows. (line 25) -* scripts, linked and not maintained: Linked scripts. (line 6) + (line 6) +* proxy build system: png library. (line 36) +* reautoconf: Build system tools. (line 28) +* reautoconf, for new program: Adding a new program module. + (line 89) +* requirements for building: Prerequisites. (line 6) +* runscript.exe: Macros for Windows. (line 25) +* scripts, linked and not maintained: Linked scripts. (line 6) * scrolling, smooth: Configure options for texk/xdvik. - (line 13) + (line 13) * SED: Variables for configure. - (line 34) -* setup macros, general: General setup macros. (line 6) -* shared libraries, using vs. avoiding: Distro builds. (line 11) -* size of PDF and PS files: --disable-largefile. (line 11) -* size of source tree: Build one package. (line 53) + (line 34) +* setup macros, general: General setup macros. + (line 6) +* shared libraries, using vs. avoiding: Distro builds. (line 11) +* size of PDF and PS files: --disable-largefile. (line 11) +* size of source tree: Build one package. (line 53) * source code declarations: Declarations and definitions. - (line 6) -* source directory building, not supported: Building. (line 17) + (line 6) +* source directory building, not supported: Building. (line 17) * source tree: Layout and infrastructure. - (line 6) -* squeeze: Cross problems. (line 13) -* squeeze/configure.ac: xdvik package. (line 14) + (line 6) +* squeeze: Cross problems. (line 13) +* squeeze/configure.ac: xdvik package. (line 14) * static functions: Declarations and definitions. - (line 35) -* static linking for C++: Macros for compilers. (line 29) + (line 35) +* static linking for C++: Macros for compilers. + (line 29) * stpcpy: Declarations and definitions. - (line 18) -* Subversion repository: Build system tools. (line 38) -* support files, separate from build: Installing. (line 8) -* symlinks, used for scripts: Linked scripts. (line 6) + (line 18) +* Subversion repository: Build system tools. (line 38) +* support files, separate from build: Installing. (line 8) +* symlinks, used for scripts: Linked scripts. (line 6) * synctex: Configure options for texk/web2c. - (line 59) + (line 59) * synctex <1>: Configure options for texk/web2c. - (line 64) -* system distribution, building for: Distro builds. (line 6) -* t1utils package: t1utils package. (line 6) -* tangle: Cross problems. (line 26) + (line 64) +* system distribution, building for: Distro builds. (line 6) +* t1utils package: t1utils package. (line 6) +* tangle: Cross problems. (line 26) * tests, running: Overview of build system. - (line 6) + (line 6) * TeX-specific library module, adding: Adding a new TeX-specific library module. - (line 6) -* texlive.tlpdb, TeX Live database: Installing. (line 8) -* tie: Cross problems. (line 26) -* timestamps, in repository: Build system tools. (line 38) -* tools, for building: Build system tools. (line 6) + (line 6) +* texlive.tlpdb, TeX Live database: Installing. (line 8) +* tie: Cross problems. (line 26) +* timestamps, in repository: Build system tools. (line 38) +* TLpatches/patch-...: Adding a new program module. + (line 68) +* TLpatches/TL-Changes: Adding a new program module. + (line 64) +* tools, for building: Build system tools. (line 6) * top-level directories: Top-level directories. - (line 6) -* touching files to avoid rerunning: Build system tools. (line 43) + (line 6) +* touching files to avoid rerunning: Build system tools. (line 43) * Travis-CI: Continuous integration. - (line 6) + (line 6) * travis.yml: CI testing on Travis-CI. - (line 6) -* type cast from const, avoiding: Const. (line 38) -* use-commit-times, Subversion: Build system tools. (line 38) + (line 6) +* type cast from const, avoiding: Const. (line 38) +* use-commit-times, Subversion: Build system tools. (line 38) * variable declarations, in source code: Declarations and definitions. - (line 52) + (line 52) * variables for configure: Variables for configure. - (line 6) -* warning, discards qualifiers: Const. (line 30) -* WARNING_C[XX]FLAGS: Macros for compilers. (line 9) -* web2c program: Cross problems. (line 13) + (line 6) +* warning, discards qualifiers: Const. (line 30) +* WARNING_C[XX]FLAGS: Macros for compilers. + (line 9) +* web2c program: Cross problems. (line 13) * web2c.ac: Configure options for texk/web2c. - (line 37) -* wget: Linked scripts. (line 23) -* WIN32, Automake conditional: Macros for Windows. (line 16) -* WIN32_WRAP, Automake conditional: Macros for Windows. (line 25) -* Windows, invoking scripts on: Linked scripts. (line 6) -* Windows, macros for: Macros for Windows. (line 6) + (line 37) +* wget: Linked scripts. (line 23) +* WIN32, Automake conditional: Macros for Windows. (line 16) +* WIN32_WRAP, Automake conditional: Macros for Windows. (line 25) +* Windows, invoking scripts on: Linked scripts. (line 6) +* Windows, macros for: Macros for Windows. (line 6) * withenable.ac, for new modules: Adding a new program module. - (line 14) + (line 14) * Work/ top-level directory: Top-level directories. - (line 39) -* wrapper binary for scripts on Windows: Linked scripts. (line 6) -* wrapper build system: freetype library. (line 6) + (line 39) +* wrapper binary for scripts on Windows: Linked scripts. (line 6) +* wrapper build system: freetype library. (line 6) * X toolkit: Configure options for texk/web2c. - (line 22) -* X11 development, required by X clients: Prerequisites. (line 27) -* X11 headers, and const: Const. (line 21) -* xasy: asymptote. (line 6) + (line 22) +* X11 development, required by X clients: Prerequisites. (line 27) +* X11 headers, and const: Const. (line 21) +* xasy: asymptote. (line 6) * xaw: Configure options for texk/xdvik. - (line 9) -* xdvik: xdvik package. (line 6) + (line 9) +* xdvik: xdvik package. (line 6) * xdvik <1>: Configure options for texk/xdvik. - (line 6) + (line 6) * xdvipdfmx: Configure options for texk/dvipdfm-x. - (line 6) -* xindy: Linked scripts. (line 23) -* xindy <1>: xindy package. (line 6) + (line 6) +* xindy: Linked scripts. (line 23) +* xindy <1>: xindy package. (line 6) * xindy <2>: Configure options for utils/xindy. - (line 6) -* xindy cross compiling requires clisp: Cross problems. (line 33) + (line 6) +* xindy cross compiling requires clisp: Cross problems. (line 33) * XInput: Configure options for texk/xdvik. - (line 13) + (line 13) * Xlib: Configure options for texk/web2c. - (line 22) -* xpdf as library: Configure options for system poppler. - (line 6) -* xz: Linked scripts. (line 23) -* zlib library: zlib library. (line 6) + (line 22) +* xz: Linked scripts. (line 23) +* zlib library: zlib library. (line 6)  Tag Table: Node: Top1208 Node: Introduction2118 -Node: Overview of build system3943 -Node: Prerequisites5994 -Node: Building8603 -Node: Build iteration9989 -Node: Build problems11030 -Node: Build in parallel11484 -Node: Build distribution12088 -Node: Build one package12736 -Node: Build one engine16415 -Node: Cross compilation17464 -Node: Cross configuring18744 -Node: Cross problems20421 -Node: Installing22083 -Node: Installation directories23103 -Node: Linked scripts24921 -Node: Distro builds26412 -Node: Layout and infrastructure28788 -Node: Build system tools29619 -Node: Top-level directories31836 -Node: Autoconf macros34072 -Node: General setup macros34834 -Node: Macros for programs35709 -Node: Macros for compilers36510 -Node: Macros for libraries37918 -Node: Macros for library and header flags38344 -Node: Macros for Windows40255 -Node: Library modules41842 -Node: png library42331 -Node: zlib library44679 -Node: freetype library45194 -Node: kpathsea library45890 -Node: Program modules47269 -Node: t1utils package47697 -Node: xindy package48242 -Node: xdvik package49356 -Node: asymptote50415 -Node: Extending TeX Live50911 -Node: Adding a new program module51694 -Node: Adding a new generic library module55033 -Node: Adding a new TeX-specific library module57262 -Node: Configure options57960 -Node: Global configure options59341 -Node: --disable-native-texlive-build59883 -Node: --prefix --bindir ...60845 -Node: --disable-largefile61385 -Node: --disable-missing62086 -Node: --enable-compiler-warnings=LEVEL62487 -Node: --enable-cxx-runtime-hack63143 -Node: --enable-maintainer-mode63563 -Node: --enable-multiplatform64092 -Node: --enable-shared64665 -Node: --enable-silent-rules65036 -Node: --without-ln-s65488 -Node: --without-x65835 -Node: Program-specific configure options66023 -Node: --enable-PROG --disable-PROG66666 -Node: --disable-all-pkgs66939 -Node: Configure options for texk/web2c67722 -Node: Configure options for texk/bibtex-x70260 -Node: Configure options for texk/dvipdfm-x70803 -Node: Configure options for texk/dvisvgm71579 -Node: Configure options for texk/texlive72460 -Node: Configure options for texk/xdvik72881 -Node: Configure options for utils/xindy73502 -Node: Library-specific configure options74392 -Node: Configure options for kpathsea75394 -Node: Configure options for system poppler76143 -Node: Variables for configure76907 -Node: Coding conventions78333 -Node: Declarations and definitions79048 -Node: Const81222 -Node: Continuous integration83086 -Node: Transfer from Subversion to Github83750 -Node: Automatic update of the Git mirror85912 -Node: CI testing on Travis-CI86494 -Node: Releases on Github87203 -Node: install-tl87643 -Node: install-tl NAME88012 -Node: install-tl SYNOPSIS88170 -Node: install-tl DESCRIPTION88428 -Node: install-tl REFERENCES89488 -Node: install-tl OPTIONS90012 -Ref: install-tl *-gui* [[=]_module_]90353 -Ref: install-tl text90561 -Ref: install-tl tcl90681 -Ref: install-tl wizard91023 -Ref: install-tl expert91156 -Ref: install-tl perltk91278 -Ref: install-tl *-no-gui*91824 -Ref: install-tl *-lang* _llcode_91914 -Ref: install-tl *-repository* _url|path_92670 -Ref: install-tl *-select-repository*93558 -Ref: install-tl *-all-options*93994 -Ref: install-tl *-custom-bin* _path_94249 -Ref: install-tl *-debug-translation*95083 -Ref: install-tl *-force-platform* _platform_95302 -Ref: install-tl *-help*, *--help*, *-?*95546 -Ref: install-tl *-in-place*95959 -Ref: install-tl *-init-from-profile* _profile_file_96504 -Ref: install-tl *-logfile* _file_96773 -Ref: install-tl *-no-cls*97124 -Ref: install-tl *-no-persistent-downloads*97272 -Ref: install-tl *-persistent-downloads*97297 -Ref: install-tl *-no-verify-downloads*97915 -Ref: install-tl *-non-admin*98278 -Ref: install-tl *-portable*98371 -Ref: install-tl *-print-platform*98510 -Ref: install-tl *-profile* _profile_file_98708 -Ref: install-tl *-q*98929 -Ref: install-tl *-scheme* _scheme_98991 -Ref: install-tl *-v*99465 -Ref: install-tl *-version*, *--version*99620 -Node: install-tl PROFILES99754 -Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102620 -Ref: install-tl instopt_adjustrepo (default 1)102696 -Ref: install-tl instopt_letter (default 0)102833 -Ref: install-tl instopt_portable (default 0)102924 -Ref: install-tl instopt_write18_restricted (default 1)103020 -Node: install-tl ENVIRONMENT VARIABLES104359 -Ref: install-tl TEXLIVE_DOWNLOADER104737 -Ref: install-tl TL_DOWNLOAD_PROGRAM104760 -Ref: install-tl TL_DOWNLOAD_ARGS104780 -Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104984 -Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE105186 -Ref: install-tl TEXLIVE_INSTALL_NO_IMPORT105295 -Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105447 -Ref: install-tl TEXLIVE_INSTALL_PREFIX105569 -Ref: install-tl TEXLIVE_INSTALL_TEXDIR105595 -Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105626 -Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105654 -Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105683 -Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105713 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105747 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105778 -Ref: install-tl NOPERLDOC106149 -Node: install-tl AUTHORS AND COPYRIGHT106213 -Node: tlmgr106626 -Node: tlmgr NAME107111 -Node: tlmgr SYNOPSIS107243 -Node: tlmgr DESCRIPTION107433 -Node: tlmgr EXAMPLES108532 -Ref: tlmgr tlmgr option repository ctan108783 -Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108855 -Ref: tlmgr tlmgr update --list109460 -Ref: tlmgr tlmgr update --all109553 -Ref: tlmgr tlmgr info _what_109710 -Node: tlmgr OPTIONS109972 -Ref: tlmgr *--repository* _url|path_110492 -Ref: tlmgr /some/local/dir111678 -Ref: tlmgr file:/some/local/dir111707 -Ref: tlmgr ctan111780 -Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet111833 -Ref: tlmgr http://server/path/to/tlnet112174 -Ref: tlmgr https://server/path/to/tlnet112555 -Ref: tlmgr ftp://server/path/to/tlnet113023 -Ref: tlmgr user@machine:/path/to/tlnet113155 -Ref: tlmgr scp://user@machine/path/to/tlnet113196 -Ref: tlmgr ssh://user@machine/path/to/tlnet113237 -Ref: tlmgr *--gui* [_action_]113630 -Ref: tlmgr *--gui-lang* _llcode_114443 -Ref: tlmgr *--debug-translation*115179 -Ref: tlmgr *--machine-readable*115382 -Ref: tlmgr *--no-execute-actions*115650 -Ref: tlmgr *--package-logfile* _file_115843 -Ref: tlmgr *--pause*116097 -Ref: tlmgr *--persistent-downloads*116252 -Ref: tlmgr *--no-persistent-downloads*116280 -Ref: tlmgr *--pin-file*116774 -Ref: tlmgr *--usermode*116992 -Ref: tlmgr *--usertree* _dir_117112 -Ref: tlmgr *--verify-repo=[none|main|all]*117238 -Node: tlmgr ACTIONS118137 -Node: tlmgr help118998 -Node: tlmgr version119475 -Node: tlmgr backup119738 -Ref: tlmgr *backup [_option_...] --all*119909 -Ref: tlmgr *backup [_option_...] _pkg_...*119942 -Ref: tlmgr *--backupdir* _directory_121008 -Ref: tlmgr *--all*121225 -Ref: tlmgr *--clean*[=_N_]121477 -Ref: tlmgr *--dry-run*121804 -Node: tlmgr candidates _pkg_121934 -Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]122289 -Ref: tlmgr *depends*122803 -Ref: tlmgr *executes*123145 -Ref: tlmgr *files*123260 -Ref: tlmgr *runfiles*123396 -Ref: tlmgr *texmfdbs*123533 -Ref: tlmgr - all items in TEXMFDBS have the !! prefix.123763 -Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).123839 -Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.123904 -Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.123979 -Ref: tlmgr *--use-svn*124004 -Node: tlmgr conf124145 -Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*124433 -Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*124497 -Node: tlmgr dump-tlpdb [_option_...] [--json]126912 -Ref: tlmgr *--local*127345 -Ref: tlmgr *--remote*127384 -Ref: tlmgr *--json*127422 -Node: tlmgr generate127993 -Ref: tlmgr *generate [_option_...] language*128189 -Ref: tlmgr *generate [_option_...] language.dat*128228 -Ref: tlmgr *generate [_option_...] language.def*128267 -Ref: tlmgr *generate [_option_...] language.dat.lua*128310 -Ref: tlmgr *--dest* _output_file_130637 -Ref: tlmgr *--localcfg* _local_conf_file_131213 -Ref: tlmgr *--rebuild-sys*131336 -Node: tlmgr gui132151 -Node: tlmgr info132329 -Ref: tlmgr *info [_option_...] _pkg_...*132491 -Ref: tlmgr *info [_option_...] collections*132525 -Ref: tlmgr *info [_option_...] schemes*132555 -Ref: tlmgr *--list*134085 -Ref: tlmgr *--only-installed*134399 -Ref: tlmgr *--only-remote*134587 -Ref: tlmgr *--data item1,item2,...*134891 -Ref: tlmgr *--json* 1135472 -Node: tlmgr init-usertree135855 -Node: tlmgr install [_option_...] _pkg_...136236 -Ref: tlmgr *--dry-run* 1136744 -Ref: tlmgr *--file*136861 -Ref: tlmgr *--force*137083 -Ref: tlmgr *--no-depends*137303 -Ref: tlmgr *--no-depends-at-all*137462 -Ref: tlmgr *--reinstall*137862 -Ref: tlmgr *--with-doc*138240 -Ref: tlmgr *--with-src*138253 -Node: tlmgr key138981 -Ref: tlmgr *key list*139139 -Ref: tlmgr *key add _file_*139157 -Ref: tlmgr *key remove _keyid_*139179 -Node: tlmgr list139773 -Node: tlmgr option139935 -Ref: tlmgr *option [--json] [show]*140090 -Ref: tlmgr *option [--json] showall|help*140121 -Ref: tlmgr *option _key_ [_value_]*140147 -Node: tlmgr paper144725 -Ref: tlmgr *paper [a4|letter]*144874 -Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>144950 -Ref: tlmgr *paper --json*144965 -Node: tlmgr path146180 -Ref: tlmgr *path [--w32mode=user|admin] add*146341 -Ref: tlmgr *path [--w32mode=user|admin] remove*146378 -Node: tlmgr pinning147863 -Ref: tlmgr pinning show148104 -Ref: tlmgr pinning add _repo_ _pkgglob_...148177 -Ref: tlmgr pinning remove _repo_ _pkgglob_...148296 -Ref: tlmgr pinning remove _repo_ --all148449 -Node: tlmgr platform148503 -Ref: tlmgr *platform list|add|remove _platform_...*148689 -Ref: tlmgr *platform set _platform_*148716 -Ref: tlmgr *platform set auto*148737 -Ref: tlmgr *--dry-run* 2149614 -Node: tlmgr postaction149733 -Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*149963 -Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*150037 -Ref: tlmgr *--w32mode=[user|admin]*150352 -Ref: tlmgr *--fileassocmode=[1|2]*150768 -Ref: tlmgr *--all* 1151053 -Node: tlmgr print-platform151108 -Node: tlmgr print-platform-info151439 -Node: tlmgr remove [_option_...] _pkg_...151739 -Ref: tlmgr *--all* 2152223 -Ref: tlmgr *--backup*152333 -Ref: tlmgr *--backupdir* _directory_ 1152359 -Ref: tlmgr *--no-depends* 1152764 -Ref: tlmgr *--no-depends-at-all* 1152826 -Ref: tlmgr *--force* 1152929 -Ref: tlmgr *--dry-run* 3153402 -Node: tlmgr repository153738 -Ref: tlmgr *repository list*153926 -Ref: tlmgr *repository list _path|url|tag_*153960 -Ref: tlmgr *repository add _path_ [_tag_]*153993 -Ref: tlmgr *repository remove _path|tag_*154025 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*154079 -Ref: tlmgr *repository status*154100 -Ref: tlmgr The tag (which can be the same as the url);155327 -Node: tlmgr restore155805 -Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*155984 -Ref: tlmgr *restore [_option_...] --all*156014 -Ref: tlmgr *--all* 3156714 -Ref: tlmgr *--backupdir* _directory_ 2156928 -Ref: tlmgr *--dry-run* 4157109 -Ref: tlmgr *--force* 2157241 -Ref: tlmgr *--json* 2157287 -Node: tlmgr search157614 -Ref: tlmgr *search [_option_...] _what_*157778 -Ref: tlmgr *search [_option_...] --file _what_*157815 -Ref: tlmgr *search [_option_...] --all _what_*157851 -Ref: tlmgr *--file* 1158071 -Ref: tlmgr *--all* 4158133 -Ref: tlmgr *--global*158222 -Ref: tlmgr *--word*158349 -Node: tlmgr shell158664 -Ref: tlmgr protocol159399 -Ref: tlmgr help 1159463 -Ref: tlmgr version 1159516 -Ref: tlmgr quit, end, bye, byebye, EOF159584 -Ref: tlmgr restart159605 -Ref: tlmgr load [local|remote]159728 -Ref: tlmgr save159798 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]159921 -Node: tlmgr show160522 -Node: tlmgr uninstall160689 -Node: tlmgr update [_option_...] [_pkg_...]160919 -Ref: tlmgr *--all* 5161290 -Ref: tlmgr *--self*163469 -Ref: tlmgr *--dry-run* 5164233 -Ref: tlmgr *--list* [_pkg_]164410 -Ref: tlmgr *--exclude* _pkg_165099 -Ref: tlmgr *--no-auto-remove* [_pkg_...]165899 -Ref: tlmgr *--no-auto-install* [_pkg_...]166383 -Ref: tlmgr *--reinstall-forcibly-removed*167145 -Ref: tlmgr *--backup* 1167680 -Ref: tlmgr *--backupdir* _directory_ 3167706 -Ref: tlmgr *--no-depends* 2168872 -Ref: tlmgr *--no-depends-at-all* 2169075 -Ref: tlmgr *--force* 3169178 -Node: tlmgr CONFIGURATION FILE FOR TLMGR170198 -Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.171205 -Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.171342 -Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.171424 -Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).171478 -Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.171558 -Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.171638 -Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.171786 -Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.171862 -Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).172131 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION173219 -Node: tlmgr Configuration of GnuPG invocation175392 -Node: tlmgr USER MODE176030 -Node: tlmgr User mode install178876 -Node: tlmgr User mode backup, restore, remove, update180020 -Node: tlmgr User mode generate, option, paper180462 -Node: tlmgr MULTIPLE REPOSITORIES180838 -Node: tlmgr Pinning182567 -Node: tlmgr GUI FOR TLMGR184490 -Node: tlmgr Main display186139 -Node: tlmgr Display configuration area186391 -Ref: tlmgr Status186752 -Ref: tlmgr Category186916 -Ref: tlmgr Match187102 -Ref: tlmgr Selection187283 -Ref: tlmgr Display configuration buttons187487 -Node: tlmgr Package list area187670 -Ref: tlmgr a checkbox188254 -Ref: tlmgr package name188390 -Ref: tlmgr local revision (and version)188489 -Ref: tlmgr remote revision (and version)188864 -Ref: tlmgr short description189161 -Node: tlmgr Main display action buttons189206 -Ref: tlmgr Update all installed189472 -Ref: tlmgr Update189844 -Ref: tlmgr Install189894 -Ref: tlmgr Remove190080 -Ref: tlmgr Backup190258 -Node: tlmgr Menu bar190415 -Ref: tlmgr tlmgr menu190638 -Ref: tlmgr Options menu190946 -Ref: tlmgr Actions menu192029 -Ref: tlmgr Help menu192457 -Node: tlmgr GUI options192591 -Ref: tlmgr -background _color_192837 -Ref: tlmgr -font " _fontname_ _fontsize_ "192902 -Ref: tlmgr -foreground _color_193060 -Ref: tlmgr -geometry _geomspec_193112 -Ref: tlmgr -xrm _xresource_193304 -Node: tlmgr MACHINE-READABLE OUTPUT193573 -Node: tlmgr Machine-readable update and install output194383 -Ref: tlmgr location-url _location_195659 -Ref: tlmgr total-bytes _count_195875 -Ref: tlmgr _pkgname_196285 -Ref: tlmgr _status_196495 -Ref: tlmgr d196573 -Ref: tlmgr f196633 -Ref: tlmgr u196812 -Ref: tlmgr r196858 -Ref: tlmgr a196981 -Ref: tlmgr i197159 -Ref: tlmgr I197278 -Ref: tlmgr _localrev_197380 -Ref: tlmgr _serverrev_197487 -Ref: tlmgr _size_197599 -Ref: tlmgr _runtime_197768 -Ref: tlmgr _esttot_197838 -Node: tlmgr Machine-readable option output197871 -Node: tlmgr ENVIRONMENT VARIABLES198383 -Ref: tlmgr TEXLIVE_COMPRESSOR198894 -Ref: tlmgr TEXLIVE_DOWNLOADER199742 -Ref: tlmgr TL_DOWNLOAD_PROGRAM199765 -Ref: tlmgr TL_DOWNLOAD_ARGS199785 -Ref: tlmgr TEXLIVE_PREFER_OWN200811 -Node: tlmgr AUTHORS AND COPYRIGHT201635 -Node: Index202033 +Node: Overview of build system3946 +Node: Prerequisites5997 +Node: Building8593 +Node: Build iteration9979 +Node: Build problems11020 +Node: Build in parallel11474 +Node: Build distribution12078 +Node: Build one package12726 +Node: Build one engine16371 +Node: Cross compilation17885 +Node: Cross configuring19165 +Node: Cross problems20842 +Node: Installing22504 +Node: Installation directories23524 +Node: Linked scripts25342 +Node: Distro builds26833 +Node: Layout and infrastructure29209 +Node: Build system tools30040 +Node: Top-level directories32257 +Node: Autoconf macros34493 +Node: General setup macros35255 +Node: Macros for programs36130 +Node: Macros for compilers36931 +Node: Macros for libraries38339 +Node: Macros for library and header flags38765 +Node: Macros for Windows40676 +Node: Library modules42263 +Node: png library42752 +Node: zlib library45100 +Node: freetype library45615 +Node: kpathsea library46311 +Node: Program modules47690 +Node: t1utils package48118 +Node: xindy package48663 +Node: xdvik package49777 +Node: asymptote50836 +Node: Extending TeX Live51332 +Node: Adding a new program module52115 +Node: Adding a new generic library module57248 +Node: Adding a new TeX-specific library module59477 +Node: Configure options60175 +Node: Global configure options61556 +Node: --disable-native-texlive-build62098 +Node: --prefix --bindir ...63060 +Node: --disable-largefile63600 +Node: --disable-missing64142 +Node: --enable-compiler-warnings=LEVEL64543 +Node: --enable-cxx-runtime-hack65199 +Node: --enable-maintainer-mode65619 +Node: --enable-multiplatform66148 +Node: --enable-shared66721 +Node: --enable-silent-rules67092 +Node: --without-ln-s67544 +Node: --without-x67891 +Node: Program-specific configure options68079 +Node: --enable-PROG --disable-PROG68722 +Node: --disable-all-pkgs68995 +Node: Configure options for texk/web2c69778 +Node: Configure options for texk/bibtex-x72316 +Node: Configure options for texk/dvipdfm-x72859 +Node: Configure options for texk/dvisvgm73635 +Node: Configure options for texk/texlive74516 +Node: Configure options for texk/xdvik74937 +Node: Configure options for utils/xindy75558 +Node: Library-specific configure options76448 +Node: Configure options for kpathsea77409 +Node: Variables for configure78113 +Node: Coding conventions79539 +Node: Declarations and definitions80254 +Node: Const82428 +Node: Continuous integration84292 +Node: Transfer from Subversion to Github84956 +Node: Automatic update of the Git mirror87118 +Node: CI testing on Travis-CI87700 +Node: Releases on Github88409 +Node: install-tl88849 +Node: install-tl NAME89218 +Node: install-tl SYNOPSIS89376 +Node: install-tl DESCRIPTION89634 +Node: install-tl REFERENCES90694 +Node: install-tl OPTIONS91218 +Ref: install-tl *-gui* [[=]_module_]91559 +Ref: install-tl text91767 +Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)91952 +Ref: install-tl *-no-gui*92584 +Ref: install-tl *-lang* _llcode_92674 +Ref: install-tl *-repository* _url|path_93298 +Ref: install-tl *-select-repository*94186 +Ref: install-tl *-all-options*94604 +Ref: install-tl *-custom-bin* _path_94859 +Ref: install-tl *-debug-translation*95693 +Ref: install-tl *-force-platform* _platform_95969 +Ref: install-tl *-help*, *--help*, *-?*96213 +Ref: install-tl *-in-place*96626 +Ref: install-tl *-init-from-profile* _profile_file_97171 +Ref: install-tl *-logfile* _file_97440 +Ref: install-tl *-no-cls*97791 +Ref: install-tl *-no-persistent-downloads*97939 +Ref: install-tl *-persistent-downloads*97964 +Ref: install-tl *-no-verify-downloads*98582 +Ref: install-tl *-non-admin*98945 +Ref: install-tl *-portable*99038 +Ref: install-tl *-print-platform*99177 +Ref: install-tl *-profile* _profile_file_99375 +Ref: install-tl *-q*99596 +Ref: install-tl *-scheme* _scheme_99658 +Ref: install-tl *-v*100132 +Ref: install-tl *-version*, *--version*100287 +Node: install-tl PROFILES100421 +Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)103287 +Ref: install-tl instopt_adjustrepo (default 1)103363 +Ref: install-tl instopt_letter (default 0)103500 +Ref: install-tl instopt_portable (default 0)103591 +Ref: install-tl instopt_write18_restricted (default 1)103687 +Node: install-tl ENVIRONMENT VARIABLES105026 +Ref: install-tl TEXLIVE_DOWNLOADER105404 +Ref: install-tl TL_DOWNLOAD_PROGRAM105427 +Ref: install-tl TL_DOWNLOAD_ARGS105447 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK105651 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE105853 +Ref: install-tl TEXLIVE_INSTALL_NO_RESUME105962 +Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME106114 +Ref: install-tl TEXLIVE_INSTALL_PAPER106235 +Ref: install-tl TEXLIVE_INSTALL_PREFIX106381 +Ref: install-tl TEXLIVE_INSTALL_TEXDIR106407 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG106438 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR106466 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME106495 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL106525 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG106559 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR106590 +Ref: install-tl NOPERLDOC106961 +Node: install-tl AUTHORS AND COPYRIGHT107025 +Node: tlmgr107439 +Node: tlmgr NAME107924 +Node: tlmgr SYNOPSIS108056 +Node: tlmgr DESCRIPTION108246 +Node: tlmgr EXAMPLES109345 +Ref: tlmgr tlmgr option repository ctan109596 +Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet109668 +Ref: tlmgr tlmgr update --list110273 +Ref: tlmgr tlmgr update --all110366 +Ref: tlmgr tlmgr info _what_110523 +Node: tlmgr OPTIONS110785 +Ref: tlmgr *--repository* _url|path_111305 +Ref: tlmgr /some/local/dir112491 +Ref: tlmgr file:/some/local/dir112520 +Ref: tlmgr ctan112593 +Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet112646 +Ref: tlmgr http://server/path/to/tlnet112987 +Ref: tlmgr https://server/path/to/tlnet113368 +Ref: tlmgr ftp://server/path/to/tlnet113836 +Ref: tlmgr user@machine:/path/to/tlnet113968 +Ref: tlmgr scp://user@machine/path/to/tlnet114009 +Ref: tlmgr ssh://user@machine/path/to/tlnet114050 +Ref: tlmgr *--gui* [_action_]114443 +Ref: tlmgr *--gui-lang* _llcode_115256 +Ref: tlmgr *--command-logfile* _file_115997 +Ref: tlmgr *--debug-translation*116263 +Ref: tlmgr *--machine-readable*116466 +Ref: tlmgr *--no-execute-actions*116734 +Ref: tlmgr *--package-logfile* _file_116927 +Ref: tlmgr *--pause*117181 +Ref: tlmgr *--persistent-downloads*117336 +Ref: tlmgr *--no-persistent-downloads*117364 +Ref: tlmgr *--pin-file*117858 +Ref: tlmgr *--usermode*118076 +Ref: tlmgr *--usertree* _dir_118196 +Ref: tlmgr *--verify-repo=[none|main|all]*118322 +Node: tlmgr ACTIONS119221 +Node: tlmgr help120082 +Node: tlmgr version120559 +Node: tlmgr backup120822 +Ref: tlmgr *backup [_option_...] --all*120993 +Ref: tlmgr *backup [_option_...] _pkg_...*121026 +Ref: tlmgr *--backupdir* _directory_122092 +Ref: tlmgr *--all*122309 +Ref: tlmgr *--clean*[=_N_]122561 +Ref: tlmgr *--dry-run*122888 +Node: tlmgr candidates _pkg_123018 +Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]123373 +Ref: tlmgr *depends*123887 +Ref: tlmgr *executes*124229 +Ref: tlmgr *files*124344 +Ref: tlmgr *runfiles*124480 +Ref: tlmgr *texmfdbs*124617 +Ref: tlmgr - all items in TEXMFDBS have the !! prefix.124847 +Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).124923 +Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.124988 +Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.125063 +Ref: tlmgr *--use-svn*125088 +Node: tlmgr conf125229 +Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*125517 +Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*125581 +Node: tlmgr dump-tlpdb [_option_...] [--json]127996 +Ref: tlmgr *--local*128429 +Ref: tlmgr *--remote*128468 +Ref: tlmgr *--json*128506 +Node: tlmgr generate129077 +Ref: tlmgr *generate [_option_...] language*129273 +Ref: tlmgr *generate [_option_...] language.dat*129312 +Ref: tlmgr *generate [_option_...] language.def*129351 +Ref: tlmgr *generate [_option_...] language.dat.lua*129394 +Ref: tlmgr *--dest* _output_file_131721 +Ref: tlmgr *--localcfg* _local_conf_file_132297 +Ref: tlmgr *--rebuild-sys*132420 +Node: tlmgr gui133235 +Node: tlmgr info133413 +Ref: tlmgr *info [_option_...] _pkg_...*133575 +Ref: tlmgr *info [_option_...] collections*133609 +Ref: tlmgr *info [_option_...] schemes*133639 +Ref: tlmgr *--list*135169 +Ref: tlmgr *--only-installed*135483 +Ref: tlmgr *--only-remote*135671 +Ref: tlmgr *--data item1,item2,...*135975 +Ref: tlmgr *--json* 1137338 +Node: tlmgr init-usertree137721 +Node: tlmgr install [_option_...] _pkg_...138102 +Ref: tlmgr *--dry-run* 1138610 +Ref: tlmgr *--file*138727 +Ref: tlmgr *--force*138949 +Ref: tlmgr *--no-depends*139169 +Ref: tlmgr *--no-depends-at-all*139328 +Ref: tlmgr *--reinstall*139728 +Ref: tlmgr *--with-doc*140106 +Ref: tlmgr *--with-src*140119 +Node: tlmgr key140847 +Ref: tlmgr *key list*141005 +Ref: tlmgr *key add _file_*141023 +Ref: tlmgr *key remove _keyid_*141045 +Node: tlmgr list141639 +Node: tlmgr option141801 +Ref: tlmgr *option [--json] [show]*141956 +Ref: tlmgr *option [--json] showall|help*141987 +Ref: tlmgr *option _key_ [_value_]*142013 +Node: tlmgr paper146591 +Ref: tlmgr *paper [a4|letter]*146740 +Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>146816 +Ref: tlmgr *paper --json*146831 +Node: tlmgr path148046 +Ref: tlmgr *path [--w32mode=user|admin] add*148207 +Ref: tlmgr *path [--w32mode=user|admin] remove*148244 +Node: tlmgr pinning149729 +Ref: tlmgr pinning show149970 +Ref: tlmgr pinning add _repo_ _pkgglob_...150043 +Ref: tlmgr pinning remove _repo_ _pkgglob_...150162 +Ref: tlmgr pinning remove _repo_ --all150315 +Node: tlmgr platform150369 +Ref: tlmgr *platform list|add|remove _platform_...*150555 +Ref: tlmgr *platform set _platform_*150582 +Ref: tlmgr *platform set auto*150603 +Ref: tlmgr *--dry-run* 2151480 +Node: tlmgr postaction151599 +Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*151829 +Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*151903 +Ref: tlmgr *--w32mode=[user|admin]*152218 +Ref: tlmgr *--fileassocmode=[1|2]*152634 +Ref: tlmgr *--all* 1152919 +Node: tlmgr print-platform152974 +Node: tlmgr print-platform-info153305 +Node: tlmgr remove [_option_...] _pkg_...153605 +Ref: tlmgr *--all* 2154089 +Ref: tlmgr *--backup*154199 +Ref: tlmgr *--backupdir* _directory_ 1154225 +Ref: tlmgr *--no-depends* 1154630 +Ref: tlmgr *--no-depends-at-all* 1154692 +Ref: tlmgr *--force* 1154795 +Ref: tlmgr *--dry-run* 3155268 +Node: tlmgr repository155604 +Ref: tlmgr *repository list*155792 +Ref: tlmgr *repository list _path|url|tag_*155826 +Ref: tlmgr *repository add _path_ [_tag_]*155859 +Ref: tlmgr *repository remove _path|tag_*155891 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*155945 +Ref: tlmgr *repository status*155966 +Ref: tlmgr The tag (which can be the same as the url);157193 +Node: tlmgr restore157671 +Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*157850 +Ref: tlmgr *restore [_option_...] --all*157880 +Ref: tlmgr *--all* 3158580 +Ref: tlmgr *--backupdir* _directory_ 2158794 +Ref: tlmgr *--dry-run* 4158975 +Ref: tlmgr *--force* 2159107 +Ref: tlmgr *--json* 2159153 +Node: tlmgr search159480 +Ref: tlmgr *search [_option_...] _what_*159644 +Ref: tlmgr *search [_option_...] --file _what_*159681 +Ref: tlmgr *search [_option_...] --all _what_*159717 +Ref: tlmgr *--file* 1159937 +Ref: tlmgr *--all* 4159999 +Ref: tlmgr *--global*160088 +Ref: tlmgr *--word*160215 +Node: tlmgr shell160530 +Ref: tlmgr protocol161265 +Ref: tlmgr help 1161329 +Ref: tlmgr version 1161382 +Ref: tlmgr quit, end, bye, byebye, EOF161450 +Ref: tlmgr restart161471 +Ref: tlmgr load [local|remote]161594 +Ref: tlmgr save161664 +Ref: tlmgr get [_var_] =item set [_var_ [_val_]]161787 +Node: tlmgr show162388 +Node: tlmgr uninstall162555 +Node: tlmgr update [_option_...] [_pkg_...]162785 +Ref: tlmgr *--all* 5163156 +Ref: tlmgr *--self*165335 +Ref: tlmgr *--dry-run* 5166099 +Ref: tlmgr *--list* [_pkg_]166276 +Ref: tlmgr *--exclude* _pkg_166965 +Ref: tlmgr *--no-auto-remove* [_pkg_...]167765 +Ref: tlmgr *--no-auto-install* [_pkg_...]168249 +Ref: tlmgr *--reinstall-forcibly-removed*169011 +Ref: tlmgr *--backup* 1169546 +Ref: tlmgr *--backupdir* _directory_ 3169572 +Ref: tlmgr *--no-depends* 2170738 +Ref: tlmgr *--no-depends-at-all* 2170941 +Ref: tlmgr *--force* 3171044 +Node: tlmgr CONFIGURATION FILE FOR TLMGR172035 +Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.173042 +Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.173179 +Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.173261 +Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).173315 +Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.173395 +Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.173475 +Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.173565 +Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.173713 +Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.173789 +Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).174058 +Node: tlmgr CRYPTOGRAPHIC VERIFICATION175146 +Node: tlmgr Configuration of GnuPG invocation177319 +Node: tlmgr USER MODE177957 +Node: tlmgr User mode install180803 +Node: tlmgr User mode backup, restore, remove, update181947 +Node: tlmgr User mode generate, option, paper182389 +Node: tlmgr MULTIPLE REPOSITORIES182765 +Node: tlmgr Pinning184494 +Node: tlmgr GUI FOR TLMGR186417 +Node: tlmgr Main display188066 +Node: tlmgr Display configuration area188318 +Ref: tlmgr Status188679 +Ref: tlmgr Category188843 +Ref: tlmgr Match189029 +Ref: tlmgr Selection189210 +Ref: tlmgr Display configuration buttons189414 +Node: tlmgr Package list area189597 +Ref: tlmgr a checkbox190181 +Ref: tlmgr package name190317 +Ref: tlmgr local revision (and version)190416 +Ref: tlmgr remote revision (and version)190791 +Ref: tlmgr short description191088 +Node: tlmgr Main display action buttons191133 +Ref: tlmgr Update all installed191399 +Ref: tlmgr Update191771 +Ref: tlmgr Install191821 +Ref: tlmgr Remove192007 +Ref: tlmgr Backup192185 +Node: tlmgr Menu bar192342 +Ref: tlmgr tlmgr menu192565 +Ref: tlmgr Options menu192873 +Ref: tlmgr Actions menu193956 +Ref: tlmgr Help menu194384 +Node: tlmgr GUI options194518 +Ref: tlmgr -background _color_194764 +Ref: tlmgr -font " _fontname_ _fontsize_ "194829 +Ref: tlmgr -foreground _color_194987 +Ref: tlmgr -geometry _geomspec_195039 +Ref: tlmgr -xrm _xresource_195231 +Node: tlmgr MACHINE-READABLE OUTPUT195500 +Node: tlmgr Machine-readable update and install output196310 +Ref: tlmgr location-url _location_197586 +Ref: tlmgr total-bytes _count_197802 +Ref: tlmgr _pkgname_198212 +Ref: tlmgr _status_198422 +Ref: tlmgr d198500 +Ref: tlmgr f198560 +Ref: tlmgr u198739 +Ref: tlmgr r198785 +Ref: tlmgr a198908 +Ref: tlmgr i199086 +Ref: tlmgr I199205 +Ref: tlmgr _localrev_199307 +Ref: tlmgr _serverrev_199414 +Ref: tlmgr _size_199526 +Ref: tlmgr _runtime_199695 +Ref: tlmgr _esttot_199765 +Node: tlmgr Machine-readable option output199798 +Node: tlmgr ENVIRONMENT VARIABLES200310 +Ref: tlmgr TEXLIVE_COMPRESSOR200821 +Ref: tlmgr TEXLIVE_DOWNLOADER201669 +Ref: tlmgr TL_DOWNLOAD_PROGRAM201692 +Ref: tlmgr TL_DOWNLOAD_ARGS201712 +Ref: tlmgr TEXLIVE_PREFER_OWN202738 +Node: tlmgr AUTHORS AND COPYRIGHT203562 +Node: Index203961  End Tag Table diff --git a/Master/texmf-dist/doc/info/web2c.info b/Master/texmf-dist/doc/info/web2c.info index 19bf29f3409..f287a96a42c 100644 --- a/Master/texmf-dist/doc/info/web2c.info +++ b/Master/texmf-dist/doc/info/web2c.info @@ -4,7 +4,7 @@ This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, -2005, 2007, 2008, 2009, 2010-2020 Karl Berry & Olaf Weber. +2005, 2007, 2008, 2009, 2010-2021 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 @@ -36,7 +36,7 @@ START-INFO-DIR-ENTRY * mf: (web2c)mf invocation. Creating typeface families. * mft: (web2c)mft invocation. Prettyprinting Metafont source. * mltex: (web2c)MLTeX. Multi-lingual TeX. -* mpost: (web2c)mpost invocation. Creating technical diagrams. +* mpost: (web2c)mpost invocation. Generating PostScript. * patgen: (web2c)patgen invocation. Creating hyphenation patterns. * pktogf: (web2c)pktogf invocation. Packed to generic fonts. * pktype: (web2c)pktype invocation. PK to human-readable text. @@ -58,13 +58,14 @@ Web2c 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 2020, released in March 2020. +corresponds to Web2c version 2021, released in February 2021. * Menu: * Introduction:: A brief introduction. * Installation:: How to compile and install Web2c. * Commonalities:: Option syntax, standard options, memory dumps. +* Three programs:: TeX, Metafont, MetaPost have much in common. * TeX:: Typesetting. * Metafont:: Typeface design. * MetaPost:: Technical illustrations. @@ -82,11 +83,11 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 2020 of Web2c, released in March -2020. +This manual corresponds to version 2021 of Web2c, released in February +2021. "Web2c" is the name of a TeX implementation, originally for Unix, but -now also running under DOS, Amiga, and other operating systems. By "TeX +now also running under various operating systems. By "TeX implementation", we mean all of the standard programs developed by the Stanford TeX project directed by Donald E. Knuth: Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX itself. Other programs @@ -108,15 +109,16 @@ Web2c. Different parts of the Web2c distribution have different licensing terms, however, reflecting the different circumstances of their creation; consult each source file for exact details. The main -practical implication for redistributors of Web2c is that the -executables are covered by the GNU General Public License, and therefore -anyone who gets a binary distribution must also get the sources, as -explained by the terms of the GPL (*note (kpathsea)Copying::). The GPL -covers the Web2c executables, including 'tex', because the Free Software -Foundation sponsored the initial development of the Kpathsea library -that Web2c uses. The basic source files from Stanford, however, have -their own copyright terms or are in the public domain, and are not -covered by the GPL. +practical implication for redistributors of Web2c is that most of the +executables are covered by the GNU General Public License or GNU Lesser +General Public License, and therefore anyone who gets a binary +distribution must also be able to get the sources, as explained by the +terms of the GPL (. The GPL covers the Web2c +executables, including 'tex', because the Free Software Foundation +sponsored the initial development of the Kpathsea library that Web2c +uses. The basic source files from Stanford, however, have their own +copyright terms or are in the public domain, and are not covered by the +GPL. History: Tomas Rokicki originated the TeX-to-C system in 1987, working from the first change files for TeX under Unix, which were done @@ -124,13 +126,14 @@ primarily by Howard Trickey and Pavel Curtis. Tim Morgan then took over development and maintenance for a number of years; the name changed to Web-to-C somewhere in there. In 1990, Karl Berry became the maintainer. He made many changes to the original sources, and started using the -shorter name Web2c. In 1997, Olaf Weber took over. Dozens of other -people have contributed; their names are listed in the 'ChangeLog' -files. - - Other acknowledgements: The University of Massachusetts at Boston -(particularly Rick Martin and Bob Morris) provided computers and ftp -access to me for many years. Richard Stallman at the Free Software +shorter name Web2c. In 1997, Olaf Weber took over, and then in 2006, +Karl started taking care of it again. No significant development or +changes have been needed for many years. Dozens of other people have +contributed; their names are listed in the 'ChangeLog' files. + + Other acknowledgements by Karl: The University of Massachusetts at +Boston (particularly Rick Martin and Bob Morris) provided computers and +ftp access to me for many years. Richard Stallman at the Free Software Foundation employed me while I wrote the original path searching library (for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC, without which I cannot imagine developing Web2c.) And, of course, TeX @@ -187,7 +190,6 @@ See also the Web2c home page, . * Compile-time options:: Unusual -D's. * Additional targets:: Breaking down the task. * Triptrap:: Running the torture tests. -* Runtime options:: Array sizes and the like.  File: web2c.info, Node: configure options, Next: Compile-time options, Up: Installation @@ -325,7 +327,7 @@ distribution (the one containing 'kpathsea/' and 'web2c/'), or in the (respectively). See the next section.  -File: web2c.info, Node: Triptrap, Next: Runtime options, Prev: Additional targets, Up: Installation +File: web2c.info, Node: Triptrap, Prev: Additional targets, Up: Installation 2.4 Trip, trap, and mptrap: Torture tests ========================================= @@ -364,57 +366,13 @@ tests, run 'make check'. You can compare the output to the distributed file 'tests/check.log' if you like.  -File: web2c.info, Node: Runtime options, Prev: Triptrap, Up: Installation - -2.5 Runtime options -=================== - -Besides the configure- and compile-time options described in the -previous sections, you can control a number of parameters (in -particular, array sizes) in the 'texmf.cnf' runtime file read by -Kpathsea (*note (kpathsea)Config files::). - - Rather than exhaustively listing them here, please see the last -section of the distributed 'kpathsea/texmf.cnf'. Some of the more -interesting values: - -'main_memory' - Total words of memory available, for TeX, Metafont, and MetaPost. - Must remake the format file after changing. - -'extra_mem_bot' - Extra space for "large" TeX data structures: boxes, glue, - breakpoints, et al. If you use PiCTeX, you may well want to set - this. - -'font_mem_size' - Words of font info available for TeX; this is approximately the - total size of all TFM files read. - -'hash_extra' - Additional space for the hash table of control sequence names. - Approximately 10,000 control sequences can be stored in the main - hash table; if you have a large book with numerous - cross-references, this might not be enough, and thus you will want - to set 'hash_extra'. - - Of course, ideally all arrays would be dynamically expanded as -necessary, so the only limiting factor would be the amount of swap space -available. Unfortunately, implementing this is extremely difficult, as -the fixed size of arrays is assumed in many places throughout the source -code. These runtime limits are a practical compromise between the -compile-time limits in previous versions, and truly dynamic arrays. (On -the other hand, the Web2c BibTeX implementation does do dynamic -reallocation of some arrays.) - - -File: web2c.info, Node: Commonalities, Next: TeX, Prev: Installation, Up: Top +File: web2c.info, Node: Commonalities, Next: Three programs, Prev: Installation, Up: Top 3 Commonalities *************** Many aspects of the TeX system are the same among more than one program, -so we describe all those pieces together, here. +so we describe those pieces together, here. * Menu: @@ -422,7 +380,6 @@ so we describe all those pieces together, here. * Common options:: -help -version -verbose, and TeX/MF/MP options. * Path searching:: Features of the common path searching library. * Output file location:: TEXMFOUTPUT allows output in places other than '.'. -* Three programs:: TeX, Metafont, and MetaPost have a lot in common.  File: web2c.info, Node: Option conventions, Next: Common options, Up: Commonalities @@ -482,6 +439,11 @@ identical descriptions for every program, they are described here. TeX, Metafont, and MetaPost have a number of additional options in common: +'-cnf-line=STR' + Parse STR as if it were a line in the 'texmf.cnf' configuration + file, overriding all other settings. *Note (kpathsea)Path + searching options::. + '-file-line-error' '-no-file-line-error' Change (or do not change) the way error messages are printed. The @@ -565,7 +527,8 @@ common: '-8bit' This option specifies that by default all characters should be considered printable. If '-translate-file' was given as well, then - the TCX file may mark characters as non-printable. + the TCX file may mark characters as non-printable. This is a no-op + in engines natively supporting Unicode.  File: web2c.info, Node: Path searching, Next: Output file location, Prev: Common options, Up: Commonalities @@ -588,7 +551,7 @@ distributed (and installed by default) 'texfonts.map' includes aliases for many widely available PostScript fonts by their PostScript names.  -File: web2c.info, Node: Output file location, Next: Three programs, Prev: Path searching, Up: Commonalities +File: web2c.info, Node: Output file location, Prev: Path searching, Up: Commonalities 3.4 Output file location ======================== @@ -618,29 +581,94 @@ files that need to be subsequently read; for input, no suffixes (such as the input name is simply checked as given.  -File: web2c.info, Node: Three programs, Prev: Output file location, Up: Commonalities +File: web2c.info, Node: Three programs, Next: TeX, Prev: Commonalities, Up: Top -3.5 Three programs: Metafont, MetaPost, and TeX -=============================================== +4 Three programs: Metafont, MetaPost, and TeX +********************************************* TeX, Metafont, and MetaPost have a number of features in common. -Besides the ones here, the common command-line options are described in -the previous section. The configuration file options that let you -control some array sizes and other features are described in *note -Runtime options::. +Besides the ones here, command-line options and other commonalities are +described in the previous section. * Menu: +* Runtime options:: The 'texmf.cnf' configuration file. * Initial and virgin:: Making memory dumps vs. production runs. * Memory dumps:: .fmt/.base files for fast startup. * Editor invocation:: The 'e' response at errors. * \input filenames:: Filename delimiters and Kpathsea expansion.  -File: web2c.info, Node: Initial and virgin, Next: Memory dumps, Up: Three programs +File: web2c.info, Node: Runtime options, Next: Initial and virgin, Up: Three programs -3.5.1 Initial and virgin ------------------------- +4.1 Runtime options +=================== + +Besides the configure- and compile-time options described in the +installation section (*note Installation::), you can control a number of +parameters in the 'texmf.cnf' runtime file read by Kpathsea (*note +(kpathsea)Config files::). + + The main purpose of 'texmf.cnf' is to specify search paths, but array +sizes and other options are also set there. Most are rather obscure. +Here are a few of the more interesting values: + +'main_memory' + Total words of memory available, for TeX, Metafont, and MetaPost. + Must remake the format file after changing. + +'extra_mem_bot' + Extra space for "large" TeX data structures (default 0): boxes, + glue, breakpoints, et al. If you use PiCTeX, you may well want to + set this. + +'expand_depth' + Limit on recursive expansion calls before TeX aborts (default + 10000). If a TeX program does an unterminated recursive expansion, + TeX will dutifully expand macros until the system's runtime stack + overflows, typically with a segmentation fault (SIGSEGV). This + parameter was introduced to minimize the chance of that unpleasant + (though not dangerous) crash, instead allowing TeX to quit with a + more informative message. + + The crash can still happen, though, if the system has an + exceptionally small memory allocation for its stack. There is no + quantitative way to determine the limit, and it does not seem worth + implementing system-dependent heuristics to guess at the number, + since it's highly improbable that any real TeX code will ever need + more than 10000 recursive expansions (it has never happened). For + the same reason, using the libsigsegv library + () does not seem worth the effort. + +'texmf_casefold_search' + *Note (kpathsea)Casefolding search::. + + Ideally all arrays would be dynamically expanded as necessary, so the +only limiting factor would be the amount of swap space available, or +some configurable limit much larger than can currently be supported. + + Unfortunately, implementing this is extremely difficult, as the fixed +size of arrays is assumed in many places throughout the source code. +These runtime limits are a practical compromise between the compile-time +limits in previous versions, and truly dynamic arrays. (On the other +hand, the Web2c BibTeX implementation does do true dynamic reallocation +of some arrays.) + + Nowadays there is rarely a reason to modify the values. But if you +do wish to modify 'texmf.cnf', in TeX Live the best approach is to put +your changes, and only your changes at the top of the TL installation +tree. That is, if the system 'texmf.cnf' is installed in +'/some/path/to/texlive/YYYY/texmf-dist/web2c/texmf.cnf' is put your +custom settings in '/some/path/to/texlive/YYY/texmf.cnf', where YYYY is +the year of installation (if you use that subdirectory; it's the +default). That way, unrelated changes to the system 'texmf.cnf' can +happen with normal updates, without affecting your local values. + + +File: web2c.info, Node: Initial and virgin, Next: Memory dumps, Prev: Runtime options, Up: Three programs + +4.2 Initial and virgin +====================== The TeX and Metafont programs each have two main variants, called "initial" and "virgin". MetaPost no longer makes this distinction. @@ -663,8 +691,8 @@ memory dump file.  File: web2c.info, Node: Memory dumps, Next: Editor invocation, Prev: Initial and virgin, Up: Three programs -3.5.2 Memory dumps ------------------- +4.3 Memory dumps +================ In typical use, TeX and Metafont require a large number of macros to be predefined; therefore, they support "memory dump" files, which can be @@ -679,8 +707,8 @@ read much more efficiently than ordinary source code.  File: web2c.info, Node: Creating memory dumps, Next: Determining the memory dump to use, Up: Memory dumps -3.5.2.1 Creating memory dumps -............................. +4.3.1 Creating memory dumps +--------------------------- The programs all create memory dumps in slightly idiosyncratic (thought substantially similar) way, so we describe the details in separate @@ -710,8 +738,8 @@ difficulties.  File: web2c.info, Node: Determining the memory dump to use, Next: Hardware and memory dumps, Prev: Creating memory dumps, Up: Memory dumps -3.5.2.2 Determining the memory dump to use -.......................................... +4.3.2 Determining the memory dump to use +---------------------------------------- The virgin form (*note Initial and virgin::) of each program always reads a memory dump before processing normal source input. All three @@ -744,8 +772,8 @@ programs determine the memory dump to use in the same way:  File: web2c.info, Node: Hardware and memory dumps, Prev: Determining the memory dump to use, Up: Memory dumps -3.5.2.3 Hardware and memory dumps -................................. +4.3.3 Hardware and memory dumps +------------------------------- By default, memory dump files are generally sharable between architectures of different types; specifically, on machines of different @@ -803,8 +831,8 @@ References::).  File: web2c.info, Node: Editor invocation, Next: \input filenames, Prev: Memory dumps, Up: Three programs -3.5.3 Editor invocation ------------------------ +4.4 Editor invocation +===================== TeX, Metafont, and MetaPost all (by default) stop and ask for user intervention at an error. If the input came from a file, and the user @@ -823,8 +851,8 @@ for the precise values.)  File: web2c.info, Node: \input filenames, Prev: Editor invocation, Up: Three programs -3.5.4 '\input' filenames ------------------------- +4.5 '\input' filenames +====================== TeX, Metafont, and MetaPost source programs can all read other source files with the '\input' (TeX) and 'input' (MF and MP) primitives: @@ -846,9 +874,10 @@ or other special characters, as described in the sections below. there is no way to read files whose names contain a '"'. However, for maximal portability of your document across systems, use -only the characters 'a'-'z', '0'-'9', and '.'. Do not use anything but -simple filenames, since directory separators vary among systems; -instead, add the necessary directories to the appropriate search path. +only the characters 'a'-'z', '0'-'9', and at most one '.'. Do not use +anything but simple filenames, since directory separators vary among +systems; instead, add the necessary directories to the appropriate +search path. * Menu: @@ -859,8 +888,8 @@ instead, add the necessary directories to the appropriate search path.  File: web2c.info, Node: \input quoted filename, Next: \input braced filename, Up: \input filenames -3.5.4.1 '\input' quoted filename: '\input "some name"' -...................................................... +4.5.1 '\input' quoted filename: '\input "some name"' +---------------------------------------------------- As of Web2c version 7.5.3 (2004), double-quote characters can be used to include spaces or other special characters. In typical use, the '"' @@ -881,8 +910,8 @@ its '\input' macro, thus:  File: web2c.info, Node: \input braced filename, Next: \input filename caveats, Prev: \input quoted filename, Up: \input filenames -3.5.4.2 '\input' braced filename: '\input{some name}' -..................................................... +4.5.2 '\input' braced filename: '\input{some name}' +--------------------------------------------------- As of Web2c 2020, '\input' filenames in TeX engines (this does not apply in Metafont and MetaPost) can also be specified within a TeX group, @@ -904,8 +933,8 @@ filename.  File: web2c.info, Node: \input filename caveats, Prev: \input braced filename, Up: \input filenames -3.5.4.3 '\input' filename caveats -................................. +4.5.3 '\input' filename caveats +------------------------------- The quoting mechanisms just described come into play _after_ TeX has tokenized and expanded the input. So, multiple spaces and tabs will @@ -936,9 +965,9 @@ actually use these in a document you have to change their catcodes or use '\string'.  -File: web2c.info, Node: TeX, Next: Metafont, Prev: Commonalities, Up: Top +File: web2c.info, Node: TeX, Next: Metafont, Prev: Three programs, Up: Top -4 TeX: Typesetting +5 TeX: Typesetting ****************** TeX is a typesetting system: it was especially designed to handle @@ -960,12 +989,12 @@ Many other books on TeX, introductory and otherwise, are available. * Languages and hyphenation:: TeX supports many human languages. * Shell escapes:: Running subprograms from TeX. * IPC and TeX:: DVI output to a socket. -* TeX extensions:: Changes to the TeX language. +* TeX extensions:: Additional engines with additional features.  File: web2c.info, Node: tex invocation, Next: Initial TeX, Up: TeX -4.1 'tex' invocation +5.1 'tex' invocation ==================== TeX (usually invoked as 'tex') formats the given text and commands, and @@ -1049,7 +1078,8 @@ the log file has not yet been opened. '-enc' Enable encTeX extensions, such as '\mubyte'. This can be used to - support Unicode UTF-8 input encoding. See + support the Unicode UTF-8 input encoding, although using an engine + with native Unicode support is more common nowadays. . '-ipc' @@ -1128,7 +1158,7 @@ the log file has not yet been opened.  File: web2c.info, Node: Initial TeX, Next: Formats, Prev: tex invocation, Up: TeX -4.2 Initial TeX +5.2 Initial TeX =============== The "initial" form of TeX is invoked by 'tex -ini'. It does lengthy @@ -1158,7 +1188,7 @@ details on TeX formats.  File: web2c.info, Node: Formats, Next: Languages and hyphenation, Prev: Initial TeX, Up: TeX -4.3 Formats +5.3 Formats =========== TeX "formats" are large collections of macros, often dumped into a @@ -1169,22 +1199,18 @@ release. You can change which formats are automatically built by setting the 'fmts' Make variable; by default, only the 'plain' and 'latex' formats are made. - You can get the latest versions of most of these formats from the -CTAN archives in subdirectories of 'CTAN:/macros' (for CTAN info, *note -(kpathsea)unixtex.ftp::). The archive - (also available from CTAN) contains -most of these formats (although perhaps not the absolute latest -version), among other things. + Nowadays, the formats are generally installed and updated as part of +a larger TeX distribution, such as TeX Live (). latex - The most widely used format. The current release is named 'LaTeX - 2e'; new versions are released approximately every six months, with - patches issued as needed. The old release was called 'LaTeX 2.09', - and is no longer maintained or supported. LaTeX attempts to - provide generic markup instructions, such as "emphasize", instead - of specific typesetting instructions, such as "use the 10pt - Computer Modern italic font". The LaTeX home page: - . + The most widely used format. The current release is named + 'LaTeX2e'; new versions are released approximately every six + months, with patches issued as needed. The old release was called + 'LaTeX 2.09', and is no longer maintained or supported. LaTeX + attempts to provide generic markup instructions, such as + "emphasize", instead of specific typesetting instructions, such as + "use the 10pt Computer Modern italic font". The LaTeX home page: + . context ConTeXt is an independent macro package which has a basic document @@ -1196,34 +1222,35 @@ context amstex The official typesetting system of the American Mathematical Society. Like LaTeX, it encourages generic markup commands. The - AMS also provides many LaTeX package for authors who prefer LaTeX. + AMS also provides many LaTeX packages for authors who prefer LaTeX. Taken together, they are used to produce nearly all AMS publications, e.g., 'Mathematical Reviews'. The AMSTeX home page: - . + . texinfo The documentation system developed and maintained by the Free Software Foundation for their software manuals. It can be automatically converted into plain text, a machine-readable on-line format called 'info', HTML, etc. The Texinfo home page: - . + . eplain The "expanded plain" format provides various common features (e.g., symbolic cross-referencing, tables of contents, indexing, citations using BibTeX), for those authors who prefer to handle their own high-level formatting. The Eplain home page: - . + . slitex An obsolete LaTeX 2.09 format for making slides. It is replaced by - the 'slides' document class, along with the 'beamer', 'texpower', - and other packages. + the 'slides' document class, although the 'beamer' package is the + most commonly method for making slides nowadays. The Beamer page + on CTAN: .  File: web2c.info, Node: Languages and hyphenation, Next: Shell escapes, Prev: Formats, Up: TeX -4.4 Languages and hyphenation +5.4 Languages and hyphenation ============================= TeX supports most natural languages. See also *note TeX extensions: TeX @@ -1238,20 +1265,23 @@ extensions.  File: web2c.info, Node: MLTeX, Next: TCX files, Up: Languages and hyphenation -4.4.1 MLTeX: Multi-lingual TeX +5.4.1 MLTeX: Multi-lingual TeX ------------------------------ Multi-lingual TeX ('mltex') is an extension of TeX originally written by -Michael Ferguson and now updated and maintained by Bernd Raichle. It -allows the use of non-existing glyphs in a font by declaring glyph -substitutions. These are restricted to substitutions of an accented -character glyph, which need not be defined in the current font, by its -appropriate '\accent' construction using a base and accent character -glyph, which do have to exist in the current font. This substitution is -automatically done behind the scenes, if necessary, and thus MLTeX -additionally supports hyphenation of words containing an accented -character glyph for fonts missing this glyph (e.g., Computer Modern). -Standard TeX suppresses hyphenation in this case. +Michael Ferguson and now updated and maintained by Bernd Raichle. With +the advent of Unicode, it has become obsolete, though it is still +supported in Web2c in the event of bugs or compilation bugs. + + MLTeX allows the use of non-existing glyphs in a font by declaring +glyph substitutions. These are restricted to substitutions of an +accented character glyph, which need not be defined in the current font, +by its appropriate '\accent' construction using a base and accent +character glyph, which do have to exist in the current font. This +substitution is automatically done behind the scenes, if necessary, and +thus MLTeX additionally supports hyphenation of words containing an +accented character glyph for fonts missing this glyph (e.g., Computer +Modern). Standard TeX suppresses hyphenation in this case. MLTeX works at '.fmt'-creation time: the basic idea is to specify the '-mltex' option to TeX when you '\dump' a format. Then, when you @@ -1273,7 +1303,7 @@ TeX.  File: web2c.info, Node: \charsubdef, Next: \tracingcharsubdef, Up: MLTeX -4.4.1.1 '\charsubdef': Character substitutions +5.4.1.1 '\charsubdef': Character substitutions .............................................. The most important primitive MLTeX adds is '\charsubdef', used in a way @@ -1322,7 +1352,7 @@ generally useful.)  File: web2c.info, Node: \tracingcharsubdef, Prev: \charsubdef, Up: MLTeX -4.4.1.2 '\tracingcharsubdef': Substitution diagnostics +5.4.1.2 '\tracingcharsubdef': Substitution diagnostics ...................................................... To help diagnose problems with '\charsubdef', MLTeX provides a new @@ -1337,7 +1367,7 @@ be recorded.  File: web2c.info, Node: TCX files, Next: patgen invocation, Prev: MLTeX, Up: Languages and hyphenation -4.4.2 TCX files: Character translations +5.4.2 TCX files: Character translations --------------------------------------- TCX (TeX character translation) files help TeX support direct input of @@ -1458,7 +1488,7 @@ from the dump is ignored and the data from the file used instead.  File: web2c.info, Node: patgen invocation, Prev: TCX files, Up: Languages and hyphenation -4.4.3 Patgen: Creating hyphenation patterns +5.4.3 Patgen: Creating hyphenation patterns ------------------------------------------- Patgen creates hyphenation patterns from dictionary files for use with @@ -1479,7 +1509,7 @@ Liang (*note References::), and also the 'patgen.web' source file.  File: web2c.info, Node: Shell escapes, Next: IPC and TeX, Prev: Languages and hyphenation, Up: TeX -4.5 Shell escapes +5.5 Shell escapes ================= TeX can execute "shell escapes", that is, arbitrary shell commands. @@ -1556,7 +1586,7 @@ considered untrustworthy, shell escapes should be completely disabled.  File: web2c.info, Node: IPC and TeX, Next: TeX extensions, Prev: Shell escapes, Up: TeX -4.6 IPC and TeX +5.6 IPC and TeX =============== (If anyone uses this feature and needs documentation, write @@ -1573,42 +1603,61 @@ its socket operations. This may be helpful if you are, well, debugging.  File: web2c.info, Node: TeX extensions, Prev: IPC and TeX, Up: TeX -4.7 TeX extensions -================== +5.7 Extended TeX engines +======================== The base TeX program has been extended in many ways. Here's a partial list. e-TeX Adds many new primitives, including right-to-left typesetting and - more registers. Now frozen. + more registers. Now frozen. More info: + . Aleph This adds Unicode support, right-to-left typesetting, and more. Omega was the original program. Aleph is an updated version with a variety of bug fixes, and includes e-TeX. Aleph is not actively - maintained. + maintained. More info: , + . pdfTeX Can produce PDF as well as DVI files. It also incorporates the e-TeX extensions, new primitives for hypertext and - micro-typography, reading/writing from pipes, and much more. Home - page: . - -luaTeX - Based on pdfTeX, this also embeds the Lua programming language - () and opens up the TeX typesetting engine to - control from Lua. Home page: . + micro-typography, reading/writing from pipes, and much more. In + TeX Live, the command 'etex' invokes pdfTeX to make all these + additions available with DVI output. Home page: + . + +LuaTeX + Embeds the Lua programming language () and opens up + the TeX typesetting engine to control from Lua, starting from the + pdfTeX capabilities as a base. Also natively supports UTF-8 input, + the OpenType and TrueType font formats, and use of system fonts. + Home page: . XeTeX - Combines support for Unicode input and OpenType- and system fonts - with the capabilities of pdfTeX. Home page: - . + Combines support for Unicode input, the OpenType and TrueType font + formats, and use of system fonts with the capabilities of pdfTeX, + with the exception of the font expansion part of micro-typography. + Home page: . + +pTeX +upTeX + With additional support for Japanese; pTeX was the original engine, + and upTeX has native Unicode support and thus is more useful for + Chinese and Korean. More info: , + . + +epTeX +eupTeX + Further extends pTeX and upTeX with the e-TeX extensions. More + info: , .  File: web2c.info, Node: Metafont, Next: MetaPost, Prev: TeX, Up: Top -5 Metafont: Creating typeface families +6 Metafont: Creating typeface families ************************************** Metafont is a system for producing shapes; it was designed for producing @@ -1637,7 +1686,7 @@ complete description of the Metafont language, see 'The METAFONTbook'  File: web2c.info, Node: mf invocation, Next: Initial Metafont, Up: Metafont -5.1 'mf' invocation +6.1 'mf' invocation =================== Metafont (usually invoked as 'mf') reads character definitions specified @@ -1727,7 +1776,7 @@ usual. For example:  File: web2c.info, Node: Initial Metafont, Next: Modes, Prev: mf invocation, Up: Metafont -5.2 Initial Metafont +6.2 Initial Metafont ==================== 'inimf' is the "initial" form of Metafont, which does lengthy @@ -1762,7 +1811,7 @@ course.  File: web2c.info, Node: Modes, Next: Online Metafont graphics, Prev: Initial Metafont, Up: Metafont -5.3 Modes: Device definitions for Metafont +6.3 Modes: Device definitions for Metafont ========================================== Running Metafont and creating Metafont base files requires information @@ -1812,7 +1861,7 @@ conventions:  File: web2c.info, Node: Online Metafont graphics, Next: gftodvi invocation, Prev: Modes, Up: Metafont -5.4 Online Metafont graphics +6.4 Online Metafont graphics ============================ The Web2c implementation of Metafont can do online graphics with a @@ -1897,7 +1946,7 @@ MFtalk (see 'web2c/window/mftalk.c').  File: web2c.info, Node: gftodvi invocation, Next: mft invocation, Prev: Online Metafont graphics, Up: Metafont -5.5 GFtoDVI: Character proofs of fonts +6.5 GFtoDVI: Character proofs of fonts ====================================== GFtoDVI makes "proof sheets" from a GF bitmap file as output by, for @@ -1962,7 +2011,7 @@ process as usual.  File: web2c.info, Node: mft invocation, Prev: gftodvi invocation, Up: Metafont -5.6 MFT: Prettyprinting Metafont source +6.6 MFT: Prettyprinting Metafont source ======================================= MFT translates a Metafont program into a TeX document suitable for @@ -2047,13 +2096,14 @@ print these properly.  File: web2c.info, Node: MetaPost, Next: BibTeX, Prev: Metafont, Up: Top -6 MetaPost: Creating technical illustrations -******************************************** +7 MetaPost: Generating PostScript +********************************* MetaPost is a picture-drawing language similar to Metafont (*note Metafont::), but instead of outputting bitmaps in a "font", it outputs PostScript commands. It's primarily intended for creating technical -illustrations. +illustrations, but can also be used to create PostScript or OpenType +fonts (). MetaPost also provides for arbitrary integration of text and graphics in a natural way, using any typesetter (TeX and Troff are both @@ -2068,7 +2118,7 @@ supported) and a number of other subsidiary programs, described below.  File: web2c.info, Node: mpost invocation, Next: Initial MetaPost, Up: MetaPost -6.1 'mpost' invocation +7.1 'mpost' invocation ====================== MetaPost (installed as 'mpost') reads a series of pictures specified in @@ -2077,18 +2127,14 @@ code. This section merely describes the options available in the Web2c implementation. For a complete description of the MetaPost language, see AT&T technical report CSTR-162, generally available in 'TEXMF/doc/metapost/', where TEXMF is the root of TeX directory -structure. See also: - * (the MetaPost - author's home page); - * (papers, packages, and related - information). +structure. The MetaPost home page: . Also, a standard MetaPost package for drawing graphs is documented in AT&T technical report CSTR-164, available as the file 'mpgraph.ps', generally stored alongside 'mpman.ps'. MetaPost processes its command line and determines its memory dump -(mem) file in a way exactly analogous to Metafont and TeX (*note 'tex' +(mem) file in a way analogous to Metafont and TeX (*note 'tex' invocation: tex invocation, and *note Memory dumps::). Synopses: mpost [OPTION]... [MPNAME[.mp]] [MP-COMMANDS] @@ -2189,7 +2235,7 @@ opens a security hole. *Note tex invocation::.  File: web2c.info, Node: Initial MetaPost, Next: dvitomp invocation, Prev: mpost invocation, Up: MetaPost -6.2 Initial MetaPost +7.2 Initial MetaPost ==================== As of MetaPost 1.504 (TeX Live 2011), MetaPost no longer dumps '.mem' @@ -2211,7 +2257,7 @@ GFtoDVI (*note gftodvi invocation::).  File: web2c.info, Node: dvitomp invocation, Prev: Initial MetaPost, Up: MetaPost -6.3 DVItoMP: DVI to MPX conversion +7.3 DVItoMP: DVI to MPX conversion ================================== DVItoMP converts DVI files into low-level MetaPost commands in a @@ -2231,7 +2277,7 @@ NAME' and 'color pop', outputting them as 'withcolor' MetaPost commands.  File: web2c.info, Node: BibTeX, Next: WEB, Prev: MetaPost, Up: Top -7 BibTeX: Bibliographies +8 BibTeX: Bibliographies ************************ BibTeX automates much of the job of typesetting bibliographies, and @@ -2245,7 +2291,7 @@ makes bibliography entries reusable in many different contexts.  File: web2c.info, Node: bibtex invocation, Next: Basic BibTeX style files, Up: BibTeX -7.1 BibTeX invocation +8.1 BibTeX invocation ===================== BibTeX creates a printable bibliography ('.bbl') file from references in @@ -2306,7 +2352,7 @@ macros. BibTeX searches for '.bib' files using the 'BIBINPUTS' and  File: web2c.info, Node: Basic BibTeX style files, Prev: bibtex invocation, Up: BibTeX -7.2 Basic BibTeX style files +8.2 Basic BibTeX style files ============================ Here are descriptions of the four standard and four semi-standard basic @@ -2350,7 +2396,7 @@ CTAN info, *note (kpathsea)unixtex.ftp::).  File: web2c.info, Node: WEB, Next: DVI utilities, Prev: BibTeX, Up: Top -8 WEB: Literate programming +9 WEB: Literate programming *************************** "WEB" languages allow you to write a single source file that can produce @@ -2380,7 +2426,7 @@ available in many other places, of course).  File: web2c.info, Node: tangle invocation, Next: weave invocation, Up: WEB -8.1 Tangle: Translate WEB to Pascal +9.1 Tangle: Translate WEB to Pascal =================================== Tangle creates a compilable Pascal program from a WEB source file (*note @@ -2433,7 +2479,7 @@ semicolons when this can be done conveniently.  File: web2c.info, Node: weave invocation, Next: pooltype invocation, Prev: tangle invocation, Up: WEB -8.2 Weave: Translate WEB to TeX +9.2 Weave: Translate WEB to TeX =============================== Weave creates a TeX document from a WEB source file (*note WEB::), @@ -2465,7 +2511,7 @@ change in the change file).  File: web2c.info, Node: pooltype invocation, Prev: weave invocation, Up: WEB -8.3 Pooltype: Display WEB pool files +9.3 Pooltype: Display WEB pool files ==================================== Pooltype shows the so-called "string number" of each string in a WEB @@ -2500,8 +2546,8 @@ output.  File: web2c.info, Node: DVI utilities, Next: Font utilities, Prev: WEB, Up: Top -9 DVI utilities -*************** +10 DVI utilities +**************** TeX outputs a file in "DVI" (DeVice Independent) format as a compact representation of the original document. DVI files can be translated to @@ -2525,8 +2571,8 @@ drivers; they perform generic utility functions.  File: web2c.info, Node: dvicopy invocation, Next: dvitype invocation, Up: DVI utilities -9.1 DVIcopy: Canonicalize virtual font references -================================================= +10.1 DVIcopy: Canonicalize virtual font references +================================================== DVIcopy reads a DVI file, expands any references to virtual fonts (*note (dvips)Virtual fonts::) to base fonts, and writes the resulting DVI @@ -2558,8 +2604,8 @@ standard output if OUTDVI is not specified.  File: web2c.info, Node: dvitype invocation, Prev: dvicopy invocation, Up: DVI utilities -9.2 DVItype: Plain text transliteration of DVI files -==================================================== +10.2 DVItype: Plain text transliteration of DVI files +===================================================== DVItype translates a DeVice Independent (DVI) file (as output by TeX, for example) to a plain text file that humans can read. It also serves @@ -2619,8 +2665,8 @@ program.  File: web2c.info, Node: dvitype output example, Up: dvitype invocation -9.2.1 DVItype output example ----------------------------- +10.2.1 DVItype output example +----------------------------- As an example of the output from DVItype (see section above), here is its (abridged) translation of the 'story.dvi' resulting from running the @@ -2697,7 +2743,7 @@ example in 'The TeXbook', with '-output-level=4' and '-show-opcodes' on.  File: web2c.info, Node: Font utilities, Next: Legalisms, Prev: DVI utilities, Up: Top -10 Font utilities +11 Font utilities ***************** The Web2c programs described here convert between various TeX-related @@ -2725,7 +2771,7 @@ mentioned below are in the source files that read them; 'pktype.web',  File: web2c.info, Node: Font file formats, Next: gftopk invocation, Up: Font utilities -10.1 Font file formats +11.1 Font file formats ====================== (For another perspective on this, *note (dvips)Font concepts::). @@ -2790,7 +2836,7 @@ distribution by Pierre MacKay and Elizabeth Tachikawa.)  File: web2c.info, Node: gftopk invocation, Next: pktogf invocation, Prev: Font file formats, Up: Font utilities -10.2 GFtoPK: Generic to packed font conversion +11.2 GFtoPK: Generic to packed font conversion ============================================== GFtoPK converts a generic font (GF) file output by, for example, @@ -2820,7 +2866,7 @@ Common options::).  File: web2c.info, Node: pktogf invocation, Next: pktype invocation, Prev: gftopk invocation, Up: Font utilities -10.3 PKtoGF: Packed to generic font conversion +11.3 PKtoGF: Packed to generic font conversion ============================================== PKtoGF converts a packed font (PK) file to a generic font (GF) file. @@ -2849,7 +2895,7 @@ Common options::).  File: web2c.info, Node: pktype invocation, Next: gftype invocation, Prev: pktogf invocation, Up: Font utilities -10.4 PKtype: Plain text transliteration of packed fonts +11.4 PKtype: Plain text transliteration of packed fonts ======================================================= PKtype translates a packed font (PK) bitmap file (as output by GFtoPK, @@ -2928,7 +2974,7 @@ Explanation:  File: web2c.info, Node: gftype invocation, Next: tftopl invocation, Prev: pktype invocation, Up: Font utilities -10.5 GFtype: Plain text transliteration of generic fonts +11.5 GFtype: Plain text transliteration of generic fonts ======================================================== GFtype translates a generic font (GF) bitmap file (as output by @@ -3047,7 +3093,7 @@ Explanation:  File: web2c.info, Node: tftopl invocation, Next: pltotf invocation, Prev: gftype invocation, Up: Font utilities -10.6 TFtoPL: TeX font metric to property list conversion +11.6 TFtoPL: TeX font metric to property list conversion ======================================================== TFtoPL translates a TeX font metric (TFM, *note (dvips)Metric files::) @@ -3165,7 +3211,7 @@ translation of 'cmr10.tfm':  File: web2c.info, Node: pltotf invocation, Next: vftovp invocation, Prev: tftopl invocation, Up: Font utilities -10.7 PLtoTF: Property list to TeX font metric conversion +11.7 PLtoTF: Property list to TeX font metric conversion ======================================================== PLtoTF translates a property list file (as output by TFtoPL, for @@ -3189,7 +3235,7 @@ Common options::).  File: web2c.info, Node: vftovp invocation, Next: vptovf invocation, Prev: pltotf invocation, Up: Font utilities -10.8 VFtoVP: Virtual font to virtual property lists +11.8 VFtoVP: Virtual font to virtual property lists =================================================== VFtoVP translates a virtual font metric (VF, *note (dvips)Virtual @@ -3235,7 +3281,7 @@ VFtoVP (see the next section).  File: web2c.info, Node: vptovf invocation, Next: Font utilities available elsewhere, Prev: vftovp invocation, Up: Font utilities -10.9 VPtoVF: Virtual property lists to virtual font +11.9 VPtoVF: Virtual property lists to virtual font =================================================== VPtoVF translates a virtual property list file (as output by VFtoVP, for @@ -3258,7 +3304,7 @@ Common options::).  File: web2c.info, Node: Font utilities available elsewhere, Prev: vptovf invocation, Up: Font utilities -10.10 Font utilities available elsewhere +11.10 Font utilities available elsewhere ======================================== The Web2c complement of font utilities merely implements a few basic @@ -3295,11 +3341,7 @@ items: 'CTAN:/fonts/utilities/ps2pk'. * PostScript Type 1 font format conversion (i.e., between PFA and PFB - formats): . - - * Scanned image conversion: the (aging) GNU font utilities convert - type specimen images to Metafont, PostScript, etc.: - . + formats): . * Tracing bitmaps to fitted outlines: Autotrace (), Potrace @@ -3308,7 +3350,7 @@ items: or 'textrace' () make the job easier. - * Virtual font creation: 'CTAN:/fonts/utilities/fontinst'. + * Virtual font creation: .  File: web2c.info, Node: Legalisms, Next: References, Prev: Font utilities, Up: Top @@ -3319,42 +3361,27 @@ Appendix A Legalisms In general, each file has its own copyright notice stating the copying permissions for that file. Following is a summary. - The Web2c system itself and most of the original WEB source files are -public domain. - - 'tex.web', the MLTeX code, 'mf.web', and 'bibtex.web', are -copyrighted by their authors. They may be copied verbatim, but may be -modified only through a '.ch' file. - - MetaPost-related files, including 'mp.web' itself, are copyrighted -under X-like terms; the precise notice is included below. - - Finally, the Kpathsea library is covered by the GNU Lesser General -Public License (*note (kpathsea)Introduction::). Therefore, the -_binaries_ resulting from a standard Web2c compilation are also covered -by the LGPL; so if you (re)distribute the binaries, you must also (offer -to) distribute the complete source that went into those binaries. See -the file 'LGPL' for complete details on the LGPL. - - The following notice must be included by the terms of the MetaPost -copyright. - - Permission to use, copy, modify, and distribute this software and - its documentation for any purpose and without fee is hereby - granted, provided that the above copyright notice appear in all - copies and that both that the copyright notice and this permission - notice and warranty disclaimer appear in supporting documentation, - and that the names of AT&T Bell Laboratories or any of its entities - not be used in advertising or publicity pertaining to distribution - of the software without specific, written prior permission. - - AT&T disclaims all warranties with regard to this software, - including all implied warranties of merchantability and fitness. - In no event shall AT&T be liable for any special, indirect or - consequential damages or any damages whatsoever resulting from loss - of use, data or profits, whether in an action of contract, - negligence or other tortious action, arising out of or in - connection with the use or performance of this software. + The Stanford TeX programs and Web2c system itself are in the public +domain (). The sources may be +copied verbatim, or used as the starting point of new software under +different names; however, per the wishes of the authors, they should be +modified only through a '.ch' file, but this is in the nature of a +development request rather than a legal requirement. + + MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived engines have +used various license terms for their additions to the base code, often +the GPL (see or (for example) the +file 'web2c/pdftexdir/COPYINGv2'. They also mostly make use of +additional libraries with their own (compatible) terms. Please see each +program's sources. + + The Kpathsea library is covered by the GNU Lesser General Public +License (*note (kpathsea)Introduction::). Therefore, the _binaries_ +resulting from a standard Web2c compilation are also covered by the +LGPL; so if you (re)distribute the binaries, you must also (offer to) +distribute the complete source that went into those binaries. See + or the file +'kpathsea/COPYING.LESSERv2'.  File: web2c.info, Node: References, Next: Index, Prev: Legalisms, Up: Top @@ -3366,10 +3393,11 @@ Appendix B References 2. Dvips and Afm2tfm: *Note Introduction: (dvips)Top. - 3. The TeX Users Group: . For an introduction to - the TeX system, see . + 3. The TeX Users Group: . For an introduction to the + TeX system, see . - 4. TUGboat: . + 4. TUGboat, the principal journal for the TeX world: + . 5. TeX and computer typesetting in general: . @@ -3380,92 +3408,81 @@ Appendix B References 7. [Bil87] Neenie Billawala. Write-white printing engines and tuning fonts with Metafont. 'TUGboat', 8(1):29-32, April 1987. - . + . - 8. [GMS94] Michel Goossens, Frank Mittelbach, and Alexander Samarin. - 'The LaTeX Companion'. Addison-Wesley, Reading, MA, USA, 1994. - - 9. [Hob89] John D. Hobby. A Metafont-like system with PS output. + 8. [Hob89] John D. Hobby. A Metafont-like system with PS output. 'TUGboat', 10(4):505-512, December 1989. - . + . - 10. [Hob92] John D. Hobby. A User's Manual for MetaPost. Technical + 9. [Hob92] John D. Hobby. A User's Manual for MetaPost. Technical Report CSTR-162, AT&T Bell Laboratories, 1992. - 11. [Hob93] John D. Hobby. Drawing Graphs with MetaPost. Technical + 10. [Hob93] John D. Hobby. Drawing Graphs with MetaPost. Technical Report CSTR-164, AT&T Bell Laboratories, 1993. - 12. [HS91] Samuel P. Harbison and Guy L. Steele Jr. 'C--A Reference + 11. [HS91] Samuel P. Harbison and Guy L. Steele Jr. 'C--A Reference Manual'. Prentice-Hall, Upper Saddle River, NJ 07458, USA, third edition, 1991. An authoritative reference to the C programming language, and a good companion to Kernighan and Ritchie. - 13. [KL93] Donald E. Knuth and Silvio Levy. 'The CWEB System of + 12. [KL93] Donald E. Knuth and Silvio Levy. 'The CWEB System of Structured Documentation, Version 3.0'. Addison-Wesley, Reading, - MA, USA, 1993. + MA, USA, 1993. . - 14. [Knu84] Donald E. Knuth. A torture test for TeX. Report No. + 13. [Knu84] Donald E. Knuth. A torture test for TeX. Report No. STAN-CS-84-1027, Stanford University, Department of Computer Science, 1984. - 15. [Knu86a] Donald E. Knuth. A Torture Test for METAFONT. Report No. + 14. [Knu86a] Donald E. Knuth. A Torture Test for METAFONT. Report No. STAN-CS-86-1095, Stanford University, Department of Computer Science, 1986. - 16. [Knu86b] Donald E. Knuth. 'The TeXbook', volume A of 'Computers + 15. [Knu86b] Donald E. Knuth. 'The TeXbook', volume A of 'Computers and Typesetting'. Addison-Wesley, Reading, MA, USA, 1986. - 17. [Knu86c] Donald E. Knuth. 'TeX: The Program', volume B of + 16. [Knu86c] Donald E. Knuth. 'TeX: The Program', volume B of 'Computers and Typesetting'. Addison-Wesley, Reading, MA, USA, 1986. - 18. [Knu86d] Donald E. Knuth. 'The METAFONTbook', volume C of + 17. [Knu86d] Donald E. Knuth. 'The METAFONTbook', volume C of 'Computers and Typesetting'. Addison-Wesley, Reading, MA, USA, 1986. - 19. [Knu86e] Donald E. Knuth. 'METAFONT: The Program', volume D of + 18. [Knu86e] Donald E. Knuth. 'METAFONT: The Program', volume D of 'Computers and Typesetting'. Addison-Wesley, Reading, MA, USA, 1986. - 20. [Knu86f] Donald E. Knuth. 'Computer Modern Typefaces', volume E + 19. [Knu86f] Donald E. Knuth. 'Computer Modern Typefaces', volume E of 'Computers and Typesetting'. Addison-Wesley, Reading, MA, USA, 1986. - 21. [Knu89] Donald E. Knuth. The errors of TeX. 'Software--Practice + 20. [Knu89] Donald E. Knuth. The errors of TeX. 'Software--Practice and Experience', 19(7):607-681, July 1989. This is an updated version of Knuth:1988:ET. - 22. [Knu90] Donald Knuth. Virtual Fonts: More Fun for Grand Wizards. + 21. [Knu90] Donald Knuth. Virtual Fonts: More Fun for Grand Wizards. 'TUGboat', 11(1):13-23, April 1990. - . + . - 23. [Knu92] Donald E. Knuth. 'Literate Programming'. CSLI Lecture + 22. [Knu92] Donald E. Knuth. 'Literate Programming'. CSLI Lecture Notes Number 27. Stanford University Center for the Study of Language and Information, Stanford, CA, USA, 1992. - 24. [Lam94] Leslie Lamport. 'LaTeX: A Document Preparation System: + 23. [Lam94] Leslie Lamport. 'LaTeX: A Document Preparation System: User's Guide and Reference Manual'. Addison-Wesley, Reading, MA, - USA, second edition, 1994. Reprinted with corrections in 1996. + USA, second edition, 1994. Reprinted with corrections, 1996. - 25. [Lia83] Franklin Mark Liang. Word hy-phen-a-tion by com-pu-ter. + 24. [Lia83] Franklin Mark Liang. Word hy-phen-a-tion by com-pu-ter. Technical Report STAN-CS-83-977, Stanford University, August 1983. - . + . - 26. [Mac91] Pierre A. MacKay. Looking at the pixels: Quality control + 25. [Mac91] Pierre A. MacKay. Looking at the pixels: Quality control for 300 dpi laser printer fonts, especially Metafonts. In Robert A. Morris and Jacques Andre, editors, 'Raster Imaging and Digital Typography II--Papers from the second RIDT meeting, held in Boston, Oct. 14-16, 1991', pages 205-215, New York, 1991. Cambridge University Press. - 27. [Spi89] Michael D. Spivak. 'LAMSTeX, The Synthesis'. The - TeXplorators Corporation, 3701 W. Alabama, Suite 450-273, Houston, - TX 77027, USA, 1989. - - 28. [Spi90] Michael D. Spivak. 'The Joy of TeX--A Gourmet Guide to - Typesetting with the AMSTeX macro package'. American Mathematical - Society, Providence, RI, USA, 2nd revised edition, 1990. -  File: web2c.info, Node: Index, Prev: References, Up: Top @@ -3493,7 +3510,7 @@ Index (line 20) * --enable-hp2627win: Online Metafont graphics. (line 28) -* --enable-ipc configure option: tex invocation. (line 92) +* --enable-ipc configure option: tex invocation. (line 93) * --enable-mftalkwin: Online Metafont graphics. (line 31) * --enable-next: Online Metafont graphics. @@ -3514,35 +3531,36 @@ Index (line 59) * --with-x: Online Metafont graphics. (line 57) -* -8bit: Common options. (line 105) +* -8bit: Common options. (line 110) * -base=BASE: Determining the memory dump to use. (line 15) -* -base=DUMPNAME: Common options. (line 34) +* -base=DUMPNAME: Common options. (line 39) * -change=CHFILE: mft invocation. (line 63) * -charcode-format=TYPE: tftopl invocation. (line 27) * -charcode-format=TYPE <1>: vftovp invocation. (line 30) +* -cnf-line: Common options. (line 25) * -D compiler options: Compile-time options. (line 6) -* -disable-write18: tex invocation. (line 127) +* -disable-write18: tex invocation. (line 128) * -dpi=REAL: dvitype invocation. (line 24) -* -enable-write18: tex invocation. (line 126) +* -enable-write18: tex invocation. (line 127) * -enc: tex invocation. (line 86) -* -file-line-error: Common options. (line 25) -* -file-line-error-style: Common options. (line 26) -* -fmt=DUMPNAME: Common options. (line 34) +* -file-line-error: Common options. (line 30) +* -file-line-error-style: Common options. (line 31) +* -fmt=DUMPNAME: Common options. (line 39) * -fmt=FMT: Determining the memory dump to use. (line 15) * -geometry, supported with Xt: Online Metafont graphics. (line 69) -* -halt-on-error: Common options. (line 41) +* -halt-on-error: Common options. (line 46) * -images: gftype invocation. (line 26) -* -ini: Common options. (line 45) +* -ini: Common options. (line 50) * -ini <1>: Initial and virgin. (line 10) -* -interaction=STRING: Common options. (line 50) -* -ipc: tex invocation. (line 92) -* -ipc-start: tex invocation. (line 92) -* -jobname=STRING: Common options. (line 55) -* -kpathsea-debug=NUMBER: Common options. (line 59) +* -interaction=STRING: Common options. (line 55) +* -ipc: tex invocation. (line 93) +* -ipc-start: tex invocation. (line 93) +* -jobname=STRING: Common options. (line 60) +* -kpathsea-debug=NUMBER: Common options. (line 64) * -length=NUMBER: tangle invocation. (line 27) * -loose: tangle invocation. (line 46) * -lowercase: tangle invocation. (line 35) @@ -3550,41 +3568,41 @@ Index * -magnification=INTEGER <1>: dvitype invocation. (line 28) * -max-pages=N: dvicopy invocation. (line 25) * -max-pages=N <1>: dvitype invocation. (line 33) -* -mem=DUMPNAME: Common options. (line 34) +* -mem=DUMPNAME: Common options. (line 39) * -min-crossrefs=N: bibtex invocation. (line 31) * -mixedcase: tangle invocation. (line 35) -* -mktex=FILETYPE: tex invocation. (line 102) +* -mktex=FILETYPE: tex invocation. (line 103) * -mktex=FILETYPE <1>: mf invocation. (line 87) -* -mltex: tex invocation. (line 107) +* -mltex: tex invocation. (line 108) * -mnemonics: gftype invocation. (line 29) -* -no-file-line-error: Common options. (line 26) -* -no-mktex=FILETYPE: tex invocation. (line 102) +* -no-file-line-error: Common options. (line 31) +* -no-mktex=FILETYPE: tex invocation. (line 103) * -no-mktex=FILETYPE <1>: mf invocation. (line 87) -* -no-parse-first-line: Common options. (line 72) -* -no-shell-escape: tex invocation. (line 120) -* -output-comment=STRING: tex invocation. (line 112) -* -output-directory: Common options. (line 66) +* -no-parse-first-line: Common options. (line 77) +* -no-shell-escape: tex invocation. (line 121) +* -output-comment=STRING: tex invocation. (line 113) +* -output-directory: Common options. (line 71) * -output-directory <1>: Output file location. (line 15) * -output-level=N: dvitype invocation. (line 36) * -overflow-label-offset=POINTS: gftodvi invocation. (line 59) * -page-start=PAGE-SPEC: dvicopy invocation. (line 28) * -page-start=PAGE-SPEC <1>: dvitype invocation. (line 46) -* -parse-first-line: Common options. (line 71) -* -progname=STRING: Common options. (line 77) +* -parse-first-line: Common options. (line 76) +* -progname=STRING: Common options. (line 82) * -progname=STRING <1>: Determining the memory dump to use. (line 17) -* -recorder: Common options. (line 84) -* -shell-escape: tex invocation. (line 119) -* -shell-restricted: tex invocation. (line 121) +* -recorder: Common options. (line 89) +* -shell-escape: tex invocation. (line 120) +* -shell-restricted: tex invocation. (line 122) * -show-opcodes: dvitype invocation. (line 52) * -strict: tangle invocation. (line 46) * -style=MFTFILE: mft invocation. (line 67) -* -T: mpost invocation. (line 115) +* -T: mpost invocation. (line 111) * -terse: bibtex invocation. (line 28) -* -tex=TEXPROGRAM: mpost invocation. (line 118) -* -translate-file=TCXFILE: Common options. (line 98) -* -troff: mpost invocation. (line 115) +* -tex=TEXPROGRAM: mpost invocation. (line 114) +* -translate-file=TCXFILE: Common options. (line 103) +* -troff: mpost invocation. (line 111) * -underline: tangle invocation. (line 41) * -uppercase: tangle invocation. (line 35) * -x: weave invocation. (line 22) @@ -3598,22 +3616,22 @@ Index * .blg BibTeX log file: bibtex invocation. (line 14) * .fmt: Initial TeX. (line 6) * .mf: mf invocation. (line 24) -* .mp: mpost invocation. (line 30) -* .mps files and PDF: mpost invocation. (line 86) -* .NNN PostScript figures: mpost invocation. (line 35) +* .mp: mpost invocation. (line 26) +* .mps files and PDF: mpost invocation. (line 82) +* .NNN PostScript figures: mpost invocation. (line 31) * .NNNgf generic fonts: mf invocation. (line 34) -* .tcx character translation files: Common options. (line 98) +* .tcx character translation files: Common options. (line 103) * .tcx character translation files <1>: TCX files. (line 6) * .tex: tex invocation. (line 20) * .tfm output: mf invocation. (line 43) -* .tfm output <1>: mpost invocation. (line 35) +* .tfm output <1>: mpost invocation. (line 31) * .Xdefaults: Online Metafont graphics. (line 69) * .Xresources: Online Metafont graphics. (line 69) * 2602gf: mf invocation. (line 48) -* 8 bit clean: Common options. (line 105) -* 8 bit clean output, specifying: Common options. (line 105) +* 8 bit clean: Common options. (line 110) +* 8 bit clean output, specifying: Common options. (line 110) * 8-bit characters: TCX files. (line 6) * \bibliography: bibtex invocation. (line 18) * \bibliographystyle: bibtex invocation. (line 18) @@ -3650,7 +3668,7 @@ Index (line 16) * accented character: TCX files. (line 6) * accents, hyphenating words with: MLTeX. (line 6) -* acknowledgements: Introduction. (line 52) +* acknowledgements: Introduction. (line 54) * acm.bst: Basic BibTeX style files. (line 19) * Ada, WEB for: WEB. (line 12) @@ -3661,22 +3679,22 @@ Index (line 12) * afmtopl: Font utilities available elsewhere. (line 12) -* Aleph: TeX extensions. (line 14) +* Aleph: TeX extensions. (line 15) * aliases for fonts: Path searching. (line 14) * alpha.bst: Basic BibTeX style files. (line 22) -* American Mathematical Society, typesetting system: Formats. (line 39) -* AMSTeX: Formats. (line 39) +* American Mathematical Society, typesetting system: Formats. (line 35) +* AMSTeX: Formats. (line 35) * apalike.bst: Basic BibTeX style files. (line 25) * architecture dependencies: Hardware and memory dumps. (line 6) -* array limit, fixed: Runtime options. (line 35) +* array limit, fixed: Runtime options. (line 45) * array sizes: Runtime options. (line 6) * assembly language routines: Compile-time options. (line 21) * autotrace: Font utilities available elsewhere. - (line 46) + (line 42) * Awk, WEB for: WEB. (line 12) * base file, determining: Determining the memory dump to use. (line 6) @@ -3692,8 +3710,9 @@ Index * batch languages: TeX. (line 9) * BDF and GF conversion: Font utilities available elsewhere. (line 15) -* beginfig: mpost invocation. (line 35) -* Berry, Karl: Introduction. (line 42) +* beamer, package: Formats. (line 57) +* beginfig: mpost invocation. (line 31) +* Berry, Karl: Introduction. (line 43) * BIBINPUTS, search path for bib files: bibtex invocation. (line 18) * bibliographies, creating: BibTeX. (line 6) * bibliography: References. (line 6) @@ -3705,7 +3724,7 @@ Index (line 6) * BigEndian machines: Hardware and memory dumps. (line 6) -* binaries, linking: Common options. (line 77) +* binaries, linking: Common options. (line 82) * blank lines, in TCX files: TCX files. (line 66) * boxes, memory for: Runtime options. (line 20) * braced filename for \input: \input braced filename. @@ -3713,7 +3732,7 @@ Index * breakpoints, memory for: Runtime options. (line 20) * Breitenlohner, Peter: Introduction. (line 9) * BSTINPUTS, search path for bst files: bibtex invocation. (line 18) -* btex for MetaPost labels: mpost invocation. (line 48) +* btex for MetaPost labels: mpost invocation. (line 44) * btxdoc.bib: bibtex invocation. (line 52) * btxdoc.tex: bibtex invocation. (line 46) * btxhak.tex: bibtex invocation. (line 49) @@ -3727,7 +3746,7 @@ Index * change files, and MFT: mft invocation. (line 63) * change files, and Tangle: tangle invocation. (line 11) * change files, and Weave: weave invocation. (line 14) -* changing error messages style: Common options. (line 26) +* changing error messages style: Common options. (line 31) * character codes, in GFtype output: gftype invocation. (line 79) * character codes, in PKtype output: pktype invocation. (line 47) * character codes, in TCX files: TCX files. (line 77) @@ -3755,7 +3774,7 @@ Index * compile-time options: configure options. (line 6) * compile-time options <1>: Compile-time options. (line 6) -* Computer Modern fonts, and Troff: mpost invocation. (line 65) +* Computer Modern fonts, and Troff: mpost invocation. (line 61) * Computer Modern macros: Initial Metafont. (line 26) * Computer Modern Typefaces, production of: mft invocation. (line 73) * configuration: Installation. (line 6) @@ -3764,7 +3783,7 @@ Index * configuration, compile-time: configure options. (line 6) * configure --with/--enable options: configure options. (line 6) * CONTENTS.tex: weave invocation. (line 22) -* control sequence names, space for: Runtime options. (line 29) +* ConTeXt: Formats. (line 28) * conventions for options,: Option conventions. (line 6) * conversion, DVI to plain text: dvitype invocation. (line 6) * conversion, GF to PK: gftopk invocation. (line 6) @@ -3783,13 +3802,13 @@ Index * cross-references, omitting: weave invocation. (line 22) * current directory, used for output: Output file location. (line 6) -* Curtis, Pavel: Introduction. (line 42) +* Curtis, Pavel: Introduction. (line 43) * Cweb: WEB. (line 12) * CWEB: WEB. (line 12) * date and time, in memory dumps: Hardware and memory dumps. (line 30) * debugging DVI utilities: dvitype invocation. (line 52) -* debugging flags, specifying: Common options. (line 59) +* debugging flags, specifying: Common options. (line 64) * decimal character codes, in TCX files: TCX files. (line 77) * dependencies, hardware: Hardware and memory dumps. (line 6) @@ -3803,12 +3822,12 @@ Index * dot files, written by TeX programs: tex invocation. (line 48) * double quote character, ignored in filenames: \input filenames. (line 22) -* downloading of fonts for MetaPost labels: mpost invocation. (line 70) +* downloading of fonts for MetaPost labels: mpost invocation. (line 66) * DrawingServant: Online Metafont graphics. (line 35) -* dump file: Common options. (line 34) +* dump file: Common options. (line 39) * dumping memory: Memory dumps. (line 6) -* DVI comment, specifying: tex invocation. (line 112) +* DVI comment, specifying: tex invocation. (line 113) * DVI files, converting to MPX: dvitomp invocation. (line 6) * DVI files, explained: Font file formats. (line 29) * DVI format definition: DVI utilities. (line 14) @@ -3823,7 +3842,7 @@ Index * dx horizontal escapement: pktype invocation. (line 57) * dx horizontal escapement <1>: gftype invocation. (line 106) * dy vertical escapement: gftype invocation. (line 106) -* dynamic array allocation: Runtime options. (line 35) +* dynamic array allocation: Runtime options. (line 45) * dynamic Metafont mode definitions with smode: Modes. (line 28) * dynamic packing variable: pktype invocation. (line 44) * e response at error prompt: Editor invocation. (line 6) @@ -3841,17 +3860,22 @@ Index * endian dependencies: Hardware and memory dumps. (line 6) * eoc GF command: gftype invocation. (line 97) -* Eplain: Formats. (line 54) +* Eplain: Formats. (line 50) * epsf: Online Metafont graphics. (line 19) +* epTeX: TeX extensions. (line 51) * errors, editor invoked at: Editor invocation. (line 6) * escapement, horizontal: pktype invocation. (line 57) * escapement, horizontal <1>: gftype invocation. (line 106) * escapement, vertical: gftype invocation. (line 106) -* etex for MetaPost labels: mpost invocation. (line 48) +* etex for MetaPost labels: mpost invocation. (line 44) +* etex is pdfTeX: TeX extensions. (line 22) +* eupTeX: TeX extensions. (line 51) * executables, shared initial and virgin: Initial and virgin. (line 6) * exit status, of shell escape: Shell escapes. (line 34) -* expanded plain format: Formats. (line 54) +* expanded plain format: Formats. (line 50) +* expand_depth: Runtime options. (line 24) +* expansion limit, recursive: Runtime options. (line 25) * expansion, and \input filenames: \input filename caveats. (line 6) * extensions to TeX: TeX extensions. (line 6) @@ -3861,10 +3885,10 @@ Index * FAMILY property <1>: tftopl invocation. (line 99) * Ferguson, Michael: MLTeX. (line 6) * file formats for fonts: Font file formats. (line 6) -* file recorder: Common options. (line 84) +* file recorder: Common options. (line 89) * filename conventions, in input files: \input filenames. (line 6) * filenames starting with -: Option conventions. (line 19) -* first line of the main input file: Common options. (line 98) +* first line of the main input file: Common options. (line 103) * fixed-point arithmetic: Compile-time options. (line 21) * FIXPT: Compile-time options. @@ -3883,7 +3907,7 @@ Index * font aliases: Path searching. (line 14) * font character code, translating: TCX files. (line 101) * font design: Metafont. (line 6) -* font downloading for MetaPost labels: mpost invocation. (line 70) +* font downloading for MetaPost labels: mpost invocation. (line 66) * font file formats: Font file formats. (line 6) * font proofs: gftodvi invocation. (line 6) * font utilities: Font utilities. (line 6) @@ -3892,20 +3916,17 @@ Index * fontforge: Font utilities available elsewhere. (line 30) * fontinst, for creating virtual fonts: Font utilities available elsewhere. - (line 53) + (line 49) * fonts, basic: Installation. (line 33) -* fontutils: Font utilities available elsewhere. - (line 42) -* font_mem_size: Runtime options. (line 24) * format files: Initial TeX. (line 13) * formats for TeX: Formats. (line 6) * formats Make target: Additional targets. (line 17) * fraction routines: Compile-time options. (line 21) -* Free Software Foundation documentation system: Formats. (line 47) +* Free Software Foundation documentation system: Formats. (line 43) * freedom of Web2c: Introduction. (line 23) * ftp.math.utah.edu: bibtex invocation. (line 58) -* generating source specials: tex invocation. (line 133) +* generating source specials: tex invocation. (line 134) * geometric designs: Metafont. (line 6) * geometric font scaling: Font file formats. (line 21) * geometry for Metafont: Online Metafont graphics. @@ -3937,16 +3958,13 @@ Index (line 34) * hardware and memory dumps: Hardware and memory dumps. (line 6) -* hash table, increasing size of: Runtime options. (line 29) -* hash_extra: Runtime options. (line 28) * headerbyte information: tftopl invocation. (line 95) * height, in pixels: pktype invocation. (line 62) * help, online: Common options. (line 11) -* Henry, Patrick: Introduction. (line 23) * Herberts, Mathias: Online Metafont graphics. (line 20) * hex character codes, in TCX files: TCX files. (line 77) -* history: Introduction. (line 42) +* history: Introduction. (line 43) * Hobby, John: Introduction. (line 9) * horizontal escapement: pktype invocation. (line 57) * horizontal escapement <1>: gftype invocation. (line 106) @@ -3959,7 +3977,7 @@ Index * human-readable text, converting PK to: pktype invocation. (line 6) * human-readable text, converting TFM to: tftopl invocation. (line 6) * human-readable text, converting VF to: vftovp invocation. (line 6) -* hypertext: TeX extensions. (line 20) +* hypertext: TeX extensions. (line 22) * hyphenation and languages: Languages and hyphenation. (line 6) * hyphenation patterns, creating: patgen invocation. (line 6) @@ -3972,8 +3990,8 @@ Index (line 31) * il1-t1.tcx: TCX files. (line 48) * il2-t1.tcx: TCX files. (line 48) -* Info format: Formats. (line 47) -* initial form, enabling: Common options. (line 45) +* Info format: Formats. (line 43) +* initial form, enabling: Common options. (line 50) * initial Metafont: Initial Metafont. (line 6) * initial MetaPost: Initial MetaPost. (line 6) * initial programs: Initial and virgin. (line 19) @@ -3986,44 +4004,46 @@ Index * install-mems Make target: Additional targets. (line 34) * installation: Installation. (line 6) * interaction between TCX files and -8bit.: TCX files. (line 104) -* interaction mode: Common options. (line 50) +* interaction mode: Common options. (line 55) * international characters: TCX files. (line 6) * introduction: Introduction. (line 6) * IPC: IPC and TeX. (line 6) * IPC_DEBUG: Compile-time options. (line 28) * IPC_DEBUG <1>: IPC and TeX. (line 13) -* job name: Common options. (line 55) +* job name: Common options. (line 60) * kerning table, in TFM files: tftopl invocation. (line 101) * keyboard character code, translating: TCX files. (line 101) * Knuth, Donald E.: Introduction. (line 9) * Knuth, Donald E. <1>: mft invocation. (line 56) -* KPATHSEA_DEBUG: Common options. (line 59) +* KPATHSEA_DEBUG: Common options. (line 64) * KRN property: tftopl invocation. (line 101) * label font: gftodvi invocation. (line 36) * LABEL property: tftopl invocation. (line 101) * language support in TeX: Languages and hyphenation. (line 6) * languages, hyphenation rules for: patgen invocation. (line 6) -* LaTeX: Formats. (line 22) +* LaTeX: Formats. (line 18) * Latin Modern: Font utilities available elsewhere. (line 18) * left side bearing: pktype invocation. (line 66) * left side bearing <1>: gftype invocation. (line 82) * legalisms: Legalisms. (line 6) +* libsigsegv library: Runtime options. (line 33) * licensing terms: Introduction. (line 23) * LIG property: tftopl invocation. (line 101) * ligature table, in TFM files: tftopl invocation. (line 101) * LIGTABLE property: tftopl invocation. (line 101) -* linking binaries: Common options. (line 77) +* linking binaries: Common options. (line 82) * links to binaries: Determining the memory dump to use. (line 30) * literate programming: WEB. (line 6) * LittleEndian machines: Hardware and memory dumps. (line 6) +* location of texmf.cnf in TeX Live: Runtime options. (line 56) * log file, BibTeX: bibtex invocation. (line 14) -* Lua: TeX extensions. (line 26) -* luaTeX: TeX extensions. (line 26) +* Lua: TeX extensions. (line 30) +* LuaTeX: TeX extensions. (line 30) * machine dependencies: Hardware and memory dumps. (line 6) * machine-readable, converting property lists to: pltotf invocation. @@ -4038,8 +4058,8 @@ Index * magnification <1>: dvitype invocation. (line 28) * main_memory: Runtime options. (line 15) * Make targets, additional: Additional targets. (line 6) -* Martin, Rick: Introduction. (line 52) -* Mathematical Reviews: Formats. (line 39) +* Martin, Rick: Introduction. (line 54) +* Mathematical Reviews: Formats. (line 35) * mathematical typesetting: TeX. (line 6) * mem file, determining: Determining the memory dump to use. (line 6) @@ -4074,7 +4094,7 @@ Index * MetaPost: MetaPost. (line 6) * MetaPost and plain Metafont compatibility: Initial MetaPost. (line 15) -* MetaPost input files: mpost invocation. (line 30) +* MetaPost input files: mpost invocation. (line 26) * MetaPost invocation: mpost invocation. (line 6) * MetaPost source, prettyprinting: mft invocation. (line 79) * MetaPost, initial: Initial MetaPost. (line 6) @@ -4092,25 +4112,26 @@ Index * MFTERM: Online Metafont graphics. (line 11) * mftmac.tex: mft invocation. (line 6) -* micro-typography: TeX extensions. (line 20) +* micro-typography: TeX extensions. (line 22) * mktexmf, disabling: mf invocation. (line 24) * mktextfM, disabling: tex invocation. (line 41) * mltex: MLTeX. (line 6) -* MLTeX, enabling: tex invocation. (line 107) +* MLTeX, enabling: tex invocation. (line 108) * mode needed to run Metafont: mf invocation. (line 48) * modes file needed for Metafont: Modes. (line 6) * modes.mf recommended modes file: Modes. (line 10) * mode_def: Modes. (line 15) * mode_setup: Modes. (line 15) -* Morgan, Tim: Introduction. (line 42) -* Morris, Bob: Introduction. (line 52) +* modifying texmf.cnf in TeX Live: Runtime options. (line 56) +* Morgan, Tim: Introduction. (line 43) +* Morris, Bob: Introduction. (line 54) * MPEDIT: Editor invocation. (line 10) -* mpgraph.ps: mpost invocation. (line 18) -* mpman.ps: mpost invocation. (line 6) +* mpgraph.pdf: mpost invocation. (line 14) +* mpman.pdf: mpost invocation. (line 6) * mpost: mpost invocation. (line 6) * mpost, reason for name change: Installation. (line 19) -* mpout: mpost invocation. (line 35) -* mproof.tex: mpost invocation. (line 70) +* mpout: mpost invocation. (line 31) +* mproof.tex: mpost invocation. (line 66) * mptrap Make target: Additional targets. (line 41) * mptrap test: Triptrap. (line 6) * mptrap.readme: Triptrap. (line 6) @@ -4133,31 +4154,34 @@ Index (line 12) * octal character codes, in TCX files: TCX files. (line 77) * offset for overflow labels: gftodvi invocation. (line 59) +* Omega: TeX extensions. (line 15) * online Metafont graphics: Online Metafont graphics. (line 6) * opcodes, showing DVI: dvitype invocation. (line 52) +* OpenType support: TeX extensions. (line 30) * optical font scaling: Font file formats. (line 21) * option conventions: Option conventions. (line 6) * origin: pktype invocation. (line 66) -* output directory, specifying: Common options. (line 66) +* output directory, specifying: Common options. (line 71) * output directory, specifying <1>: Output file location. (line 15) * output file location: Output file location. (line 6) * output files, written by TeX programs: tex invocation. (line 48) -* output_comment for DVI files: tex invocation. (line 112) +* output_comment for DVI files: tex invocation. (line 113) * overflow label offset: gftodvi invocation. (line 59) +* overflow, of runtime stack: Runtime options. (line 25) * packet length: pktype invocation. (line 50) * page, starting: dvicopy invocation. (line 28) * page, starting <1>: dvitype invocation. (line 46) -* parsing the first line: Common options. (line 72) +* parsing the first line: Common options. (line 77) * Pascal, creating from WEB: tangle invocation. (line 6) * patgen: patgen invocation. (line 6) * path searching: Path searching. (line 6) -* path searching debugging: Common options. (line 59) -* PDF: TeX extensions. (line 20) -* PDF, and .mps files: mpost invocation. (line 86) -* pdfTeX: TeX extensions. (line 20) +* path searching debugging: Common options. (line 64) +* PDF: TeX extensions. (line 22) +* PDF, and .mps files: mpost invocation. (line 82) +* pdfTeX: TeX extensions. (line 22) * permissions, legal: Legalisms. (line 6) * PFA and PFB conversion: Font utilities available elsewhere. (line 39) @@ -4196,16 +4220,16 @@ Index (line 50) * pooltype: pooltype invocation. (line 6) * portable filenames: \input filenames. (line 25) -* PostScript fonts, and Troff: mpost invocation. (line 65) +* PostScript fonts, and Troff: mpost invocation. (line 61) * PostScript meets Metafont: MetaPost. (line 6) -* PostScript output: mpost invocation. (line 35) +* PostScript output: mpost invocation. (line 31) * PostScript to PK bitmaps: Font utilities available elsewhere. (line 35) * PostScript Type 1 font conversion: Font utilities available elsewhere. (line 39) * PostScript, and font scaling: Font file formats. (line 21) * potrace: Font utilities available elsewhere. - (line 46) + (line 42) * predefined macros and memory dumps: Memory dumps. (line 6) * prettyprinting Metafont source: mft invocation. (line 6) * prettyprinting WEB programs: weave invocation. (line 6) @@ -4215,11 +4239,11 @@ Index * production use: Initial and virgin. (line 15) * program name, determines memory dump: Determining the memory dump to use. (line 30) -* program names, special: Common options. (line 45) -* program names, special <1>: Common options. (line 77) -* program names, special <2>: tex invocation. (line 107) -* prologues: mpost invocation. (line 115) -* prologues, and EPSF output: mpost invocation. (line 80) +* program names, special: Common options. (line 50) +* program names, special <1>: Common options. (line 82) +* program names, special <2>: tex invocation. (line 108) +* prologues: mpost invocation. (line 111) +* prologues, and EPSF output: mpost invocation. (line 76) * proof mode: mf invocation. (line 48) * proof sheets, of fonts: gftodvi invocation. (line 6) * property list format: tftopl invocation. (line 43) @@ -4227,19 +4251,21 @@ Index * property list, converting VF to virtual: vftovp invocation. (line 6) * ps2pk: Font utilities available elsewhere. (line 35) -* psfonts.map, read by MetaPost: mpost invocation. (line 80) +* psfonts.map, read by MetaPost: mpost invocation. (line 76) +* pTeX: TeX extensions. (line 44) * PXL files, explained: Font file formats. (line 39) * pxtoch: Font utilities available elsewhere. (line 23) * quoted filename for \input: \input quoted filename. (line 6) * Raichle, Bernd: MLTeX. (line 6) -* reading, additional: Introduction. (line 60) +* reading, additional: Introduction. (line 62) * readonly directory, running TeX in: Output file location. (line 15) * readonly directory, running TeX in <1>: Output file location. (line 19) -* reallocation of arrays: Runtime options. (line 35) +* reallocation of arrays: Runtime options. (line 45) +* recursive expansion limit: Runtime options. (line 25) * redefined character substitutions: \tracingcharsubdef. (line 6) * reference pixel: pktype invocation. (line 66) * references: References. (line 6) @@ -4247,25 +4273,25 @@ Index (line 39) * Regis graphics support: Online Metafont graphics. (line 40) -* regression testing: tex invocation. (line 112) +* regression testing: tex invocation. (line 113) * repeated rows: pktype invocation. (line 76) * representation of strings: pooltype invocation. (line 30) * restricted shell escapes: Shell escapes. (line 6) * right side bearing: pktype invocation. (line 66) * right side bearing <1>: gftype invocation. (line 82) -* Rokicki, Tomas: Introduction. (line 42) +* Rokicki, Tomas: Introduction. (line 43) * run length encoded bitmaps: pktype invocation. (line 76) * run length encoded bitmaps <1>: gftype invocation. (line 89) * runtime options: Runtime options. (line 6) +* runtime stack overflow: Runtime options. (line 25) * scaled pixels: pktype invocation. (line 57) * scaled pixels <1>: gftype invocation. (line 106) * scaling of fonts: Font file formats. (line 21) -* scanned images of fonts: Font utilities available elsewhere. - (line 42) * security, and output files: tex invocation. (line 48) * security, and shell escapes: Shell escapes. (line 6) -* security, and write: mpost invocation. (line 92) +* security, and write: mpost invocation. (line 88) * security, and \openout: tex invocation. (line 48) +* segmentation fault: Runtime options. (line 25) * shapes: Metafont. (line 6) * sharing memory dumps: Hardware and memory dumps. (line 6) @@ -4276,20 +4302,21 @@ Index (line 35) * side bearings: pktype invocation. (line 66) * side bearings <1>: gftype invocation. (line 82) +* SIGSEGV: Runtime options. (line 25) * slant font: gftodvi invocation. (line 39) -* slides, producing: Formats. (line 61) -* SliTeX: Formats. (line 61) +* slides, producing: Formats. (line 57) +* SliTeX: Formats. (line 57) * small Metafont memory and modes: Modes. (line 15) * smode and dynamic Metafont mode definition: Modes. (line 28) * sockets: IPC and TeX. (line 6) * space-terminated filenames: \input filenames. (line 10) * Spiderweb: WEB. (line 12) -* Stallman, Richard: Introduction. (line 52) +* Stallman, Richard: Introduction. (line 54) * starting page: dvicopy invocation. (line 28) * starting page <1>: dvitype invocation. (line 46) * Steele Jr., Guy L.: Hardware and memory dumps. (line 34) -* stopping at the first error: Common options. (line 41) +* stopping at the first error: Common options. (line 46) * strategy, overall: Introduction. (line 17) * string numbers, displaying: pooltype invocation. (line 6) * string pool, writing: tangle invocation. (line 16) @@ -4305,12 +4332,13 @@ Index (line 43) * SunView: Online Metafont graphics. (line 43) -* swap space, as array limit: Runtime options. (line 35) +* swap space, as array limit: Runtime options. (line 45) * swapping bytes: Hardware and memory dumps. (line 13) * syntax of TCX files: TCX files. (line 65) * system C library function: Shell escapes. (line 6) * system command: Shell escapes. (line 6) +* system fonts, using: TeX extensions. (line 30) * T1 encoding and ISO input: TCX files. (line 48) * tabs, and \input filenames: \input filename caveats. (line 6) @@ -4318,6 +4346,7 @@ Index * tangle: tangle invocation. (line 6) * targets, additional Make: Additional targets. (line 6) * TCX character translation files: TCX files. (line 6) +* technical illustrations, creating: MetaPost. (line 6) * tek: Online Metafont graphics. (line 47) * Tektronix: Online Metafont graphics. @@ -4344,20 +4373,23 @@ Index * TEXBIB, search path for bib files: bibtex invocation. (line 18) * TEXEDIT: Editor invocation. (line 10) * texfonts.map: Path searching. (line 14) -* Texinfo: Formats. (line 47) +* Texinfo: Formats. (line 43) * texmf.cnf: Path searching. (line 6) +* texmf.cnf <1>: Runtime options. (line 6) +* texmf.cnf for editors: Editor invocation. (line 10) +* texmf.cnf for shell escapes: Shell escapes. (line 6) * texmfmp.c: Online Metafont graphics. (line 79) * TEXMFOUTPUT, used for reading: Output file location. (line 25) * TEXMFOUTPUT, used if . unwritable: Output file location. (line 19) +* texmf_casefold_search: Runtime options. (line 42) * texput: tex invocation. (line 33) * TFM files, converting property lists to: pltotf invocation. (line 6) * TFM files, explained: Font file formats. (line 12) -* TFM files, memory for: Runtime options. (line 25) * TFM files, output by Metafont: mf invocation. (line 43) -* TFM files, output by MetaPost: mpost invocation. (line 35) +* TFM files, output by MetaPost: mpost invocation. (line 31) * TFM width of characters: pktype invocation. (line 53) * TFM width of characters <1>: gftype invocation. (line 112) * tftopl: tftopl invocation. (line 6) @@ -4370,19 +4402,21 @@ Index * toolkits, X: Online Metafont graphics. (line 59) * torture tests: Triptrap. (line 6) -* translation file for TeX, specifying: Common options. (line 98) +* translation file for TeX, specifying: Common options. (line 103) * translation from WEB to C: Introduction. (line 17) * trap Make target: Additional targets. (line 41) * trap test: Triptrap. (line 6) * trapman.tex: Triptrap. (line 6) -* Trickey, Howard: Introduction. (line 42) +* Trickey, Howard: Introduction. (line 43) * trip Make target: Additional targets. (line 41) * trip test: Triptrap. (line 6) * tripman.tex: Triptrap. (line 6) * triptrap Make target: Additional targets. (line 41) -* Troff, and MetaPost: mpost invocation. (line 65) +* Troff, and MetaPost: mpost invocation. (line 61) +* troff, supported in MetaPost: MetaPost. (line 12) * Troff, WEB for: WEB. (line 12) * Trojan horses and TeX programs: tex invocation. (line 48) +* TrueType support: TeX extensions. (line 30) * TUGboat bibliography: bibtex invocation. (line 58) * Type 1 conversion: Font utilities available elsewhere. (line 39) @@ -4392,17 +4426,17 @@ Index * type programs, PK: pktype invocation. (line 6) * type programs, pool: pooltype invocation. (line 6) * typeface families: Metafont. (line 6) -* typeface specimen sheets: Font utilities available elsewhere. - (line 42) * typesetting: TeX. (line 6) -* Unicode: TeX extensions. (line 14) -* Unicode <1>: TeX extensions. (line 31) +* Unicode: TeX extensions. (line 15) * Unicode input: tex invocation. (line 86) +* Unicode input, native: TeX extensions. (line 37) * uniterm: Online Metafont graphics. (line 50) * unsrt.bst: Basic BibTeX style files. (line 39) +* upTeX: TeX extensions. (line 44) * UTF-8 input: tex invocation. (line 86) +* UTF-8 input, native: TeX extensions. (line 30) * validation, of DVI files: dvitype invocation. (line 6) * validation, of GF files: gftype invocation. (line 6) * validation, of PK files: pktype invocation. (line 6) @@ -4416,7 +4450,7 @@ Index * vftovp: vftovp invocation. (line 6) * virgin programs: Initial and virgin. (line 15) * virtual font creation: Font utilities available elsewhere. - (line 53) + (line 49) * virtual fonts, expanding: dvicopy invocation. (line 6) * virtual-fonts.knuth: Font file formats. (line 56) * virtualfonts.txt: Font file formats. (line 56) @@ -4428,7 +4462,7 @@ Index * WEB programs, compiling: tangle invocation. (line 6) * WEB programs, typesetting: weave invocation. (line 6) * WEB2C, search path for TCX files: TCX files. (line 35) -* Weber, Olaf: Introduction. (line 42) +* Weber, Olaf: Introduction. (line 43) * webmac.tex: weave invocation. (line 22) * webman.tex: WEB. (line 12) * whitespace, in TCX files: TCX files. (line 68) @@ -4451,7 +4485,7 @@ Index * xampl.bib: bibtex invocation. (line 55) * xbfe, bitmap font editor: Font utilities available elsewhere. (line 23) -* XeTeX: TeX extensions. (line 31) +* XeTeX: TeX extensions. (line 37) * xfed, bitmap font editor: Font utilities available elsewhere. (line 23) * xfedor, bitmap font editor: Font utilities available elsewhere. @@ -4471,79 +4505,79 @@ Index  Tag Table: -Node: Top2765 -Node: Introduction3760 -Node: Installation6918 -Node: configure options9020 -Node: Compile-time options11042 -Node: Additional targets12144 -Node: Triptrap13421 -Node: Runtime options14948 -Node: Commonalities16706 -Node: Option conventions17307 -Node: Common options18530 -Node: Path searching22910 -Node: Output file location23882 -Node: Three programs25207 -Node: Initial and virgin25973 -Node: Memory dumps26902 -Node: Creating memory dumps27358 -Node: Determining the memory dump to use28569 -Node: Hardware and memory dumps30150 -Node: Editor invocation32600 -Node: \input filenames33467 -Node: \input quoted filename35012 -Node: \input braced filename35793 -Node: \input filename caveats36727 -Node: TeX38245 -Node: tex invocation39396 -Node: Initial TeX46299 -Node: Formats47663 -Node: Languages and hyphenation50589 -Node: MLTeX51019 -Node: \charsubdef52507 -Node: \tracingcharsubdef54830 -Node: TCX files55405 -Node: patgen invocation60845 -Node: Shell escapes61551 -Node: IPC and TeX65131 -Node: TeX extensions65701 -Node: Metafont66832 -Node: mf invocation68120 -Node: Initial Metafont71957 -Node: Modes73587 -Node: Online Metafont graphics75837 -Node: gftodvi invocation79262 -Node: mft invocation82082 -Node: MetaPost86080 -Node: mpost invocation86842 -Node: Initial MetaPost92018 -Node: dvitomp invocation92940 -Node: BibTeX93605 -Node: bibtex invocation93966 -Node: Basic BibTeX style files96440 -Node: WEB97770 -Node: tangle invocation98979 -Node: weave invocation101102 -Node: pooltype invocation102509 -Node: DVI utilities103639 -Node: dvicopy invocation104571 -Node: dvitype invocation105854 -Node: dvitype output example108183 -Node: Font utilities111234 -Node: Font file formats112414 -Node: gftopk invocation115683 -Node: pktogf invocation116874 -Node: pktype invocation118040 -Node: gftype invocation120863 -Node: tftopl invocation125366 -Node: pltotf invocation129959 -Node: vftovp invocation131010 -Node: vptovf invocation133245 -Node: Font utilities available elsewhere134272 -Node: Legalisms136652 -Node: References138806 -Node: Index143373 +Node: Top2759 +Node: Introduction3834 +Node: Installation7174 +Node: configure options9218 +Node: Compile-time options11240 +Node: Additional targets12342 +Node: Triptrap13619 +Node: Commonalities15122 +Node: Option conventions15655 +Node: Common options16878 +Node: Path searching21496 +Node: Output file location22468 +Node: Three programs23770 +Node: Runtime options24477 +Node: Initial and virgin27618 +Node: Memory dumps28567 +Node: Creating memory dumps29019 +Node: Determining the memory dump to use30226 +Node: Hardware and memory dumps31803 +Node: Editor invocation34249 +Node: \input filenames35112 +Node: \input quoted filename36665 +Node: \input braced filename37442 +Node: \input filename caveats38372 +Node: TeX39886 +Node: tex invocation41054 +Node: Initial TeX48039 +Node: Formats49403 +Node: Languages and hyphenation52220 +Node: MLTeX52650 +Node: \charsubdef54278 +Node: \tracingcharsubdef56601 +Node: TCX files57176 +Node: patgen invocation62616 +Node: Shell escapes63322 +Node: IPC and TeX66902 +Node: TeX extensions67472 +Node: Metafont69501 +Node: mf invocation70789 +Node: Initial Metafont74626 +Node: Modes76256 +Node: Online Metafont graphics78506 +Node: gftodvi invocation81931 +Node: mft invocation84751 +Node: MetaPost88749 +Node: mpost invocation89585 +Node: Initial MetaPost94619 +Node: dvitomp invocation95541 +Node: BibTeX96206 +Node: bibtex invocation96567 +Node: Basic BibTeX style files99041 +Node: WEB100371 +Node: tangle invocation101580 +Node: weave invocation103703 +Node: pooltype invocation105110 +Node: DVI utilities106240 +Node: dvicopy invocation107174 +Node: dvitype invocation108459 +Node: dvitype output example110790 +Node: Font utilities113843 +Node: Font file formats115023 +Node: gftopk invocation118292 +Node: pktogf invocation119483 +Node: pktype invocation120649 +Node: gftype invocation123472 +Node: tftopl invocation127975 +Node: pltotf invocation132568 +Node: vftovp invocation133619 +Node: vptovf invocation135854 +Node: Font utilities available elsewhere136881 +Node: Legalisms139086 +Node: References140532 +Node: Index144665  End Tag Table diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.html b/Master/texmf-dist/doc/kpathsea/kpathsea.html index 701b7141afb..883cc129293 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.html +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.html @@ -2,7 +2,7 @@ -Building TeX Live (2020) +Building TeX Live (2021) - - + + @@ -57,7 +57,7 @@ ul.no-bullet {list-style: none} -

Building TeX Live (2020)

+

Building TeX Live (2021)

@@ -182,7 +182,6 @@ ul.no-bullet {list-style: none}
  • 7.3 Library-specific configure options
  • 7.4 Variables for configure
  • @@ -292,7 +291,7 @@ ul.no-bullet {list-style: none}

    Next: , Up: (dir)   [Contents][Index]

    -

    Building TeX Live (2020)

    +

    Building TeX Live (2021)

    For an overview of this manual, see Introduction.

    @@ -333,8 +332,8 @@ Next:

    Build one package. +library ICU; the program dvisvgm also requires C++11. It is +possible to build everything else with older compilers, but you have +to remove the C++11-dependent sources. See Build one package.

    A few programs in the tree have additional requirements:

    @@ -711,7 +710,7 @@ library, first building any required libraries.

    Here is an example from start to finish for working on dvipdfm-x. (Unfortunately, this does not suffice for building -one, or a subset, of the TeX engines; see the next section.) +the TeX engines; see the next section.)

    mkdir mydir && cd mydir  # new working directory
    @@ -773,7 +772,7 @@ source directories; specifying --disable for them does not
     suffice, unfortunately.  Specifically, before running configure:
     

    -
    rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm
    +
    rm -rf libs/icu libs/graphite2 texk/dvisvgm
     
    @@ -811,23 +810,34 @@ not suffice: wanting to build one, or a subset, of the TeX engines (or other Web2c programs).

    The simplest way to do this is to disable everything and then -explicitly specify what to make. For example, to build only LuaTeX: +explicitly specify what to make. For example, to build only the +original TeX:

    -
    ./configure --disable-all-pkgs  # or ./Build
    -cd Work/texk/web2c              # build directory
    -make luatex                     # specify target
    +
    cd Work        # top build directory
    +../configure --without-x --disable-shared --disable-all-pkgs \
    +             --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g
    +make
    +cd texk/web2c  # cd engine build directory
    +make tex       # must specify target
     
    -

    This works because the make automatically runs configure -as necessary for the dependencies and target. Furthermore, the source -tree can be cut down to just what is needed for the given engine -(the separate pdfTeX and LuaTeX source repositories do this, if -you want to peruse examples). +

    The first make run will configure everything, and even build +the libraries, even though the packages are disabled. +The source tree can be cut down to just what is needed for the given +engine (the separate pdfTeX and LuaTeX source repositories do +this, for example), but see caveats in previous section.

    -

    We hope to improve the situation in the future. Patches are welcome. +

    If you want to debug an X-related program or shared library setup, or +other variants, change the configure options +accordingly. Either ../Build or ../configure can be run. +

    +

    Then it is necessary to again specify the target engine (tex, +in the above) in the make. +

    +

    All this is somewhat unfortunate. We hope to improve the situation in +the future. Patches are welcome.

    -

    @@ -990,6 +1000,7 @@ and tie.

    Building xindy requires running the host system clisp binary, thus cross compilation is painful, but possible.

    +

    @@ -1278,8 +1289,8 @@ may be.

    autoconf (GNU Autoconf) 2.69
    -automake (GNU automake) 1.16.1
    -bison (GNU Bison) 3.5.2
    +automake (GNU automake) 1.16.2
    +bison (GNU Bison) 3.7.4
     flex 2.6.0
     ltmain.sh (GNU libtool) 2.4.6
     m4 (GNU M4) 1.4.18
    @@ -2069,6 +2080,7 @@ the top level, they should be defined in an additional fragment
     ac/prog.ac included from ac/withenable.ac and
     configure.ac.
     

    +

    Usually, the new program is maintained somewhere outside of TeX Live. In that case, as above, we put the upstream sources into a subdirectory prog-src (e.g., utils/newprog/newprog-src). We do @@ -2076,53 +2088,104 @@ not typically run configure in this original ...-src directory, but only in our own directory; but we do compile using the source files in ...-src.

    -

    So, to summarize the files that we must (usually) create: +

    So, to summarize the files that must (usually) be created inside a new +TL source directory (texk/newprog or utils/newprog):

    -
    ac/withenable.ac
    +
    ac/withenable.ac + +

    The KPSE_ENABLE_PROG call just explained.

    -
    configure.ac
    -
    Makefile.am
    +
    configure.ac + +
    +
    Makefile.am + +

    By merging the contents of the original configure.ac (if -provided) and a comparable program already in TL. There is no magic -recipe, it’s necessary to think about needs to be done in the original -vs. in TeX Live. +provided) and a comparable program already in TL. In the above +example, one line that will be needed in configure.ac (can be +added before the AC_CONFIG_FILES at the end) is: +

    +
    +
    AC_SUBST([NEWPROG_TREE], [newprog-src])
    +
    + +

    and then use @NEWPROG_TREE@ in +Makefile.am where needed. +

    +

    In general, there is no magic recipe for this part of the job. It’s +necessary to think about what needs to be done in the original vs. +in TeX Live. It’s useful to look at the setup for the most comparable +programs already in TL that you can find. It’s also useful to grep the +entire Build/source tree for whatever you can think of to +investigate how something is done. Most of the TL-specific macros are +defined in Build/source/m4/*.

    -
    TLpatches/TL-Changes
    -

    Actions taken after getting the original source tree; typically +

    TLpatches/TL-Changes + +
    +

    First actions taken after getting the original source tree; typically removal of derived or unused common files.

    -
    TLpatches/patch-...
    +
    TLpatches/patch-... + +

    If any changes are needed to the original sources, record the patches -here so they can be applied next time. And send them upstream so that -perhaps they won’t have to be. +here so they can be applied next time. Also, send them upstream so +that we don’t have to maintain them forever.

    -
    ChangeLog
    +
    ChangeLog + +

    Record all TL-specific changes, now and in the future.

    -

    Then, run GNU autoreconf in the new directory (see Build system tools). After that works, svn add the necessary files, + +

    After populating the new TL source directory (.../newprog/, in +the 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 not have to run any autotools, but can simply run configure.)

    +

    To reiterate: do not fail to commit the generated configure and +other files. The m4 code in kpse-pkgs.m4 uses the existence of +configure to determine whether to descend into (and configure) +a given subdirectory. +

    +

    Then, run the TL tool reautoconf in the top-level TL -source/ directory, to incorporate the new program into the -build tree. +Build/source/ directory, to incorporate the new program into +the build tree. It is good to then rebuild the whole tree (e.g., using +TL’s Build/Build script) to get all the necessary files generated. +

    +

    It will probably fail. So then you need to keep at it until the +program compiles and tests successfully. The most efficient way is to +rerun autoreconf as needed in the new source directory +(Build/source/.../newprog), then make in the +corresponding build directory (Build/work/.../newprog), then +make check, etc. In the end, also make sure that the whole tree +builds from scratch.

    -

    Then, run (and rerun) a build until the program compiles and tests -successfully, probably involving rerunning autoreconf in the source -directory, make in the build directory, etc. +

    After final success, don’t forget to commit. (Or email the TL +maintainers with the patch.)

    -

    After final success, don’t forget to commit. + +

    Caveat: adding a new TeX engine is not completely different, but +it’s not all that similar, either. In that case, the work is done +inside a new subdirectory of texk/web2c/. Many things are +common to all the engines, other things need to be copied and possibly +modified for each one, yet others are unique to each. No general +recipe is possible.


    @@ -2357,10 +2420,7 @@ to the file format specifications.

    With LFS, there is no fixed limit on the size of PDF files created by -pdftex or PostScript files created by dvips. The size -of PDF images included by pdftex or luatex must, however, -be <2GB when using poppler version 0.22 or before -(even on 64-bit systems with LFS). +pdftex or PostScript files created by dvips.


    @@ -2843,15 +2903,12 @@ required system libraries and bails out if tests fail.
    - -

    7.3.1 Configure options for kpathsea

    @@ -2889,32 +2946,6 @@ The default can be overridden by the user in any case (see kpathsea library).


    - -

    7.3.2 Configure options for system poppler

    - - - - - -

    Building XeTeX requires poppler, either from the TL tree or -system headers and library. Building pdfTeX requires either -xpdf from the TeX Live tree or system poppler headers and -library. -

    - -

    --with-system-poppler
    Use a system version (0.18 or -newer) of poppler for LuaTeX (or LuaJITTeX) and XeTeX, -and use pkg-config to obtain the required flags. -

    - -

    --with-system-xpdf
    Use a system version (0.12 or newer) -of poppler (and pkg-config) for pdfTeX instead of -xpdf from the TL tree. See --disable-largefile. -

    -

    Previous: , Up: Configure options   [Contents][Index]

    @@ -3405,47 +3436,25 @@ following modules are supported:
    text
    -

    The text mode user interface (default on Unix systems). Same as the --no-gui option. +

    The text mode user interface (default on Unix systems, including Macs). +Same as the -no-gui option.

    -
    tcl
    -
    -

    The Tcl/Tk user interface (default on Macs and Windows). It starts +

    tcl (or "perltk" or "wizard" or "expert" or nothing)
    +
    +

    The Tcl/Tk user interface (default on Windows). It starts with a small number of configuration options, roughly equivalent -to what the wizard option below offers, but a button Advanced -takes you to a screen with roughly the same options as the perltk -interface. -

    -
    -
    wizard
    -
    -

    The wizard mode user interface, asking only minimal questions before -installing all of TeX Live. -

    -
    -
    expert
    -
    -

    A generic name for, currently, perltk; it may select a different GUI -in the future. -

    -
    -
    perltk
    -
    -

    The expert GUI installer, providing access to more options. +to what the former wizard option offers, but a button Advanced +takes you to a screen with roughly the same options as the former +perltk interface.

    -

    The perltk and wizard modules require the Perl/Tk module -(https://tug.org/texlive/distro.html#perltk). if Perl/Tk is not -available, installation continues in text mode, except on Windows, -where all gui options except text are diverted to the default -tcl GUI. -

    -

    The tcl GUI requires Tcl/Tk. This is standard on Macs and is often -already installed on GNU/Linux. For Windows, TeX Live provides a Tcl/Tk -runtime. +

    The default GUI requires Tcl/Tk. This is standard on Macs (although it +is considered deprecated since Catalina) and is often already installed +on GNU/Linux, or can be easily installed through a distro package +manager. For Windows, TeX Live provides a Tcl/Tk runtime.

    -no-gui
    @@ -3455,10 +3464,8 @@ runtime.
    -lang llcode
    -

    By default, the GUI tries to deduce your language from the -environment. The Tcl GUI uses the language detection built into -Tcl/Tk; the Perl/Tk GUIs use the LC_MESSAGES environment -variable. If that fails you can select a different language by +

    By default, the Tcl GUI uses the language detection built into +Tcl/Tk. If that fails you can select a different language by giving this option with a language code (based on ISO 639-1). Currently supported (but not necessarily completely translated) are: English (en, default), Czech (cs), German (de), French (fr), Italian @@ -3490,8 +3497,8 @@ will be adjusted accordingly.

    -select-repository

    This option allows you to choose a particular mirror from the current -list of active CTAN mirrors. This option is supported in the text, -wizard and perltk installer modes, and will also offer to install +list of active CTAN mirrors. This option is supported in the text +and gui installer modes, and will also offer to install from local media if available, or from a repository specified on the command line. It’s useful when the (default) automatic redirection does not choose a good host for you. @@ -3524,9 +3531,10 @@ building TeX Live, see https://tug.

    -debug-translation
    -

    In the Perl/Tk GUI modes, this option reports any missing, or more -likely untranslated, messages to standard error. Helpful for -translators to see what remains to be done. +

    In the former Perl/Tk GUI modes, this option reported any missing, +or more likely untranslated, messages to standard error. Not yet +implemented for the Tcl interface. Helpful for translators to see +what remains to be done.

    -force-platform platform
    @@ -3843,8 +3851,8 @@ variables.

    Omit creating the ConTeXt cache. This is useful for redistributors.

    -
    TEXLIVE_INSTALL_NO_IMPORT
    -
    +
    TEXLIVE_INSTALL_NO_RESUME
    +

    Omit check for installing on top of a previous installation and then asking about importing previous settings.

    @@ -3855,6 +3863,12 @@ asking about importing previous settings. when testing.

    +
    TEXLIVE_INSTALL_PAPER
    +
    +

    Set the default paper size for all relevant programs; must be either +letter or a4. The default is a4. +

    +
    TEXLIVE_INSTALL_PREFIX
    @@ -3903,7 +3917,7 @@ Previous:
    https://tug.org/texlive) and both are licensed under the GNU General Public License Version 2 or later.

    -

    $Id: install-tl 54143 2020-03-06 23:51:18Z karl $ +

    $Id: install-tl 57970 2021-02-27 14:17:34Z siepo $


    @@ -4180,6 +4194,14 @@ Japanese (ja), Dutch (nl), Polish (pl)tlshell shares its message catalog with tlmgr.

    +
    –command-logfile file
    +
    +

    tlmgr logs the output of all programs invoked (mktexlr, mtxrun, fmtutil, +updmap) to a separate log file, by default +TEXMFSYSVAR/web2c/tlmgr-commands.log. This option allows you to specify a +different file for the log. +

    +
    –debug-translation

    In GUI mode, this switch tells tlmgr to report any untranslated (or @@ -4828,21 +4850,36 @@ is available in a remote repository using

    –data item1,item2,...

    If the option --data is given, its argument must be a comma separated -list of field names from: name, category, localrev, remoterev, -shortdesc, longdesc, installed, size, relocatable, depends, -cat-version, cat-date, or cat-license. In this case the requested -packages’ information is listed in CSV format one package per line, and the -column information is given by the itemN. The depends column contains -the name of all dependencies separated by :. +list of field names from: name, category, localrev, +remoterev, shortdesc, longdesc, installed, size, +relocatable, depends, cat-version, cat-date, cat-license, +plus various cat-contact-* fields (see below). +

    +

    The cat-* fields all come from the TeX Catalogue +(https://ctan.org/pkg/catalogue). For each, there are two more +variants with prefix l and r, e.g., lcat-version and +rcat-version, which indicate the local and remote information, +respectively. The variants without l and r show the most current +one, which is normally the remote value. +

    +

    The requested packages’ information is listed in CSV format, one package +per line, and the column information is given by the itemN. The +depends column contains the names of all the dependencies separated +by : characters. +

    +

    At this writing, the cat-contact-* fields include: home, +repository, support, bugs, announce, development. Each +may be empty or a url value. A brief description is on the CTAN upload +page for new packages: https://ctan.org/upload.

    –json
    -

    In case --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: TLPOBJINFO. -If both --json and --data are given, --json takes precedence. +

    In case --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: TLPOBJINFO. If both +--json and --data are given, --json takes precedence.

    @@ -5901,12 +5938,12 @@ suppresses this behavior. (e.g., if the selected mirror is out of date), tlmgr does not downgrade. Also, packages for uninstalled platforms are not installed.

    -

    tlmgr saves a copy of the texlive.tlpdb file used for an update -with a suffix representing the repository url, as in -tlpkg/texlive.tlpdb.long-hash-string. These can be useful for -fallback information, but if you don’t like them accumulating (e.g., -mirror.ctan.org resolves to many different hosts, each resulting in -a possibly different hash), it’s harmless to delete them. +

    tlmgr saves one copy of the main texlive.tlpdb file used for an +update with a suffix representing the repository url, as in +tlpkg/texlive.tlpdb.main.long-hash-string. Thus, even when many +mirrors are used, only one main tlpdb backup is kept. For non-main +repositories, which do not generally have (m)any mirrors, no pruning of +backups is done.

    This action does not automatically add or remove new symlinks in system directories; you need to run tlmgr path yourself if you are using @@ -5958,6 +5995,9 @@ ignored. All other lines must look like:

    require-verification, value 0 or 1 (default 0), same as command-line option.
    +
    tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.
    +
    +
    update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.
    @@ -6874,7 +6914,7 @@ Previous: https://tug.org/texlive) and both are licensed under the GNU General Public License Version 2 or later.

    -

    $Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $ +

    $Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $


    @@ -6992,8 +7032,6 @@ Previous: , Up: --with-system-libAdding a new generic library module --with-system-libLibrary-specific configure options --with-system-libgsConfigure options for texk/dvisvgm ---with-system-popplerConfigure options for system poppler ---with-system-xpdfConfigure options for system poppler --with-xdvi-x-toolkitxdvik package --with-xdvi-x-toolkit=kitConfigure options for texk/xdvik --without-libgsConfigure options for texk/dvisvgm @@ -7003,6 +7041,7 @@ Previous: , Up: -j make optionBuild in parallel
    A +ac/withenable.acAdding a new program module adapting TeX Live for distrosDistro builds adding a new generic libraryAdding a new generic library module adding a new programAdding a new program module @@ -7016,6 +7055,7 @@ Previous: , Up: AutoconfOverview of build system autoconf macrosAutoconf macros AutomakeOverview of build system +autoreconf, for new programAdding a new program module
    B biberLinked scripts @@ -7048,6 +7088,7 @@ Previous: , Up: CCVariables for configure CC=c-compilerBuild one package CC_BUILDCross problems +ChangeLogAdding a new program module chktexDeclarations and definitions clispVariables for configure CLISPVariables for configure @@ -7062,7 +7103,6 @@ Previous: , Up: configure options, for dvipdfm-xConfigure options for texk/dvipdfm-x configure options, for dvisvgmConfigure options for texk/dvisvgm configure options, for kpathseaConfigure options for kpathsea -configure options, for system popplerConfigure options for system poppler configure options, for texk/texliveConfigure options for texk/texlive configure options, for web2cConfigure options for texk/web2c configure options, for xdvikConfigure options for texk/xdvik @@ -7071,6 +7111,7 @@ Previous: , Up: configure options, library-specificLibrary-specific configure options configure options, program-specificProgram-specific configure options configure variablesVariables for configure +configure.acAdding a new program module configuring, for cross compilationCross configuring constConst continuous integrationContinuous integration @@ -7100,6 +7141,7 @@ Previous: , Up: dvisvgmConfigure options for texk/dvisvgm
    E +engine, adding newAdding a new program module engine, building oneBuild one engine environment variables, for configureConfigure options exec_prefix--enable-multiplatform @@ -7226,6 +7268,7 @@ Previous: , Up: MAKEVariables for configure make -tBuild system tools make rules, verbose vs. silent--enable-silent-rules +Makefile.amAdding a new program module mf-nowinConfigure options for texk/web2c mingw32Cross configuring MINGW32, Automake conditionalMacros for Windows @@ -7237,6 +7280,7 @@ Previous: , Up:
    N
    native cross compilationCross compilation +newprog-src, original source subdirectoryAdding a new program module
    O OBJCXX=objc-compilerBuild one package @@ -7257,7 +7301,6 @@ Previous: , Up: PKG_CONFIGVariables for configure plain.tex, not in source treeInstalling png librarypng library -popplerConfigure options for system poppler PostScript files, size of--disable-largefile Preining, NorbertDistro builds preloaded binariesConfigure options for texk/web2c @@ -7270,6 +7313,7 @@ Previous: , Up:
    R
    reautoconfBuild system tools +reautoconf, for new programAdding a new program module requirements for buildingPrerequisites runscript.exeMacros for Windows
    @@ -7304,6 +7348,8 @@ Previous: , Up: texlive.tlpdb, TeX Live databaseInstalling tieCross problems timestamps, in repositoryBuild system tools +TLpatches/patch-...Adding a new program module +TLpatches/TL-ChangesAdding a new program module tools, for buildingBuild system tools top-level directoriesTop-level directories touching files to avoid rerunningBuild system tools @@ -7348,7 +7394,6 @@ Previous: , Up: xindy cross compiling requires clispCross problems XInputConfigure options for texk/xdvik XlibConfigure options for texk/web2c -xpdf as libraryConfigure options for system poppler xzLinked scripts
    Z diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf index 7d4bd8bad61..50a540320a5 100644 Binary files a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf and b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf differ diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 4ef7146223a..19a32fb57dc 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -4,7 +4,7 @@ an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007, 2008, 2009, 2010-2020 Karl Berry & Olaf Weber. +2004, 2005, 2007, 2008, 2009, 2010-2021 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 @@ -79,7 +79,6 @@ ul.no-bullet {list-style: none}
  • 2.2 Compile-time options
  • 2.3 Additional targets
  • 2.4 Trip, trap, and mptrap: Torture tests
  • -
  • 2.5 Runtime options
  • 3 Commonalities
  • +
  • 4 Three programs: Metafont, MetaPost, and TeX +
  • -
  • 4 TeX: Typesetting +
  • 5 TeX: Typesetting
  • -
  • 5 Metafont: Creating typeface families +
  • 6 Metafont: Creating typeface families
  • -
  • 6 MetaPost: Creating technical illustrations +
  • 7 MetaPost: Generating PostScript
  • -
  • 7 BibTeX: Bibliographies +
  • 8 BibTeX: Bibliographies
  • -
  • 8 WEB: Literate programming +
  • 9 WEB: Literate programming
  • -
  • 9 DVI utilities +
  • 10 DVI utilities
  • -
  • 10 Font utilities +
  • 11 Font utilities
  • Appendix A Legalisms
  • Appendix B References
  • @@ -186,8 +186,8 @@ Next: , Up: 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 2020, released in -March 2020. +corresponds to Web2c version 2021, released in +February 2021.

    - - - - - - + @@ -228,15 +230,15 @@ Next: , Previou -

    This manual corresponds to version 2020 of Web2c, released in -March 2020. +

    This manual corresponds to version 2021 of Web2c, released in +February 2021.

    -

    Web2c is the name of a TeX implementation, originally for Unix, -but now also running under DOS, Amiga, and other operating systems. By +

    Web2c is the name of a TeX implementation, originally for +Unix, but now also running under various operating systems. By TeX implementation, we mean all of the standard programs developed by the Stanford TeX project directed by Donald E. Knuth: Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX @@ -255,7 +257,6 @@ Therefore, it will not work without change on an arbitrary WEB program. -

    Availability: All of Web2c is freely available—“free” both in the sense of no cost (free ice cream) and of having the source code to modify and/or redistribute (free speech). See unixtex.ftp in Kpathsea, for the practical details of how to obtain Web2c. @@ -263,14 +264,15 @@ modify and/or redistribute (free speech). See Copying in Kpathsea). The -GPL covers the Web2c executables, including tex, because the Free -Software Foundation sponsored the initial development of the Kpathsea -library that Web2c uses. The basic source files from Stanford, however, -have their own copyright terms or are in the public domain, and are not +practical implication for redistributors of Web2c is that most of the +executables are covered by the GNU General Public License or GNU +Lesser General Public License, and therefore anyone who gets a binary +distribution must also be able to get the sources, as explained by the +terms of the GPL (https://gnu.org/licenses/. The GPL covers the +Web2c executables, including tex, because the Free Software +Foundation sponsored the initial development of the Kpathsea library +that Web2c uses. The basic source files from Stanford, however, have +their own copyright terms or are in the public domain, and are not covered by the GPL.

    @@ -282,19 +284,21 @@ covered by the GPL.

    History: Tomas Rokicki originated the TeX-to-C system in 1987, working from the first change files for TeX under Unix, which were -done primarily by Howard Trickey and Pavel Curtis. Tim Morgan then took -over development and maintenance for a number of years; the name changed -to Web-to-C somewhere in there. In 1990, Karl Berry became the -maintainer. He made many changes to the original sources, and started -using the shorter name Web2c. In 1997, Olaf Weber took over. Dozens of -other people have contributed; their names are listed in the -ChangeLog files. +done primarily by Howard Trickey and Pavel Curtis. Tim Morgan then +took over development and maintenance for a number of years; the name +changed to Web-to-C somewhere in there. In 1990, Karl Berry became +the maintainer. He made many changes to the original sources, and +started using the shorter name Web2c. In 1997, Olaf Weber took over, +and then in 2006, Karl started taking care of it again. No +significant development or changes have been needed for many +years. Dozens of other people have contributed; their names are listed +in the ChangeLog files.

    -

    Other acknowledgements: The University of Massachusetts at Boston +

    Other acknowledgements by Karl: The University of Massachusetts at Boston (particularly Rick Martin and Bob Morris) provided computers and ftp access to me for many years. Richard Stallman at the Free Software Foundation employed me while I wrote the original path searching library @@ -372,8 +376,6 @@ as described in the first section below.

    -
    @@ -569,7 +571,7 @@ possibilities.

    2.4 Trip, trap, and mptrap: Torture tests

    @@ -620,91 +622,17 @@ run ‘make check’. You can compare the output to the di file tests/check.log if you like.

    -
    -
    -

    -Previous: , Up: Installation   [Contents][Index]

    -
    -

    2.5 Runtime options

    - - - - - -

    Besides the configure- and compile-time options described in the -previous sections, you can control a number of parameters (in -particular, array sizes) in the texmf.cnf runtime file read by -Kpathsea (see Config files in Kpathsea). -

    -

    Rather than exhaustively listing them here, please see the last section -of the distributed kpathsea/texmf.cnf. Some of the more -interesting values: -

    -
    -
    main_memory’ - -
    -

    Total words of memory available, for TeX, Metafont, and MetaPost. -Must remake the format file after changing. -

    -
    -
    extra_mem_bot’ - -
    -
    - - - -

    Extra space for “large” TeX data structures: boxes, glue, -breakpoints, et al. If you use PiCTeX, you may well want to set this. -

    -
    -
    font_mem_size’ - -
    -
    -

    Words of font info available for TeX; this is approximately the total -size of all TFM files read. -

    -
    -
    hash_extra’ - -
    -
    - -

    Additional space for the hash table of control sequence names. -Approximately 10,000 control sequences can be stored in the main hash -table; if you have a large book with numerous cross-references, -this might not be enough, and thus you will want to set hash_extra. -

    -
    -
    - - - - - -

    Of course, ideally all arrays would be dynamically expanded as -necessary, so the only limiting factor would be the amount of swap space -available. Unfortunately, implementing this is extremely difficult, as -the fixed size of arrays is assumed in many places throughout the source -code. These runtime limits are a practical compromise between the -compile-time limits in previous versions, and truly dynamic arrays. (On -the other hand, the Web2c BibTeX implementation does do dynamic -reallocation of some arrays.) -

    -

    -Next: , Previous: , Up: Top   [Contents][Index]

    +Next: , Previous: , Up: Top   [Contents][Index]

    3 Commonalities

    Many aspects of the TeX system are the same among more than one -program, so we describe all those pieces together, here. +program, so we describe those pieces together, here.

    - @@ -807,6 +733,13 @@ standard output, then exit successfully. common:

    +
    -cnf-line=str
    +
    +

    Parse str as if it were a line in the texmf.cnf +configuration file, overriding all other settings. See Path +searching options in Kpathsea. +

    +
    -file-line-error
    @@ -939,8 +872,9 @@ See TCX files.

    This option specifies that by default all characters should be -considered printable. If ‘-translate-file’ was given as well, then the -TCX file may mark characters as non-printable. +considered printable. If ‘-translate-file’ was given as well, +then the TCX file may mark characters as non-printable. This is a +no-op in engines natively supporting Unicode.

    @@ -979,7 +913,7 @@ names.

    3.4 Output file location

    @@ -1021,9 +955,9 @@ simply checked as given.

    -Previous: , Up: Commonalities   [Contents][Index]

    +Next: , Previous: , Up: Top   [Contents][Index]

    -

    3.5 Three programs: Metafont, MetaPost, and TeX

    +

    4 Three programs: Metafont, MetaPost, and TeX

    @@ -1031,29 +965,136 @@ Previous:

    Runtime options. +Besides the ones here, command-line options and other commonalities +are described in the previous section.

    - + - - - +
    + +

    4.1 Runtime options

    + + + + + + +

    Besides the configure- and compile-time options described in the +installation section (see Installation), you can control a number +of parameters in the texmf.cnf runtime file read by Kpathsea +(see Config files in Kpathsea). +

    +

    The main purpose of texmf.cnf is to specify search paths, but +array sizes and other options are also set there. Most are rather +obscure. Here are a few of the more interesting values: +

    +
    +
    main_memory’ + +
    +

    Total words of memory available, for TeX, Metafont, and MetaPost. +Must remake the format file after changing. +

    +
    +
    extra_mem_bot’ + +
    +
    + + + +

    Extra space for “large” TeX data structures (default 0): boxes, +glue, breakpoints, et al. If you use PiCTeX, you may well want to +set this. +

    +
    +
    expand_depth’ + +
    +
    + + + + + +

    Limit on recursive expansion calls before TeX aborts (default +10000). If a TeX program does an unterminated recursive expansion, +TeX will dutifully expand macros until the system’s runtime stack +overflows, typically with a segmentation fault (SIGSEGV). This +parameter was introduced to minimize the chance of that unpleasant +(though not dangerous) crash, instead allowing TeX to quit with a +more informative message. +

    + +

    The crash can still happen, though, if the system has an exceptionally +small memory allocation for its stack. There is no quantitative way to +determine the limit, and it does not seem worth implementing +system-dependent heuristics to guess at the number, since it’s highly +improbable that any real TeX code will ever need more than 10000 +recursive expansions (it has never happened). For the same reason, +using the libsigsegv library (https://gnu.org/s/libsigsegv) does +not seem worth the effort. +

    +
    +
    texmf_casefold_search’ + +
    +

    See Casefolding search in Kpathsea. +

    +
    +
    + + + + + +

    Ideally all arrays would be dynamically expanded as necessary, so the +only limiting factor would be the amount of swap space available, or +some configurable limit much larger than can currently be supported. +

    +

    Unfortunately, implementing this is extremely difficult, as the fixed +size of arrays is assumed in many places throughout the source code. +These runtime limits are a practical compromise between the +compile-time limits in previous versions, and truly dynamic arrays. +(On the other hand, the Web2c BibTeX implementation does do true +dynamic reallocation of some arrays.) +

    + + +

    Nowadays there is rarely a reason to modify the values. But if you do +wish to modify texmf.cnf, in TeX Live the best approach is +to put your changes, and only your changes at the top of the TL +installation tree. That is, if the system texmf.cnf is +installed in +/some/path/to/texlive/YYYY/texmf-dist/web2c/texmf.cnf is put +your custom settings in /some/path/to/texlive/YYY/texmf.cnf, +where YYYY is the year of installation (if you use that +subdirectory; it’s the default). That way, unrelated changes to the +system texmf.cnf can happen with normal updates, without +affecting your local values. +

    +
    -

    3.5.1 Initial and virgin

    +

    4.2 Initial and virgin

    The TeX and Metafont programs each have two main variants, called @@ -1087,7 +1128,7 @@ memory dump file.

    Next: , Previous: , Up: Three programs   [Contents][Index]

    -

    3.5.2 Memory dumps

    +

    4.3 Memory dumps

    @@ -1114,7 +1155,7 @@ code.

    Next: , Up: Memory dumps   [Contents][Index]

    -

    3.5.2.1 Creating memory dumps

    +

    4.3.1 Creating memory dumps

    @@ -1156,7 +1197,7 @@ difficulties.

    Next: , Previous: , Up: Memory dumps   [Contents][Index]

    -

    3.5.2.2 Determining the memory dump to use

    +

    4.3.2 Determining the memory dump to use

    @@ -1210,7 +1251,7 @@ will be used.

    Previous: , Up: Memory dumps   [Contents][Index]

    -

    3.5.2.3 Hardware and memory dumps

    +

    4.3.3 Hardware and memory dumps

    @@ -1297,7 +1338,7 @@ Jr. (see References).

    Next: , Previous: , Up: Three programs   [Contents][Index]

    -

    3.5.3 Editor invocation

    +

    4.4 Editor invocation

    @@ -1311,6 +1352,7 @@ responds with e or E, the program invokes an editor. +

    Specifying ‘--with-editor=cmd’ to configure sets the default editor command string to cmd. The environment variables/configuration values TEXEDIT, MFEDIT, and @@ -1328,7 +1370,7 @@ and ‘%s’ is replaced by the name of the current input f

    Previous: , Up: Three programs   [Contents][Index]

    -

    3.5.4 \input filenames

    +

    4.5 \input filenames

    @@ -1365,10 +1407,10 @@ filename; there is no way to read files whose names contain a "

    However, for maximal portability of your document across systems, use -only the characters ‘a’–‘z’, ‘0’–‘9’, and -‘.’. Do not use anything but simple filenames, since directory -separators vary among systems; instead, add the necessary directories -to the appropriate search path. +only the characters ‘a’–‘z’, ‘0’–‘9’, and at +most one ‘.’. Do not use anything but simple filenames, since +directory separators vary among systems; instead, add the necessary +directories to the appropriate search path.

    - @@ -1543,7 +1585,7 @@ otherwise, are available.

    Next: , Up: TeX   [Contents][Index]

    -

    4.1 tex invocation

    +

    5.1 tex invocation

    @@ -1654,7 +1696,8 @@ See Common options.

    Enable encTeX extensions, such as \mubyte. This can be used -to support Unicode UTF-8 input encoding. See +to support the Unicode UTF-8 input encoding, although using an engine +with native Unicode support is more common nowadays. http://www.olsak.net/enctex.html.

    @@ -1768,7 +1811,7 @@ hard-coded to always use the ‘\special’ primitive.

    Next: , Previous: , Up: TeX   [Contents][Index]

    -

    4.2 Initial TeX

    +

    5.2 Initial TeX

    @@ -1811,7 +1854,7 @@ more details on TeX formats.

    Next: , Previous: , Up: TeX   [Contents][Index]

    -

    4.3 Formats

    +

    5.3 Formats

    @@ -1825,27 +1868,26 @@ current at the time of release. You can change which formats are automatically built by setting the fmts Make variable; by default, only the ‘plain’ and ‘latex’ formats are made.

    -

    You can get the latest versions of most of these formats from the CTAN -archives in subdirectories of CTAN:/macros (for CTAN info, -see unixtex.ftp in Kpathsea). The archive -ftp://ftp.tug.org/tex/lib.tar.gz (also available from CTAN) -contains most of these formats (although perhaps not the absolute latest -version), among other things. +

    Nowadays, the formats are generally installed and updated as part of a +larger TeX distribution, such as TeX Live +(https://tug.org/texlive).

    latex
    -

    The most widely used format. The current release is named ‘LaTeX -2e’; new versions are released approximately every six months, with -patches issued as needed. The old release was called ‘LaTeX 2.09’, -and is no longer maintained or supported. LaTeX attempts to provide -generic markup instructions, such as “emphasize”, instead of specific -typesetting instructions, such as “use the 10pt Computer Modern -italic font”. The LaTeX home page: http://www.latex-project.org. +

    The most widely used format. The current release is named +‘LaTeX2e’; new versions are released approximately every six +months, with patches issued as needed. The old release was called +‘LaTeX 2.09’, and is no longer maintained or supported. LaTeX +attempts to provide generic markup instructions, such as +“emphasize”, instead of specific typesetting instructions, such as +“use the 10pt Computer Modern italic font”. The LaTeX home +page: https://www.latex-project.org.

    context
    -

    ConTeXt is an independent macro package which has a basic document +

    +

    ConTeXt is an independent macro package which has a basic document structuring approach similar to LaTeX. It also supports creating interactive PDF files and has integrated MetaPost support, among many other interesting features. The ConTeXt home page: @@ -1858,10 +1900,10 @@ other interesting features. The ConTeXt home page:

    The official typesetting system of the American Mathematical Society. Like LaTeX, it encourages generic markup commands. The AMS also -provides many LaTeX package for authors who prefer LaTeX. Taken +provides many LaTeX packages for authors who prefer LaTeX. Taken together, they are used to produce nearly all AMS publications, e.g., Mathematical Reviews. The AMSTeX home page: -http://www.ams.org/tex. +https://www.ams.org/tex.

    texinfo
    @@ -1872,7 +1914,7 @@ together, they are used to produce nearly all AMS publications, e.g., Foundation for their software manuals. It can be automatically converted into plain text, a machine-readable on-line format called ‘info’, HTML, etc. The Texinfo home page: -http://www.gnu.org/software/texinfo. +https://www.gnu.org/software/texinfo.

    eplain
    @@ -1882,15 +1924,17 @@ converted into plain text, a machine-readable on-line format called symbolic cross-referencing, tables of contents, indexing, citations using BibTeX), for those authors who prefer to handle their own high-level formatting. The Eplain home page: -http://www.tug.org/eplain. +https://tug.org/eplain.

    slitex
    +

    An obsolete LaTeX 2.09 format for making slides. It is replaced by -the ‘slides’ document class, along with the ‘beamer’, -‘texpower’, and other packages. +the ‘slides’ document class, although the ‘beamer’ package +is the most commonly method for making slides nowadays. The Beamer +page on CTAN: https://ctan.org/pkg/beamer.

    @@ -1901,7 +1945,7 @@ the ‘slides’ document class, along with the ‘ Next: , Previous: , Up: TeX   [Contents][Index]

    -

    4.4 Languages and hyphenation

    +

    5.4 Languages and hyphenation

    @@ -1924,7 +1968,7 @@ Next: , Previ

    Next: , Up: Languages and hyphenation   [Contents][Index]

    -

    4.4.1 MLTeX: Multi-lingual TeX

    +

    5.4.1 MLTeX: Multi-lingual TeX

    @@ -1936,15 +1980,20 @@ Next: , Up:

    Multi-lingual TeX (mltex) is an extension of TeX originally written by Michael Ferguson and now updated and maintained by Bernd -Raichle. It allows the use of non-existing glyphs in a font by -declaring glyph substitutions. These are restricted to substitutions of -an accented character glyph, which need not be defined in the current +Raichle. With the advent of Unicode, it has become obsolete, though +it is still supported in Web2c in the event of bugs or compilation +bugs. +

    +

    MLTeX allows the use of non-existing glyphs in a font by declaring +glyph substitutions. These are restricted to substitutions of an +accented character glyph, which need not be defined in the current font, by its appropriate \accent construction using a base and accent character glyph, which do have to exist in the current font. -This substitution is automatically done behind the scenes, if necessary, -and thus MLTeX additionally supports hyphenation of words containing -an accented character glyph for fonts missing this glyph (e.g., Computer -Modern). Standard TeX suppresses hyphenation in this case. +This substitution is automatically done behind the scenes, if +necessary, and thus MLTeX additionally supports hyphenation of +words containing an accented character glyph for fonts missing this +glyph (e.g., Computer Modern). Standard TeX suppresses hyphenation +in this case.

    MLTeX works at .fmt-creation time: the basic idea is to specify the ‘-mltex’ option to TeX when you \dump a @@ -1970,7 +2019,7 @@ Aside from these, MLTeX is completely compatible with standard TeX.

    Next: , Up: MLTeX   [Contents][Index]

    -

    4.4.1.1 \charsubdef: Character substitutions

    +

    5.4.1.1 \charsubdef: Character substitutions

    @@ -2034,7 +2083,7 @@ accessed often, so changing it is not desirable, nor generally useful.)

    Previous: , Up: MLTeX   [Contents][Index]

    -

    4.4.1.2 \tracingcharsubdef: Substitution diagnostics

    +

    5.4.1.2 \tracingcharsubdef: Substitution diagnostics

    @@ -2054,7 +2103,7 @@ more, the character substitutions actually performed at

    Next: , Previous: , Up: Languages and hyphenation   [Contents][Index]

    -

    4.4.2 TCX files: Character translations

    +

    5.4.2 TCX files: Character translations

    @@ -2216,7 +2265,7 @@ the dump is ignored and the data from the file used instead.

    Previous: , Up: Languages and hyphenation   [Contents][Index]

    -

    4.4.3 Patgen: Creating hyphenation patterns

    +

    5.4.3 Patgen: Creating hyphenation patterns

    @@ -2246,7 +2295,7 @@ Frank Liang (see References), and also the patge

    Next: , Previous: , Up: TeX   [Contents][Index]

    -

    4.5 Shell escapes

    +

    5.5 Shell escapes

    @@ -2256,6 +2305,7 @@ Next: , Previous: +

    TeX can execute shell escapes, that is, arbitrary shell commands. Although tremendously useful, this also has obvious @@ -2353,7 +2403,7 @@ considered untrustworthy, shell escapes should be completely disabled.

    Next: , Previous: , Up: TeX   [Contents][Index]

    -

    4.6 IPC and TeX

    +

    5.6 IPC and TeX

    @@ -2376,7 +2426,7 @@ debugging.

    Previous: , Up: TeX   [Contents][Index]

    -

    4.7 TeX extensions

    +

    5.7 Extended TeX engines

    @@ -2389,15 +2439,17 @@ partial list.

    Adds many new primitives, including right-to-left typesetting and more -registers. Now frozen. +registers. Now frozen. More info: https://ctan.org/pkg/etex.

    Aleph
    +

    This adds Unicode support, right-to-left typesetting, and more. Omega was the original program. Aleph is an updated version with a variety of bug fixes, and includes e-TeX. Aleph is not actively maintained. +More info: https://ctan.org/pkg/aleph, https://ctan.org/pkg/omega.

    pdfTeX
    @@ -2405,26 +2457,55 @@ of bug fixes, and includes e-TeX. Aleph is not actively maintained. +

    Can produce PDF as well as DVI files. It also incorporates the e-TeX extensions, new primitives for hypertext and -micro-typography, reading/writing from pipes, and much more. Home -page: http://pdftex.org. +micro-typography, reading/writing from pipes, and much more. In +TeX Live, the command etex invokes pdfTeX to make all +these additions available with DVI output. Home page: +http://pdftex.org.

    -
    luaTeX
    -
    +
    LuaTeX
    +
    -

    Based on pdfTeX, this also embeds the Lua programming language -(http://lua.org) and opens up the TeX typesetting engine to -control from Lua. Home page: http://luatex.org. + + + + +

    Embeds the Lua programming language (http://lua.org) and opens +up the TeX typesetting engine to control from Lua, starting from +the pdfTeX capabilities as a base. Also natively supports UTF-8 +input, the OpenType and TrueType font formats, and use of system +fonts. Home page: http://luatex.org.

    XeTeX
    - -

    Combines support for Unicode input and OpenType- and system fonts -with the capabilities of pdfTeX. -Home page: http://tug.org/xetex. + +

    Combines support for Unicode input, the OpenType and TrueType font +formats, and use of system fonts with the capabilities of pdfTeX, +with the exception of the font expansion part of micro-typography. +Home page: https://tug.org/xetex. +

    +
    +
    pTeX
    +
    upTeX
    +
    + +

    With additional support for Japanese; pTeX was the original engine, +and upTeX has native Unicode support and thus is more useful for +Chinese and Korean. More info: https://ctan.org/pkg/ptex, +https://ctan.org/pkg/uptex. +

    +
    +
    epTeX
    +
    eupTeX
    +
    + +

    Further extends pTeX and upTeX with the e-TeX extensions. +More info: https://ctan.org/pkg/eptex, +https://ctan.org/pkg/euptex.

    @@ -2435,7 +2516,7 @@ Home page: http://tug.org/xetex.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    5 Metafont: Creating typeface families

    +

    6 Metafont: Creating typeface families

    @@ -2478,7 +2559,7 @@ description of the Metafont language, see The METAFONTbook

    Next: , Up: Metafont   [Contents][Index]

    -

    5.1 mf invocation

    +

    6.1 mf invocation

    @@ -2602,7 +2683,7 @@ The only value that makes sense for filetype is ‘mf Next: , Previous: , Up: Metafont   [Contents][Index]

    -

    5.2 Initial Metafont

    +

    6.2 Initial Metafont

    @@ -2653,7 +2734,7 @@ create their own base file, of course.

    Next: , Previous: , Up: Metafont   [Contents][Index]

    -

    5.3 Modes: Device definitions for Metafont

    +

    6.3 Modes: Device definitions for Metafont

    @@ -2720,7 +2801,7 @@ and o.)

    Next: , Previous: , Up: Metafont   [Contents][Index]

    -

    5.4 Online Metafont graphics

    +

    6.4 Online Metafont graphics

    @@ -2882,7 +2963,7 @@ use MFtalk (see web2c/window/mftalk.c).

    Next: , Previous: , Up: Metafont   [Contents][Index]

    -

    5.5 GFtoDVI: Character proofs of fonts

    +

    6.5 GFtoDVI: Character proofs of fonts

    @@ -2970,7 +3051,7 @@ position is too crowded with other information.

    Previous: , Up: Metafont   [Contents][Index]

    -

    5.6 MFT: Prettyprinting Metafont source

    +

    6.6 MFT: Prettyprinting Metafont source

    @@ -3087,16 +3168,19 @@ configure TeX to print these properly.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    6 MetaPost: Creating technical illustrations

    +

    7 MetaPost: Generating PostScript

    +

    MetaPost is a picture-drawing language similar to Metafont (see Metafont), but instead of outputting bitmaps in a “font”, it outputs PostScript commands. It’s primarily intended for creating -technical illustrations. +technical illustrations, but can also be used to create PostScript or +OpenType fonts (https://ctan.org/pkg/metatype1).

    +

    MetaPost also provides for arbitrary integration of text and graphics in a natural way, using any typesetter (TeX and Troff are both supported) and a number of other subsidiary programs, described below. @@ -3116,34 +3200,28 @@ supported) and a number of other subsidiary programs, described below.

    Next: , Up: MetaPost   [Contents][Index]

    -

    6.1 mpost invocation

    +

    7.1 mpost invocation

    - +

    MetaPost (installed as mpost) reads a series of pictures specified in the MetaPost programming language, and outputs corresponding PostScript code. This section merely describes the options available in the Web2c implementation. For a complete description of the MetaPost language, see AT&T technical report CSTR-162, generally available in texmf/doc/metapost/, -where texmf is the root of TeX directory structure. See -also: -

    - - +where texmf is the root of TeX directory structure. +The MetaPost home page: https://tug.org/metapost. +

    +

    Also, a standard MetaPost package for drawing graphs is documented in AT&T technical report CSTR-164, available as the file mpgraph.ps, generally stored alongside mpman.ps.

    -

    MetaPost processes its command line and determines its memory dump (mem) -file in a way exactly analogous to Metafont and TeX (see tex invocation, and see Memory dumps). +

    MetaPost processes its command line and determines its memory dump +(mem) file in a way analogous to Metafont and TeX (see tex invocation, and see Memory dumps). Synopses:

    @@ -3294,7 +3372,7 @@ typeset the labels.

    Next: , Previous: , Up: MetaPost   [Contents][Index]

    -

    6.2 Initial MetaPost

    +

    7.2 Initial MetaPost

    @@ -3324,7 +3402,7 @@ Metafont in proof mode and GFtoDVI (see gftodvi in

    Previous: , Up: MetaPost   [Contents][Index]

    -

    6.3 DVItoMP: DVI to MPX conversion

    +

    7.3 DVItoMP: DVI to MPX conversion

    @@ -3354,7 +3432,7 @@ MetaPost commands.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    7 BibTeX: Bibliographies

    +

    8 BibTeX: Bibliographies

    @@ -3375,7 +3453,7 @@ makes bibliography entries reusable in many different contexts.

    Next: , Up: BibTeX   [Contents][Index]

    -

    7.1 BibTeX invocation

    +

    8.1 BibTeX invocation

    @@ -3483,7 +3561,7 @@ for TUGboat.

    Previous: , Up: BibTeX   [Contents][Index]

    -

    7.2 Basic BibTeX style files

    +

    8.2 Basic BibTeX style files

    @@ -3552,7 +3630,7 @@ abbreviations, names in small caps.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    8 WEB: Literate programming

    +

    9 WEB: Literate programming

    @@ -3599,7 +3677,7 @@ which is included in the ftp://ftp.tu

    Next: , Up: WEB   [Contents][Index]

    -

    8.1 Tangle: Translate WEB to Pascal

    +

    9.1 Tangle: Translate WEB to Pascal

    @@ -3680,7 +3758,7 @@ whether they collide.

    Next: , Previous: , Up: WEB   [Contents][Index]

    -

    8.2 Weave: Translate WEB to TeX

    +

    9.2 Weave: Translate WEB to TeX

    @@ -3729,7 +3807,7 @@ first change in the change file).

    Previous: , Up: WEB   [Contents][Index]

    -

    8.3 Pooltype: Display WEB pool files

    +

    9.3 Pooltype: Display WEB pool files

    @@ -3775,7 +3853,7 @@ output.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    9 DVI utilities

    +

    10 DVI utilities

    @@ -3807,7 +3885,7 @@ drivers; they perform generic utility functions.

    Next: , Up: DVI utilities   [Contents][Index]

    -

    9.1 DVIcopy: Canonicalize virtual font references

    +

    10.1 DVIcopy: Canonicalize virtual font references

    @@ -3860,7 +3938,7 @@ matches anything. Examples: ‘3’, ‘1.*.-4 Previous: , Up: DVI utilities   [Contents][Index]

    -

    9.2 DVItype: Plain text transliteration of DVI files

    +

    10.2 DVItype: Plain text transliteration of DVI files

    @@ -3956,7 +4034,7 @@ use decimal because in the DVI format documentation (in

    Up: dvitype invocation   [Contents][Index]

    -

    9.2.1 DVItype output example

    +

    10.2.1 DVItype output example

    As an example of the output from DVItype (see section above), here is @@ -4043,7 +4121,7 @@ STORY]’ and the ‘[ 1]’.

    Next: , Previous: , Up: Top   [Contents][Index]

    -

    10 Font utilities

    +

    11 Font utilities

    @@ -4089,7 +4167,7 @@ mentioned below are in the source files that read them;

    Next: , Up: Font utilities   [Contents][Index]

    -

    10.1 Font file formats

    +

    11.1 Font file formats

    @@ -4176,7 +4254,7 @@ distribution by Pierre MacKay and Elizabeth Tachikawa.)

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.2 GFtoPK: Generic to packed font conversion

    +

    11.2 GFtoPK: Generic to packed font conversion

    @@ -4216,7 +4294,7 @@ of ‘gfname.dpipk’, e.g., ‘<

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.3 PKtoGF: Packed to generic font conversion

    +

    11.3 PKtoGF: Packed to generic font conversion

    @@ -4255,7 +4333,7 @@ of ‘pkname.dpigf’, e.g., ‘<

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.4 PKtype: Plain text transliteration of packed fonts

    +

    11.4 PKtype: Plain text transliteration of packed fonts

    @@ -4384,7 +4462,7 @@ lengths of white pixels, and brackets indicate a repeated row.

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.5 GFtype: Plain text transliteration of generic fonts

    +

    11.5 GFtype: Plain text transliteration of generic fonts

    @@ -4557,7 +4635,7 @@ times the ratio of the true width to the font’s design size. The

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.6 TFtoPL: TeX font metric to property list conversion

    +

    11.6 TFtoPL: TeX font metric to property list conversion

    @@ -4716,7 +4794,7 @@ ligatures for this character as a comment.

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.7 PLtoTF: Property list to TeX font metric conversion

    +

    11.7 PLtoTF: Property list to TeX font metric conversion

    @@ -4750,7 +4828,7 @@ output by default is undesirable.)

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.8 VFtoVP: Virtual font to virtual property lists

    +

    11.8 VFtoVP: Virtual font to virtual property lists

    @@ -4812,7 +4890,7 @@ confusing.

    Next: , Previous: , Up: Font utilities   [Contents][Index]

    -

    10.9 VPtoVF: Virtual property lists to virtual font

    +

    11.9 VPtoVF: Virtual property lists to virtual font

    @@ -4845,7 +4923,7 @@ specified, the VF output is written to the basename of

    Previous: , Up: Font utilities   [Contents][Index]

    -

    10.10 Font utilities available elsewhere

    +

    11.10 Font utilities available elsewhere

    @@ -4907,14 +4985,7 @@ distribution. Alternatively, ps2pk, from PostScript Type 1 font format conversion (i.e., between PFA and PFB -formats): http://www.lcdf.org/type. - -
  • - - -Scanned image conversion: the (aging) GNU font utilities convert type -specimen images to Metafont, PostScript, etc.: -http://www.gnu.org/software/fontutils/. +formats): https://www.lcdf.org/type.
  • @@ -4927,7 +4998,7 @@ the two programs mftrace
  • -Virtual font creation: CTAN:/fonts/utilities/fontinst. +Virtual font creation: https://ctan.org/pkg/fontinst.
  • @@ -4945,46 +5016,28 @@ Next: , Previous: <

    In general, each file has its own copyright notice stating the copying permissions for that file. Following is a summary.

    -

    The Web2c system itself and most of the original WEB source files are -public domain. -

    -

    tex.web, the MLTeX code, mf.web, and bibtex.web, -are copyrighted by their authors. They may be copied verbatim, but may -be modified only through a .ch file. -

    -

    MetaPost-related files, including mp.web itself, are copyrighted -under X-like terms; the precise notice is included below. -

    -

    Finally, the Kpathsea library is covered by the GNU Lesser General -Public License (see Introduction in Kpathsea). Therefore, -the binaries resulting from a standard Web2c compilation are also +

    The Stanford TeX programs and Web2c system itself are in the public +domain (https://tug.org/texlive/copying.html). The sources may +be copied verbatim, or used as the starting point of new software +under different names; however, per the wishes of the authors, they +should be modified only through a .ch file, but this is in the +nature of a development request rather than a legal requirement. +

    +

    MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived +engines have used various license terms for their additions to the +base code, often the GPL (see https://www.gnu.org/licenses/#GPL +or (for example) the file web2c/pdftexdir/COPYINGv2. They also +mostly make use of additional libraries with their own (compatible) +terms. Please see each program’s sources. +

    +

    The Kpathsea library is covered by the GNU Lesser General Public +License (see Introduction in Kpathsea). Therefore, the +binaries resulting from a standard Web2c compilation are also covered by the LGPL; so if you (re)distribute the binaries, you must also (offer to) distribute the complete source that went into those -binaries. See the file LGPL for complete details on the LGPL. -

    -

    The following notice must be included by the terms of the MetaPost -copyright. -

    -
    -

    Permission to use, copy, modify, and distribute this software and its -documentation for any purpose and without fee is hereby granted, -provided that the above copyright notice appear in all copies and that -both that the copyright notice and this permission notice and warranty -disclaimer appear in supporting documentation, and that the names of -AT&T Bell Laboratories or any of its entities not be used in advertising -or publicity pertaining to distribution of the software without -specific, written prior permission. -

    -

    AT&T disclaims all warranties with regard to this software, including -all implied warranties of merchantability and fitness. In no event -shall AT&T be liable for any special, indirect or consequential damages -or any damages whatsoever resulting from loss of use, data or profits, -whether in an action of contract, negligence or other tortious action, -arising out of or in connection with the use or performance of this -software. -

    - - +binaries. See https://gnu.org/licenses/#LGPL or the file +kpathsea/COPYING.LESSERv2. +


    @@ -5000,10 +5053,11 @@ Next: , Previous: Introduction in Dvips. -

  • The TeX Users Group: http://www.tug.org. For an introduction -to the TeX system, see http://tug.org/begin.html. +
  • The TeX Users Group: https://tug.org. For an introduction +to the TeX system, see https://tug.org/begin.html. -
  • TUGboat: http://tug.org/TUGboat. +
  • TUGboat, the principal journal for the TeX world: +https://tug.org/TUGboat.
  • TeX and computer typesetting in general:
    ftp://ftp.math.utah.edu/pub/tex/bib/texbook1.bib. @@ -5017,18 +5071,13 @@ TeX project, see the books TeX: The Program or Neenie Billawala. Write-white printing engines and tuning fonts with Metafont. TUGboat, 8(1):29–32, April 1987. -http://tug.org/TUGboat/tb08-1/tb17billawala.pdf. - -
  • [GMS94] -Michel Goossens, Frank Mittelbach, and Alexander Samarin. -The LaTeX Companion. -Addison-Wesley, Reading, MA, USA, 1994. +https://tug.org/TUGboat/tb08-1/tb17billawala.pdf.
  • [Hob89] John D. Hobby. A Metafont-like system with PS output. TUGboat, 10(4):505–512, December 1989. -http://tug.org/metapost. +https://tug.org/metapost.
  • [Hob92] John D. Hobby. @@ -5051,6 +5100,7 @@ An authoritative reference to the C programming language, and a good Donald E. Knuth and Silvio Levy. The CWEB System of Structured Documentation, Version 3.0. Addison-Wesley, Reading, MA, USA, 1993. +https://ctan.org/pkg/cweb.
  • [Knu84] Donald E. Knuth. @@ -5102,7 +5152,7 @@ This is an updated version of Knuth:1988:ET. Donald Knuth. Virtual Fonts: More Fun for Grand Wizards. TUGboat, 11(1):13–23, April 1990. -http://tug.org/TUGboat/tb11-1/tb27knut.pdf. +https://tug.org/TUGboat/tb11-1/tb27knut.pdf.
  • [Knu92] Donald E. Knuth. @@ -5115,13 +5165,13 @@ Leslie Lamport. LaTeX: A Document Preparation System: User’s Guide and Reference Manual. Addison-Wesley, Reading, MA, USA, second edition, 1994. -Reprinted with corrections in 1996. +Reprinted with corrections, 1996.
  • [Lia83] Franklin Mark Liang. Word hy-phen-a-tion by com-pu-ter. Technical Report STAN-CS-83-977, Stanford University, August 1983. -http://tug.org/docs/liang/liang-thesis.pdf. +https://tug.org/docs/liang/liang-thesis.pdf.
  • [Mac91] Pierre A. MacKay. @@ -5132,18 +5182,6 @@ In Robert A. Morris and Jacques Andre, editors, Raster Imaging and Boston, Oct. 14–16, 1991, pages 205–215, New York, 1991. Cambridge University Press. -
  • [Spi89] -Michael D. Spivak. -LAMSTeX, The Synthesis. -The TeXplorators Corporation, 3701 W. Alabama, Suite 450-273, Houston, TX - 77027, USA, 1989. - -
  • [Spi90] -Michael D. Spivak. -The Joy of TeX—A Gourmet Guide to Typesetting with the - AMSTeX macro package. -American Mathematical Society, Providence, RI, USA, 2nd revised edition, 1990. -
  • @@ -5271,6 +5309,7 @@ Previous: , Up: -change=chfilemft invocation -charcode-format=typetftopl invocation -charcode-format=typevftovp invocation +-cnf-lineCommon options -D compiler optionsCompile-time options -disable-write18tex invocation -dpi=realdvitype invocation @@ -5431,6 +5470,7 @@ Previous: , Up: basic fonts and macrosInstallation batch languagesTeX BDF and GF conversionFont utilities available elsewhere +beamer, packageFormats beginfigmpost invocation Berry, KarlIntroduction BIBINPUTS, search path for bib filesbibtex invocation @@ -5497,7 +5537,7 @@ Previous: , Up: configuration, compile-timeconfigure options configure --with/--enable optionsconfigure options CONTENTS.texweave invocation -control sequence names, space forRuntime options +ConTeXtFormats conventions for options,Option conventions conversion, DVI to plain textdvitype invocation conversion, GF to PKgftopk invocation @@ -5569,14 +5609,19 @@ Previous: , Up: eoc GF commandgftype invocation EplainFormats epsfOnline Metafont graphics +epTeXTeX extensions errors, editor invoked atEditor invocation escapement, horizontalpktype invocation escapement, horizontalgftype invocation escapement, verticalgftype invocation etex for MetaPost labelsmpost invocation +etex is pdfTeXTeX extensions +eupTeXTeX extensions executables, shared initial and virginInitial and virgin exit status, of shell escapeShell escapes expanded plain formatFormats +expand_depthRuntime options +expansion limit, recursiveRuntime options expansion, and \input filenames\input filename caveats extensions to TeXTeX extensions extra_mem_botRuntime options @@ -5611,8 +5656,6 @@ Previous: , Up: fontforgeFont utilities available elsewhere fontinst, for creating virtual fontsFont utilities available elsewhere fonts, basicInstallation -fontutilsFont utilities available elsewhere -font_mem_sizeRuntime options format filesInitial TeX formats for TeXFormats formats Make targetAdditional targets @@ -5649,12 +5692,9 @@ Previous: , Up: H Harbison, Samuel P.Hardware and memory dumps hardware and memory dumpsHardware and memory dumps -hash table, increasing size ofRuntime options -hash_extraRuntime options headerbyte informationtftopl invocation height, in pixelspktype invocation help, onlineCommon options -Henry, PatrickIntroduction Herberts, MathiasOnline Metafont graphics hex character codes, in TCX filesTCX files historyIntroduction @@ -5723,6 +5763,7 @@ Previous: , Up: left side bearingpktype invocation left side bearinggftype invocation legalismsLegalisms +libsigsegv libraryRuntime options licensing termsIntroduction LIG propertytftopl invocation ligature table, in TFM filestftopl invocation @@ -5731,9 +5772,10 @@ Previous: , Up: links to binariesDetermining the memory dump to use literate programmingWEB LittleEndian machinesHardware and memory dumps +location of texmf.cnf in TeX LiveRuntime options log file, BibTeXbibtex invocation LuaTeX extensions -luaTeXTeX extensions +LuaTeXTeX extensions
    M machine dependenciesHardware and memory dumps @@ -5797,11 +5839,12 @@ Previous: , Up: modes.mf recommended modes fileModes mode_defModes mode_setupModes +modifying texmf.cnf in TeX LiveRuntime options Morgan, TimIntroduction Morris, BobIntroduction MPEDITEditor invocation -mpgraph.psmpost invocation -mpman.psmpost invocation +mpgraph.pdfmpost invocation +mpman.pdfmpost invocation mpostmpost invocation mpost, reason for name changeInstallation mpoutmpost invocation @@ -5826,8 +5869,10 @@ Previous: , Up: O octal character codes, in TCX filesTCX files offset for overflow labelsgftodvi invocation +OmegaTeX extensions online Metafont graphicsOnline Metafont graphics opcodes, showing DVIdvitype invocation +OpenType supportTeX extensions optical font scalingFont file formats option conventionsOption conventions originpktype invocation @@ -5837,6 +5882,7 @@ Previous: , Up: output files, written by TeX programstex invocation output_comment for DVI filestex invocation overflow label offsetgftodvi invocation +overflow, of runtime stackRuntime options
    P packet lengthpktype invocation @@ -5909,6 +5955,7 @@ Previous: , Up: property list, converting VF to virtualvftovp invocation ps2pkFont utilities available elsewhere psfonts.map, read by MetaPostmpost invocation +pTeXTeX extensions PXL files, explainedFont file formats pxtochFont utilities available elsewhere
    @@ -5921,6 +5968,7 @@ Previous: , Up: readonly directory, running TeX inOutput file location readonly directory, running TeX inOutput file location reallocation of arraysRuntime options +recursive expansion limitRuntime options redefined character substitutions\tracingcharsubdef reference pixelpktype invocation referencesReferences @@ -5936,16 +5984,17 @@ Previous: , Up: run length encoded bitmapspktype invocation run length encoded bitmapsgftype invocation runtime optionsRuntime options +runtime stack overflowRuntime options
    S scaled pixelspktype invocation scaled pixelsgftype invocation scaling of fontsFont file formats -scanned images of fontsFont utilities available elsewhere security, and output filestex invocation security, and shell escapesShell escapes security, and writempost invocation security, and \openouttex invocation +segmentation faultRuntime options shapesMetafont sharing memory dumpsHardware and memory dumps shell commands in TeXShell escapes @@ -5954,6 +6003,7 @@ Previous: , Up: siam.bstBasic BibTeX style files side bearingspktype invocation side bearingsgftype invocation +SIGSEGVRuntime options slant fontgftodvi invocation slides, producingFormats SliTeXFormats @@ -5983,6 +6033,7 @@ Previous: , Up: syntax of TCX filesTCX files system C library functionShell escapes system commandShell escapes +system fonts, usingTeX extensions
    T T1 encoding and ISO inputTCX files @@ -5991,6 +6042,7 @@ Previous: , Up: tangletangle invocation targets, additional MakeAdditional targets TCX character translation filesTCX files +technical illustrations, creatingMetaPost tekOnline Metafont graphics TektronixOnline Metafont graphics Tektronix 4014Online Metafont graphics @@ -6015,13 +6067,16 @@ Previous: , Up: texfonts.mapPath searching TexinfoFormats texmf.cnfPath searching +texmf.cnfRuntime options +texmf.cnf for editorsEditor invocation +texmf.cnf for shell escapesShell escapes texmfmp.cOnline Metafont graphics TEXMFOUTPUT, used for readingOutput file location TEXMFOUTPUT, used if ‘.’ unwritableOutput file location +texmf_casefold_searchRuntime options texputtex invocation TFM files, converting property lists topltotf invocation TFM files, explainedFont file formats -TFM files, memory forRuntime options TFM files, output by Metafontmf invocation TFM files, output by MetaPostmpost invocation TFM width of characterspktype invocation @@ -6044,8 +6099,10 @@ Previous: , Up: tripman.texTriptrap triptrap Make targetAdditional targets Troff, and MetaPostmpost invocation +troff, supported in MetaPostMetaPost Troff, WEB forWEB Trojan horses and TeX programstex invocation +TrueType supportTeX extensions TUGboat bibliographybibtex invocation Type 1 conversionFont utilities available elsewhere type design, personalInitial Metafont @@ -6054,16 +6111,17 @@ Previous: , Up: type programs, PKpktype invocation type programs, poolpooltype invocation typeface familiesMetafont -typeface specimen sheetsFont utilities available elsewhere typesettingTeX
    U UnicodeTeX extensions -UnicodeTeX extensions Unicode inputtex invocation +Unicode input, nativeTeX extensions unitermOnline Metafont graphics unsrt.bstBasic BibTeX style files +upTeXTeX extensions UTF-8 inputtex invocation +UTF-8 input, nativeTeX extensions
    V validation, of DVI filesdvitype invocation diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf index ce5fc40e67b..46af522e90d 100644 Binary files a/Master/texmf-dist/doc/web2c/web2c.pdf and b/Master/texmf-dist/doc/web2c/web2c.pdf differ diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt index 3d14881c325..c2b6b69dc56 100644 --- a/Master/tlpkg/doc/releng.txt +++ b/Master/tlpkg/doc/releng.txt @@ -224,10 +224,10 @@ B. Specifics for tlperl update: svn commit when ready ... C. Build a test ISO image for initial TeX Collection testing: - In cron.tl, set images_frozen=false. In tl-update-images, ensure V= the new YYYY and target=/.../test - Update /home/ftp/texlive/Images/test/README. - After successful image build, email tldistro@tug.org for info/review. + env images_frozen=false cron.pretest + After successful image build, update /home/ftp/texlive/Images/test/README + and email tldistro@tug.org for info/review. Can disable image building again after the initial build for a while. M. As pretest proceeds, update the doc: @@ -238,24 +238,25 @@ M. As pretest proceeds, update the doc: update "Builders of the binaries" and "Translators of this manual", and changes throughout if behavior has changed. Update tlbuild.texi text, then - W=.../Work + W=.../Build/source/Work make -C $W/doc script-links tlbuild-incl.texi readme-files readme-install cd .../Build/source Consider updates of core man pages in Build/source/texk/web2c/man. Remake updmap,fmtutil man pages with help2man: + tm=.../Master make -C $W/texk/texlive/tl_support xupdmap.1 xfmtutil.1 x1=`(unset CDPATH; cd $Master/texmf-dist/doc/man/man1; pwd)` They must be moved from /tmp into Master by hand: mv /tmp/xupdmap.1 $x1/updmap.1 mv /tmp/xfmtutil.1 $x1/fmtutil.1 - Also update ~www/texlive/doc/*.html: + Also update them in ~www/texlive/doc/*.html: groff -mandoc -Thtml $x1/updmap.1 >$lw/doc/updmap.html groff -mandoc -Thtml $x1/fmtutil.1 >$lw/doc/fmtutil.html While we're here, let's update the other generated html files: pod2html --cachedir=/tmp $xx/tlmgr.pl >$lw/doc/tlmgr.html - pod2html --cachedir=/tmp $Master/install-tl >$lw/doc/install-tl.html + pod2html --cachedir=/tmp $tm/install-tl >$lw/doc/install-tl.html Update copies in the Master tree (also done nightly in tl-update-auto): - cp $lw/doc/{tlmgr,install-tl}.html $Master/texmf-dist/doc/texlive + cp $lw/doc/{tlmgr,install-tl}.html $tm/texmf-dist/doc/texlive Man pages from Build to Master (after doing a build): tl-update-man # consider removals from output, if any binaries are gone # check /tmp/so.rules against man1/Makefile, update if needed. @@ -266,7 +267,7 @@ M. As pretest proceeds, update the doc: svn add `!!` Texinfo manuals from Build to Master: tl-update-txi - Don't forget commit in texmf-dist/doc. + Don't forget commit everything in texmf-dist/doc. N. Really test during pretest (really! don't leave it for Knuth to do!): .fmt's sharable across endian-different platforms (including luatex). -- cgit v1.2.3