summaryrefslogtreecommitdiff
path: root/Build/source/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-09-28 21:45:20 +0000
committerKarl Berry <karl@freefriends.org>2021-09-28 21:45:20 +0000
commit45194e1f2a32e93e5d01fe694ff7b37563c4c45e (patch)
tree9b39a7c2d9c57f2ef56caffe582666bc718a115f /Build/source/doc
parent6053124b74560b39d832852a190f83897d227075 (diff)
hishrink yacc/lex build (attempted) fixes
git-svn-id: svn://tug.org/texlive/trunk@60644 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/doc')
-rw-r--r--Build/source/doc/build-tools.txt2
-rw-r--r--Build/source/doc/tlbuild.info804
-rw-r--r--Build/source/doc/tlbuild.texi13
3 files changed, 418 insertions, 401 deletions
diff --git a/Build/source/doc/build-tools.txt b/Build/source/doc/build-tools.txt
index 05f304e2894..4c98a5a988d 100644
--- a/Build/source/doc/build-tools.txt
+++ b/Build/source/doc/build-tools.txt
@@ -1,6 +1,6 @@
autoconf (GNU Autoconf) 2.71
automake (GNU automake) 1.16.4
-bison (GNU Bison) 3.7.5
+bison (GNU Bison) 3.8.2
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.19
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index d33201125fc..69b4d32b146 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -59,7 +59,8 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev:
1 Introduction
**************
-This manual (dated July 2021) corresponds to the TeX Live 2021 release.
+This manual (dated September 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)
@@ -765,7 +766,7 @@ many extra hassles, so don't do that, tempting as it may be.
autoconf (GNU Autoconf) 2.71
automake (GNU automake) 1.16.4
- bison (GNU Bison) 3.7.5
+ bison (GNU Bison) 3.8.2
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.19
@@ -1405,7 +1406,7 @@ Adding a new TeX engine is not completely different from adding a
program, but it's not all that similar, either. In this case, the main
work is done by creating a new subdirectory of 'texk/web2c/' for the
engine. The subdirectory is conventionally named ending in 'dir', like
-'pdftexdir' and 'xetexdir'.
+'pdftexdir' and 'xetexdir', to avoid clashes with executable names.
The source files for the new engine should be put in this
'NEWENGINEdir' subdirectory. Also, a file
@@ -1425,6 +1426,13 @@ libraries requires.
LuaTeX. Of course, every engine will have its own unique features and
requirements, so existing examples will only take you so far.
+ Web2c is built as one "package", with each subdirectory's '.am'
+fragment inserted with an Automake 'include'. This means that, for
+instance, '$(srcdir)' is '.../web2c', not '.../webdir/enginedir'. It is
+a difficult setup to come to terms with, but the alternative is to
+recurse into each engine subdirectory, and that would be far worse
+(*note (automake)Directories::).
+

File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a new TeX-specific library module, Prev: Adding a new engine, Up: Extending TeX Live
@@ -5951,401 +5959,401 @@ Index
Tag Table:
Node: Top1208
Node: Introduction2118
-Node: Overview of build system3942
-Node: Prerequisites5993
-Node: Building8589
-Node: Build iteration9975
-Node: Build problems11016
-Node: Build in parallel11470
-Node: Build distribution12074
-Node: Build one package12722
-Node: Build one engine16496
-Node: Cross compilation18179
-Node: Cross configuring19459
-Node: Cross problems21136
-Node: Installing22798
-Node: Installation directories23818
-Node: Linked scripts25636
-Node: Distro builds27127
-Node: Layout and infrastructure29503
-Node: Build system tools30334
-Node: Top-level directories32551
-Node: Autoconf macros34787
-Node: General setup macros35549
-Node: Macros for programs36424
-Node: Macros for compilers37225
-Node: Macros for libraries38633
-Node: Macros for library and header flags39059
-Node: Macros for Windows40970
-Node: Library modules42557
-Node: png library43046
-Node: zlib library45394
-Node: freetype library45909
-Node: kpathsea library46605
-Node: Program modules47984
-Node: t1utils package48412
-Node: xindy package48957
-Node: xdvik package50073
-Node: asymptote51132
-Node: Extending TeX Live51628
-Node: Adding a new program module52435
-Node: Adding a new engine57198
-Node: Adding a new generic library module58567
-Node: Adding a new TeX-specific library module60788
-Node: Configure options61486
-Node: Global configure options62867
-Node: --disable-native-texlive-build63409
-Node: --prefix --bindir ...64371
-Node: --disable-largefile64911
-Node: --disable-missing65453
-Node: --enable-compiler-warnings=LEVEL65854
-Node: --enable-cxx-runtime-hack66510
-Node: --enable-maintainer-mode66930
-Node: --enable-multiplatform67459
-Node: --enable-shared68032
-Node: --enable-silent-rules68403
-Node: --without-ln-s68855
-Node: --without-x69202
-Node: Program-specific configure options69390
-Node: --enable-PROG --disable-PROG70033
-Node: --disable-all-pkgs70306
-Node: Configure options for texk/web2c71089
-Node: Configure options for texk/bibtex-x73627
-Node: Configure options for texk/dvipdfm-x74170
-Node: Configure options for texk/dvisvgm74946
-Node: Configure options for texk/texlive75827
-Node: Configure options for texk/xdvik76248
-Node: Configure options for utils/xindy76869
-Node: Library-specific configure options77759
-Node: Configure options for kpathsea78720
-Node: Variables for configure79424
-Node: Coding conventions80850
-Node: Declarations and definitions81565
-Node: Const83739
-Node: Continuous integration85603
-Node: Transfer from Subversion to Github86267
-Node: Automatic update of the Git mirror88429
-Node: CI testing on Travis-CI89011
-Node: Releases on Github89720
-Node: install-tl90160
-Node: install-tl NAME90529
-Node: install-tl SYNOPSIS90687
-Node: install-tl DESCRIPTION90945
-Node: install-tl REFERENCES92005
-Node: install-tl OPTIONS92529
-Ref: install-tl *-gui* [[=]_module_]92870
-Ref: install-tl text93078
-Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)93263
-Ref: install-tl *-no-gui*93895
-Ref: install-tl *-lang* _llcode_93985
-Ref: install-tl *-repository* _url|path_94609
-Ref: install-tl *-select-repository*95498
-Ref: install-tl *-all-options*95916
-Ref: install-tl *-custom-bin* _path_96171
-Ref: install-tl *-debug-translation*97005
-Ref: install-tl *-force-platform* _platform_97281
-Ref: install-tl *-help*, *--help*, *-?*97525
-Ref: install-tl *-in-place*97938
-Ref: install-tl *-init-from-profile* _profile_file_98483
-Ref: install-tl *-logfile* _file_98752
-Ref: install-tl *-no-cls*99103
-Ref: install-tl *-no-persistent-downloads*99251
-Ref: install-tl *-persistent-downloads*99276
-Ref: install-tl *-no-verify-downloads*99894
-Ref: install-tl *-non-admin*100257
-Ref: install-tl *-portable*100350
-Ref: install-tl *-print-platform*100489
-Ref: install-tl *-profile* _profile_file_100687
-Ref: install-tl *-q*100908
-Ref: install-tl *-scheme* _scheme_100970
-Ref: install-tl *-v*101444
-Ref: install-tl *-version*, *--version*101599
-Node: install-tl PROFILES101733
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)104599
-Ref: install-tl instopt_adjustrepo (default 1)104675
-Ref: install-tl instopt_letter (default 0)104812
-Ref: install-tl instopt_portable (default 0)104903
-Ref: install-tl instopt_write18_restricted (default 1)104999
-Node: install-tl ENVIRONMENT VARIABLES106338
-Ref: install-tl TEXLIVE_DOWNLOADER106716
-Ref: install-tl TL_DOWNLOAD_PROGRAM106739
-Ref: install-tl TL_DOWNLOAD_ARGS106759
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK106963
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE107165
-Ref: install-tl TEXLIVE_INSTALL_NO_RESUME107274
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME107426
-Ref: install-tl TEXLIVE_INSTALL_PAPER107547
-Ref: install-tl TEXLIVE_INSTALL_PREFIX107693
-Ref: install-tl TEXLIVE_INSTALL_TEXDIR107719
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG107750
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR107778
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME107807
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL107837
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG107871
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR107902
-Ref: install-tl NOPERLDOC108273
-Node: install-tl AUTHORS AND COPYRIGHT108337
-Node: tlmgr108750
-Node: tlmgr NAME109235
-Node: tlmgr SYNOPSIS109367
-Node: tlmgr DESCRIPTION109557
-Node: tlmgr EXAMPLES110656
-Ref: tlmgr tlmgr option repository ctan110907
-Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet110980
-Ref: tlmgr tlmgr update --list111585
-Ref: tlmgr tlmgr update --all111678
-Ref: tlmgr tlmgr info _what_111835
-Node: tlmgr OPTIONS112097
-Ref: tlmgr *--repository* _url|path_112617
-Ref: tlmgr /some/local/dir113803
-Ref: tlmgr file:/some/local/dir113832
-Ref: tlmgr ctan113905
-Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet113959
-Ref: tlmgr http://server/path/to/tlnet114300
-Ref: tlmgr https://server/path/to/tlnet114681
-Ref: tlmgr ftp://server/path/to/tlnet115149
-Ref: tlmgr user@machine:/path/to/tlnet115281
-Ref: tlmgr scp://user@machine/path/to/tlnet115322
-Ref: tlmgr ssh://user@machine/path/to/tlnet115363
-Ref: tlmgr *--gui* [_action_]115756
-Ref: tlmgr *--gui-lang* _llcode_116569
-Ref: tlmgr *--command-logfile* _file_117310
-Ref: tlmgr *--debug-translation*117576
-Ref: tlmgr *--machine-readable*117779
-Ref: tlmgr *--no-execute-actions*118047
-Ref: tlmgr *--package-logfile* _file_118240
-Ref: tlmgr *--pause*118494
-Ref: tlmgr *--persistent-downloads*118649
-Ref: tlmgr *--no-persistent-downloads*118677
-Ref: tlmgr *--pin-file*119171
-Ref: tlmgr *--usermode*119389
-Ref: tlmgr *--usertree* _dir_119509
-Ref: tlmgr *--verify-repo=[none|main|all]*119635
-Node: tlmgr ACTIONS120534
-Node: tlmgr help121395
-Node: tlmgr version121872
-Node: tlmgr backup122135
-Ref: tlmgr *backup [_option_...] --all*122306
-Ref: tlmgr *backup [_option_...] _pkg_...*122339
-Ref: tlmgr *--backupdir* _directory_123405
-Ref: tlmgr *--all*123622
-Ref: tlmgr *--clean*[=_N_]123874
-Ref: tlmgr *--dry-run*124201
-Node: tlmgr candidates _pkg_124331
-Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]124686
-Ref: tlmgr *depends*125200
-Ref: tlmgr *executes*125542
-Ref: tlmgr *files*125657
-Ref: tlmgr *runfiles*125793
-Ref: tlmgr *texmfdbs*125930
-Ref: tlmgr - all items in TEXMFDBS have the !! prefix.126160
-Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).126236
-Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.126301
-Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.126376
-Ref: tlmgr *--use-svn*126401
-Node: tlmgr conf126542
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*126830
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*126894
-Node: tlmgr dump-tlpdb [_option_...] [--json]129309
-Ref: tlmgr *--local*129742
-Ref: tlmgr *--remote*129781
-Ref: tlmgr *--json*129819
-Node: tlmgr generate130390
-Ref: tlmgr *generate [_option_...] language*130586
-Ref: tlmgr *generate [_option_...] language.dat*130625
-Ref: tlmgr *generate [_option_...] language.def*130664
-Ref: tlmgr *generate [_option_...] language.dat.lua*130707
-Ref: tlmgr *--dest* _output_file_133034
-Ref: tlmgr *--localcfg* _local_conf_file_133610
-Ref: tlmgr *--rebuild-sys*133733
-Node: tlmgr gui134548
-Node: tlmgr info134726
-Ref: tlmgr *info [_option_...] _pkg_...*134888
-Ref: tlmgr *info [_option_...] collections*134922
-Ref: tlmgr *info [_option_...] schemes*134952
-Ref: tlmgr *--list*136482
-Ref: tlmgr *--only-installed*136796
-Ref: tlmgr *--only-remote*136984
-Ref: tlmgr *--data item1,item2,...*137288
-Ref: tlmgr *--json* 1138651
-Node: tlmgr init-usertree139034
-Node: tlmgr install [_option_...] _pkg_...139415
-Ref: tlmgr *--dry-run* 1139923
-Ref: tlmgr *--file*140040
-Ref: tlmgr *--force*140262
-Ref: tlmgr *--no-depends*140482
-Ref: tlmgr *--no-depends-at-all*140641
-Ref: tlmgr *--reinstall*141041
-Ref: tlmgr *--with-doc*141419
-Ref: tlmgr *--with-src*141432
-Node: tlmgr key142160
-Ref: tlmgr *key list*142318
-Ref: tlmgr *key add _file_*142336
-Ref: tlmgr *key remove _keyid_*142358
-Node: tlmgr list142952
-Node: tlmgr option143114
-Ref: tlmgr *option [--json] [show]*143269
-Ref: tlmgr *option [--json] showall|help*143300
-Ref: tlmgr *option _key_ [_value_]*143326
-Node: tlmgr paper147905
-Ref: tlmgr *paper [a4|letter]*148054
-Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>148130
-Ref: tlmgr *paper --json*148145
-Node: tlmgr path149360
-Ref: tlmgr *path [--w32mode=user|admin] add*149521
-Ref: tlmgr *path [--w32mode=user|admin] remove*149558
-Node: tlmgr pinning151043
-Ref: tlmgr pinning show151284
-Ref: tlmgr pinning add _repo_ _pkgglob_...151357
-Ref: tlmgr pinning remove _repo_ _pkgglob_...151476
-Ref: tlmgr pinning remove _repo_ --all151629
-Node: tlmgr platform151683
-Ref: tlmgr *platform list|add|remove _platform_...*151869
-Ref: tlmgr *platform set _platform_*151896
-Ref: tlmgr *platform set auto*151917
-Ref: tlmgr *--dry-run* 2152794
-Node: tlmgr postaction152913
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*153143
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*153217
-Ref: tlmgr *--w32mode=[user|admin]*153532
-Ref: tlmgr *--fileassocmode=[1|2]*153948
-Ref: tlmgr *--all* 1154233
-Node: tlmgr print-platform154288
-Node: tlmgr print-platform-info154619
-Node: tlmgr remove [_option_...] _pkg_...154919
-Ref: tlmgr *--all* 2155403
-Ref: tlmgr *--backup*155513
-Ref: tlmgr *--backupdir* _directory_ 1155539
-Ref: tlmgr *--no-depends* 1155944
-Ref: tlmgr *--no-depends-at-all* 1156006
-Ref: tlmgr *--force* 1156109
-Ref: tlmgr *--dry-run* 3156582
-Node: tlmgr repository156918
-Ref: tlmgr *repository list*157106
-Ref: tlmgr *repository list _path|url|tag_*157140
-Ref: tlmgr *repository add _path_ [_tag_]*157173
-Ref: tlmgr *repository remove _path|tag_*157205
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*157259
-Ref: tlmgr *repository status*157280
-Ref: tlmgr The tag (which can be the same as the url);158507
-Node: tlmgr restore158985
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*159164
-Ref: tlmgr *restore [_option_...] --all*159194
-Ref: tlmgr *--all* 3159894
-Ref: tlmgr *--backupdir* _directory_ 2160108
-Ref: tlmgr *--dry-run* 4160289
-Ref: tlmgr *--force* 2160421
-Ref: tlmgr *--json* 2160467
-Node: tlmgr search160794
-Ref: tlmgr *search [_option_...] _what_*160958
-Ref: tlmgr *search [_option_...] --file _what_*160995
-Ref: tlmgr *search [_option_...] --all _what_*161031
-Ref: tlmgr *--file* 1161251
-Ref: tlmgr *--all* 4161313
-Ref: tlmgr *--global*161402
-Ref: tlmgr *--word*161529
-Node: tlmgr shell161844
-Ref: tlmgr protocol162579
-Ref: tlmgr help 1162643
-Ref: tlmgr version 1162696
-Ref: tlmgr quit, end, bye, byebye, EOF162764
-Ref: tlmgr restart162785
-Ref: tlmgr load [local|remote]162908
-Ref: tlmgr save162978
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]163101
-Node: tlmgr show163702
-Node: tlmgr uninstall163869
-Node: tlmgr update [_option_...] [_pkg_...]164099
-Ref: tlmgr *--all* 5164470
-Ref: tlmgr *--self*166649
-Ref: tlmgr *--dry-run* 5167413
-Ref: tlmgr *--list* [_pkg_]167590
-Ref: tlmgr *--exclude* _pkg_168279
-Ref: tlmgr *--no-auto-remove* [_pkg_...]169079
-Ref: tlmgr *--no-auto-install* [_pkg_...]169563
-Ref: tlmgr *--reinstall-forcibly-removed*170325
-Ref: tlmgr *--backup* 1170860
-Ref: tlmgr *--backupdir* _directory_ 3170886
-Ref: tlmgr *--no-depends* 2172052
-Ref: tlmgr *--no-depends-at-all* 2172255
-Ref: tlmgr *--force* 3172358
-Node: tlmgr CONFIGURATION FILE FOR TLMGR173349
-Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.174356
-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.174493
-Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.174575
-Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).174629
-Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.174709
-Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.174789
-Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.174879
-Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.175027
-Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.175103
-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).175372
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION176460
-Node: tlmgr Configuration of GnuPG invocation178633
-Node: tlmgr USER MODE179271
-Node: tlmgr User mode install182117
-Node: tlmgr User mode backup, restore, remove, update183261
-Node: tlmgr User mode generate, option, paper183703
-Node: tlmgr MULTIPLE REPOSITORIES184079
-Node: tlmgr Pinning185808
-Node: tlmgr GUI FOR TLMGR187731
-Node: tlmgr Main display189380
-Node: tlmgr Display configuration area189632
-Ref: tlmgr Status189993
-Ref: tlmgr Category190157
-Ref: tlmgr Match190343
-Ref: tlmgr Selection190524
-Ref: tlmgr Display configuration buttons190728
-Node: tlmgr Package list area190911
-Ref: tlmgr a checkbox191495
-Ref: tlmgr package name191631
-Ref: tlmgr local revision (and version)191730
-Ref: tlmgr remote revision (and version)192105
-Ref: tlmgr short description192402
-Node: tlmgr Main display action buttons192447
-Ref: tlmgr Update all installed192713
-Ref: tlmgr Update193085
-Ref: tlmgr Install193135
-Ref: tlmgr Remove193321
-Ref: tlmgr Backup193499
-Node: tlmgr Menu bar193656
-Ref: tlmgr tlmgr menu193879
-Ref: tlmgr Options menu194187
-Ref: tlmgr Actions menu195270
-Ref: tlmgr Help menu195698
-Node: tlmgr GUI options195832
-Ref: tlmgr -background _color_196078
-Ref: tlmgr -font " _fontname_ _fontsize_ "196143
-Ref: tlmgr -foreground _color_196301
-Ref: tlmgr -geometry _geomspec_196353
-Ref: tlmgr -xrm _xresource_196545
-Node: tlmgr MACHINE-READABLE OUTPUT196814
-Node: tlmgr Machine-readable update and install output197624
-Ref: tlmgr location-url _location_198900
-Ref: tlmgr total-bytes _count_199116
-Ref: tlmgr _pkgname_199526
-Ref: tlmgr _status_199736
-Ref: tlmgr d199814
-Ref: tlmgr f199874
-Ref: tlmgr u200053
-Ref: tlmgr r200099
-Ref: tlmgr a200222
-Ref: tlmgr i200400
-Ref: tlmgr I200519
-Ref: tlmgr _localrev_200621
-Ref: tlmgr _serverrev_200728
-Ref: tlmgr _size_200840
-Ref: tlmgr _runtime_201009
-Ref: tlmgr _esttot_201079
-Node: tlmgr Machine-readable option output201112
-Node: tlmgr ENVIRONMENT VARIABLES201624
-Ref: tlmgr TEXLIVE_COMPRESSOR202135
-Ref: tlmgr TEXLIVE_DOWNLOADER202983
-Ref: tlmgr TL_DOWNLOAD_PROGRAM203006
-Ref: tlmgr TL_DOWNLOAD_ARGS203026
-Ref: tlmgr TEXLIVE_PREFER_OWN204052
-Node: tlmgr AUTHORS AND COPYRIGHT204876
-Node: Index205274
+Node: Overview of build system3947
+Node: Prerequisites5998
+Node: Building8594
+Node: Build iteration9980
+Node: Build problems11021
+Node: Build in parallel11475
+Node: Build distribution12079
+Node: Build one package12727
+Node: Build one engine16501
+Node: Cross compilation18184
+Node: Cross configuring19464
+Node: Cross problems21141
+Node: Installing22803
+Node: Installation directories23823
+Node: Linked scripts25641
+Node: Distro builds27132
+Node: Layout and infrastructure29508
+Node: Build system tools30339
+Node: Top-level directories32556
+Node: Autoconf macros34792
+Node: General setup macros35554
+Node: Macros for programs36429
+Node: Macros for compilers37230
+Node: Macros for libraries38638
+Node: Macros for library and header flags39064
+Node: Macros for Windows40975
+Node: Library modules42562
+Node: png library43051
+Node: zlib library45399
+Node: freetype library45914
+Node: kpathsea library46610
+Node: Program modules47989
+Node: t1utils package48417
+Node: xindy package48962
+Node: xdvik package50078
+Node: asymptote51137
+Node: Extending TeX Live51633
+Node: Adding a new program module52440
+Node: Adding a new engine57203
+Node: Adding a new generic library module58988
+Node: Adding a new TeX-specific library module61209
+Node: Configure options61907
+Node: Global configure options63288
+Node: --disable-native-texlive-build63830
+Node: --prefix --bindir ...64792
+Node: --disable-largefile65332
+Node: --disable-missing65874
+Node: --enable-compiler-warnings=LEVEL66275
+Node: --enable-cxx-runtime-hack66931
+Node: --enable-maintainer-mode67351
+Node: --enable-multiplatform67880
+Node: --enable-shared68453
+Node: --enable-silent-rules68824
+Node: --without-ln-s69276
+Node: --without-x69623
+Node: Program-specific configure options69811
+Node: --enable-PROG --disable-PROG70454
+Node: --disable-all-pkgs70727
+Node: Configure options for texk/web2c71510
+Node: Configure options for texk/bibtex-x74048
+Node: Configure options for texk/dvipdfm-x74591
+Node: Configure options for texk/dvisvgm75367
+Node: Configure options for texk/texlive76248
+Node: Configure options for texk/xdvik76669
+Node: Configure options for utils/xindy77290
+Node: Library-specific configure options78180
+Node: Configure options for kpathsea79141
+Node: Variables for configure79845
+Node: Coding conventions81271
+Node: Declarations and definitions81986
+Node: Const84160
+Node: Continuous integration86024
+Node: Transfer from Subversion to Github86688
+Node: Automatic update of the Git mirror88850
+Node: CI testing on Travis-CI89432
+Node: Releases on Github90141
+Node: install-tl90581
+Node: install-tl NAME90950
+Node: install-tl SYNOPSIS91108
+Node: install-tl DESCRIPTION91366
+Node: install-tl REFERENCES92426
+Node: install-tl OPTIONS92950
+Ref: install-tl *-gui* [[=]_module_]93291
+Ref: install-tl text93499
+Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)93684
+Ref: install-tl *-no-gui*94316
+Ref: install-tl *-lang* _llcode_94406
+Ref: install-tl *-repository* _url|path_95030
+Ref: install-tl *-select-repository*95919
+Ref: install-tl *-all-options*96337
+Ref: install-tl *-custom-bin* _path_96592
+Ref: install-tl *-debug-translation*97426
+Ref: install-tl *-force-platform* _platform_97702
+Ref: install-tl *-help*, *--help*, *-?*97946
+Ref: install-tl *-in-place*98359
+Ref: install-tl *-init-from-profile* _profile_file_98904
+Ref: install-tl *-logfile* _file_99173
+Ref: install-tl *-no-cls*99524
+Ref: install-tl *-no-persistent-downloads*99672
+Ref: install-tl *-persistent-downloads*99697
+Ref: install-tl *-no-verify-downloads*100315
+Ref: install-tl *-non-admin*100678
+Ref: install-tl *-portable*100771
+Ref: install-tl *-print-platform*100910
+Ref: install-tl *-profile* _profile_file_101108
+Ref: install-tl *-q*101329
+Ref: install-tl *-scheme* _scheme_101391
+Ref: install-tl *-v*101865
+Ref: install-tl *-version*, *--version*102020
+Node: install-tl PROFILES102154
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)105020
+Ref: install-tl instopt_adjustrepo (default 1)105096
+Ref: install-tl instopt_letter (default 0)105233
+Ref: install-tl instopt_portable (default 0)105324
+Ref: install-tl instopt_write18_restricted (default 1)105420
+Node: install-tl ENVIRONMENT VARIABLES106759
+Ref: install-tl TEXLIVE_DOWNLOADER107137
+Ref: install-tl TL_DOWNLOAD_PROGRAM107160
+Ref: install-tl TL_DOWNLOAD_ARGS107180
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK107384
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE107586
+Ref: install-tl TEXLIVE_INSTALL_NO_RESUME107695
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME107847
+Ref: install-tl TEXLIVE_INSTALL_PAPER107968
+Ref: install-tl TEXLIVE_INSTALL_PREFIX108114
+Ref: install-tl TEXLIVE_INSTALL_TEXDIR108140
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG108171
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR108199
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME108228
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL108258
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG108292
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR108323
+Ref: install-tl NOPERLDOC108694
+Node: install-tl AUTHORS AND COPYRIGHT108758
+Node: tlmgr109171
+Node: tlmgr NAME109656
+Node: tlmgr SYNOPSIS109788
+Node: tlmgr DESCRIPTION109978
+Node: tlmgr EXAMPLES111077
+Ref: tlmgr tlmgr option repository ctan111328
+Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet111401
+Ref: tlmgr tlmgr update --list112006
+Ref: tlmgr tlmgr update --all112099
+Ref: tlmgr tlmgr info _what_112256
+Node: tlmgr OPTIONS112518
+Ref: tlmgr *--repository* _url|path_113038
+Ref: tlmgr /some/local/dir114224
+Ref: tlmgr file:/some/local/dir114253
+Ref: tlmgr ctan114326
+Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet114380
+Ref: tlmgr http://server/path/to/tlnet114721
+Ref: tlmgr https://server/path/to/tlnet115102
+Ref: tlmgr ftp://server/path/to/tlnet115570
+Ref: tlmgr user@machine:/path/to/tlnet115702
+Ref: tlmgr scp://user@machine/path/to/tlnet115743
+Ref: tlmgr ssh://user@machine/path/to/tlnet115784
+Ref: tlmgr *--gui* [_action_]116177
+Ref: tlmgr *--gui-lang* _llcode_116990
+Ref: tlmgr *--command-logfile* _file_117731
+Ref: tlmgr *--debug-translation*117997
+Ref: tlmgr *--machine-readable*118200
+Ref: tlmgr *--no-execute-actions*118468
+Ref: tlmgr *--package-logfile* _file_118661
+Ref: tlmgr *--pause*118915
+Ref: tlmgr *--persistent-downloads*119070
+Ref: tlmgr *--no-persistent-downloads*119098
+Ref: tlmgr *--pin-file*119592
+Ref: tlmgr *--usermode*119810
+Ref: tlmgr *--usertree* _dir_119930
+Ref: tlmgr *--verify-repo=[none|main|all]*120056
+Node: tlmgr ACTIONS120955
+Node: tlmgr help121816
+Node: tlmgr version122293
+Node: tlmgr backup122556
+Ref: tlmgr *backup [_option_...] --all*122727
+Ref: tlmgr *backup [_option_...] _pkg_...*122760
+Ref: tlmgr *--backupdir* _directory_123826
+Ref: tlmgr *--all*124043
+Ref: tlmgr *--clean*[=_N_]124295
+Ref: tlmgr *--dry-run*124622
+Node: tlmgr candidates _pkg_124752
+Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]125107
+Ref: tlmgr *depends*125621
+Ref: tlmgr *executes*125963
+Ref: tlmgr *files*126078
+Ref: tlmgr *runfiles*126214
+Ref: tlmgr *texmfdbs*126351
+Ref: tlmgr - all items in TEXMFDBS have the !! prefix.126581
+Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).126657
+Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.126722
+Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.126797
+Ref: tlmgr *--use-svn*126822
+Node: tlmgr conf126963
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*127251
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*127315
+Node: tlmgr dump-tlpdb [_option_...] [--json]129730
+Ref: tlmgr *--local*130163
+Ref: tlmgr *--remote*130202
+Ref: tlmgr *--json*130240
+Node: tlmgr generate130811
+Ref: tlmgr *generate [_option_...] language*131007
+Ref: tlmgr *generate [_option_...] language.dat*131046
+Ref: tlmgr *generate [_option_...] language.def*131085
+Ref: tlmgr *generate [_option_...] language.dat.lua*131128
+Ref: tlmgr *--dest* _output_file_133455
+Ref: tlmgr *--localcfg* _local_conf_file_134031
+Ref: tlmgr *--rebuild-sys*134154
+Node: tlmgr gui134969
+Node: tlmgr info135147
+Ref: tlmgr *info [_option_...] _pkg_...*135309
+Ref: tlmgr *info [_option_...] collections*135343
+Ref: tlmgr *info [_option_...] schemes*135373
+Ref: tlmgr *--list*136903
+Ref: tlmgr *--only-installed*137217
+Ref: tlmgr *--only-remote*137405
+Ref: tlmgr *--data item1,item2,...*137709
+Ref: tlmgr *--json* 1139072
+Node: tlmgr init-usertree139455
+Node: tlmgr install [_option_...] _pkg_...139836
+Ref: tlmgr *--dry-run* 1140344
+Ref: tlmgr *--file*140461
+Ref: tlmgr *--force*140683
+Ref: tlmgr *--no-depends*140903
+Ref: tlmgr *--no-depends-at-all*141062
+Ref: tlmgr *--reinstall*141462
+Ref: tlmgr *--with-doc*141840
+Ref: tlmgr *--with-src*141853
+Node: tlmgr key142581
+Ref: tlmgr *key list*142739
+Ref: tlmgr *key add _file_*142757
+Ref: tlmgr *key remove _keyid_*142779
+Node: tlmgr list143373
+Node: tlmgr option143535
+Ref: tlmgr *option [--json] [show]*143690
+Ref: tlmgr *option [--json] showall|help*143721
+Ref: tlmgr *option _key_ [_value_]*143747
+Node: tlmgr paper148326
+Ref: tlmgr *paper [a4|letter]*148475
+Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>148551
+Ref: tlmgr *paper --json*148566
+Node: tlmgr path149781
+Ref: tlmgr *path [--w32mode=user|admin] add*149942
+Ref: tlmgr *path [--w32mode=user|admin] remove*149979
+Node: tlmgr pinning151464
+Ref: tlmgr pinning show151705
+Ref: tlmgr pinning add _repo_ _pkgglob_...151778
+Ref: tlmgr pinning remove _repo_ _pkgglob_...151897
+Ref: tlmgr pinning remove _repo_ --all152050
+Node: tlmgr platform152104
+Ref: tlmgr *platform list|add|remove _platform_...*152290
+Ref: tlmgr *platform set _platform_*152317
+Ref: tlmgr *platform set auto*152338
+Ref: tlmgr *--dry-run* 2153215
+Node: tlmgr postaction153334
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*153564
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*153638
+Ref: tlmgr *--w32mode=[user|admin]*153953
+Ref: tlmgr *--fileassocmode=[1|2]*154369
+Ref: tlmgr *--all* 1154654
+Node: tlmgr print-platform154709
+Node: tlmgr print-platform-info155040
+Node: tlmgr remove [_option_...] _pkg_...155340
+Ref: tlmgr *--all* 2155824
+Ref: tlmgr *--backup*155934
+Ref: tlmgr *--backupdir* _directory_ 1155960
+Ref: tlmgr *--no-depends* 1156365
+Ref: tlmgr *--no-depends-at-all* 1156427
+Ref: tlmgr *--force* 1156530
+Ref: tlmgr *--dry-run* 3157003
+Node: tlmgr repository157339
+Ref: tlmgr *repository list*157527
+Ref: tlmgr *repository list _path|url|tag_*157561
+Ref: tlmgr *repository add _path_ [_tag_]*157594
+Ref: tlmgr *repository remove _path|tag_*157626
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*157680
+Ref: tlmgr *repository status*157701
+Ref: tlmgr The tag (which can be the same as the url);158928
+Node: tlmgr restore159406
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*159585
+Ref: tlmgr *restore [_option_...] --all*159615
+Ref: tlmgr *--all* 3160315
+Ref: tlmgr *--backupdir* _directory_ 2160529
+Ref: tlmgr *--dry-run* 4160710
+Ref: tlmgr *--force* 2160842
+Ref: tlmgr *--json* 2160888
+Node: tlmgr search161215
+Ref: tlmgr *search [_option_...] _what_*161379
+Ref: tlmgr *search [_option_...] --file _what_*161416
+Ref: tlmgr *search [_option_...] --all _what_*161452
+Ref: tlmgr *--file* 1161672
+Ref: tlmgr *--all* 4161734
+Ref: tlmgr *--global*161823
+Ref: tlmgr *--word*161950
+Node: tlmgr shell162265
+Ref: tlmgr protocol163000
+Ref: tlmgr help 1163064
+Ref: tlmgr version 1163117
+Ref: tlmgr quit, end, bye, byebye, EOF163185
+Ref: tlmgr restart163206
+Ref: tlmgr load [local|remote]163329
+Ref: tlmgr save163399
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]163522
+Node: tlmgr show164123
+Node: tlmgr uninstall164290
+Node: tlmgr update [_option_...] [_pkg_...]164520
+Ref: tlmgr *--all* 5164891
+Ref: tlmgr *--self*167070
+Ref: tlmgr *--dry-run* 5167834
+Ref: tlmgr *--list* [_pkg_]168011
+Ref: tlmgr *--exclude* _pkg_168700
+Ref: tlmgr *--no-auto-remove* [_pkg_...]169500
+Ref: tlmgr *--no-auto-install* [_pkg_...]169984
+Ref: tlmgr *--reinstall-forcibly-removed*170746
+Ref: tlmgr *--backup* 1171281
+Ref: tlmgr *--backupdir* _directory_ 3171307
+Ref: tlmgr *--no-depends* 2172473
+Ref: tlmgr *--no-depends-at-all* 2172676
+Ref: tlmgr *--force* 3172779
+Node: tlmgr CONFIGURATION FILE FOR TLMGR173770
+Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.174777
+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.174914
+Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.174996
+Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).175050
+Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.175130
+Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.175210
+Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.175300
+Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.175448
+Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.175524
+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).175793
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION176881
+Node: tlmgr Configuration of GnuPG invocation179054
+Node: tlmgr USER MODE179692
+Node: tlmgr User mode install182538
+Node: tlmgr User mode backup, restore, remove, update183682
+Node: tlmgr User mode generate, option, paper184124
+Node: tlmgr MULTIPLE REPOSITORIES184500
+Node: tlmgr Pinning186229
+Node: tlmgr GUI FOR TLMGR188152
+Node: tlmgr Main display189801
+Node: tlmgr Display configuration area190053
+Ref: tlmgr Status190414
+Ref: tlmgr Category190578
+Ref: tlmgr Match190764
+Ref: tlmgr Selection190945
+Ref: tlmgr Display configuration buttons191149
+Node: tlmgr Package list area191332
+Ref: tlmgr a checkbox191916
+Ref: tlmgr package name192052
+Ref: tlmgr local revision (and version)192151
+Ref: tlmgr remote revision (and version)192526
+Ref: tlmgr short description192823
+Node: tlmgr Main display action buttons192868
+Ref: tlmgr Update all installed193134
+Ref: tlmgr Update193506
+Ref: tlmgr Install193556
+Ref: tlmgr Remove193742
+Ref: tlmgr Backup193920
+Node: tlmgr Menu bar194077
+Ref: tlmgr tlmgr menu194300
+Ref: tlmgr Options menu194608
+Ref: tlmgr Actions menu195691
+Ref: tlmgr Help menu196119
+Node: tlmgr GUI options196253
+Ref: tlmgr -background _color_196499
+Ref: tlmgr -font " _fontname_ _fontsize_ "196564
+Ref: tlmgr -foreground _color_196722
+Ref: tlmgr -geometry _geomspec_196774
+Ref: tlmgr -xrm _xresource_196966
+Node: tlmgr MACHINE-READABLE OUTPUT197235
+Node: tlmgr Machine-readable update and install output198045
+Ref: tlmgr location-url _location_199321
+Ref: tlmgr total-bytes _count_199537
+Ref: tlmgr _pkgname_199947
+Ref: tlmgr _status_200157
+Ref: tlmgr d200235
+Ref: tlmgr f200295
+Ref: tlmgr u200474
+Ref: tlmgr r200520
+Ref: tlmgr a200643
+Ref: tlmgr i200821
+Ref: tlmgr I200940
+Ref: tlmgr _localrev_201042
+Ref: tlmgr _serverrev_201149
+Ref: tlmgr _size_201261
+Ref: tlmgr _runtime_201430
+Ref: tlmgr _esttot_201500
+Node: tlmgr Machine-readable option output201533
+Node: tlmgr ENVIRONMENT VARIABLES202045
+Ref: tlmgr TEXLIVE_COMPRESSOR202556
+Ref: tlmgr TEXLIVE_DOWNLOADER203404
+Ref: tlmgr TL_DOWNLOAD_PROGRAM203427
+Ref: tlmgr TL_DOWNLOAD_ARGS203447
+Ref: tlmgr TEXLIVE_PREFER_OWN204473
+Node: tlmgr AUTHORS AND COPYRIGHT205297
+Node: Index205695

End Tag Table
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 6084aa2af5c..5afbd68b925 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -2,7 +2,7 @@
@setfilename tlbuild.info
@set version 2021
-@set month-year July 2021
+@set month-year September 2021
@set mytitle Building @TeX{} Live (@value{version})
@settitle @value{mytitle}
@@ -1762,7 +1762,8 @@ Adding a new @TeX{} engine is not completely different from adding a
program, but it's not all that similar, either. In this case, the main
work is done by creating a new subdirectory of @file{texk/web2c/} for
the engine. The subdirectory is conventionally named ending in
-@file{dir}, like @file{pdftexdir} and @file{xetexdir}.
+@file{dir}, like @file{pdftexdir} and @file{xetexdir}, to avoid
+clashes with executable names.
The source files for the new engine should be put in this
@file{@var{newengine}dir} subdirectory. Also, a file
@@ -1784,6 +1785,14 @@ simpler than Lua@TeX{}. Of course, every engine will have its own
unique features and requirements, so existing examples will only take
you so far.
+Web2c is built as one ``package'', with each subdirectory's @file{.am}
+fragment inserted with an Automake @code{include}. This means that,
+for instance, @code{$(srcdir)} is @file{.../web2c}, not
+@file{.../webdir/enginedir}. It is a difficult setup to come to terms
+with, but the alternative is to recurse into each engine subdirectory,
+and that would be far worse (@pxref{Directories,,, automake, GNU
+Automake}).
+
@node Adding a new generic library module
@subsection Adding a new generic library module