(Build one engine): update doc

git-svn-id: svn://tug.org/texlive/trunk@56229 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 440 insertions, 411 deletions

diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog
index 6b1d04520af..d209dc0afd1 100644
--- a/Build/source/doc/ChangeLog
+++ b/Build/source/doc/ChangeLog
@@ -1,3 +1,8 @@
+2020-08-31  Karl Berry  <karl@freefriends.org>
+
+	* tlbuild.texi (Build one engine): rewrite procedure.
+	* build-tools.txt: bison 3.7.1.
+
 2020-05-14  Karl Berry  <karl@freefriends.org>
 
 	* tlbuild.texi: remove poppler references.
diff --git a/Build/source/doc/build-tools.txt b/Build/source/doc/build-tools.txt
index 44748a7b9b3..63ee94fd0c5 100644
--- a/Build/source/doc/build-tools.txt
+++ b/Build/source/doc/build-tools.txt
@@ -1,6 +1,6 @@
 autoconf (GNU Autoconf) 2.69
 automake (GNU automake) 1.16.2
-bison (GNU Bison) 3.6.1
+bison (GNU Bison) 3.7.1
 flex 2.6.0
 ltmain.sh (GNU libtool) 2.4.6
 m4 (GNU M4) 1.4.18
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index bf6cd3e0d89..ce386210a26 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -328,8 +328,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
 
@@ -409,19 +409,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
@@ -746,7 +758,7 @@ many extra hassles, so don't do that, tempting as it may be.
 
      autoconf (GNU Autoconf) 2.69
      automake (GNU automake) 1.16.2
-     bison (GNU Bison) 3.6.1
+     bison (GNU Bison) 3.7.1
      flex 2.6.0
      ltmain.sh (GNU libtool) 2.4.6
      m4 (GNU M4) 1.4.18
@@ -5854,392 +5866,392 @@ Node: Build problems11017
 Node: Build in parallel11471
 Node: Build distribution12075
 Node: Build one package12723
-Node: Build one engine16389
-Node: Cross compilation17438
-Node: Cross configuring18718
-Node: Cross problems20395
-Node: Installing22057
-Node: Installation directories23077
-Node: Linked scripts24895
-Node: Distro builds26386
-Node: Layout and infrastructure28762
-Node: Build system tools29593
-Node: Top-level directories31810
-Node: Autoconf macros34046
-Node: General setup macros34808
-Node: Macros for programs35683
-Node: Macros for compilers36484
-Node: Macros for libraries37892
-Node: Macros for library and header flags38318
-Node: Macros for Windows40229
-Node: Library modules41816
-Node: png library42305
-Node: zlib library44653
-Node: freetype library45168
-Node: kpathsea library45864
-Node: Program modules47243
-Node: t1utils package47671
-Node: xindy package48216
-Node: xdvik package49330
-Node: asymptote50389
-Node: Extending TeX Live50885
-Node: Adding a new program module51668
-Node: Adding a new generic library module55007
-Node: Adding a new TeX-specific library module57236
-Node: Configure options57934
-Node: Global configure options59315
-Node: --disable-native-texlive-build59857
-Node: --prefix --bindir ...60819
-Node: --disable-largefile61359
-Node: --disable-missing61901
-Node: --enable-compiler-warnings=LEVEL62302
-Node: --enable-cxx-runtime-hack62958
-Node: --enable-maintainer-mode63378
-Node: --enable-multiplatform63907
-Node: --enable-shared64480
-Node: --enable-silent-rules64851
-Node: --without-ln-s65303
-Node: --without-x65650
-Node: Program-specific configure options65838
-Node: --enable-PROG --disable-PROG66481
-Node: --disable-all-pkgs66754
-Node: Configure options for texk/web2c67537
-Node: Configure options for texk/bibtex-x70075
-Node: Configure options for texk/dvipdfm-x70618
-Node: Configure options for texk/dvisvgm71394
-Node: Configure options for texk/texlive72275
-Node: Configure options for texk/xdvik72696
-Node: Configure options for utils/xindy73317
-Node: Library-specific configure options74207
-Node: Configure options for kpathsea75168
-Node: Variables for configure75872
-Node: Coding conventions77298
-Node: Declarations and definitions78013
-Node: Const80187
-Node: Continuous integration82051
-Node: Transfer from Subversion to Github82715
-Node: Automatic update of the Git mirror84877
-Node: CI testing on Travis-CI85459
-Node: Releases on Github86168
-Node: install-tl86608
-Node: install-tl NAME86977
-Node: install-tl SYNOPSIS87135
-Node: install-tl DESCRIPTION87393
-Node: install-tl REFERENCES88453
-Node: install-tl OPTIONS88977
-Ref: install-tl *-gui* [[=]_module_]89318
-Ref: install-tl text89526
-Ref: install-tl tcl89646
-Ref: install-tl wizard89988
-Ref: install-tl expert90121
-Ref: install-tl perltk90243
-Ref: install-tl *-no-gui*90789
-Ref: install-tl *-lang* _llcode_90879
-Ref: install-tl *-repository* _url|path_91635
-Ref: install-tl *-select-repository*92523
-Ref: install-tl *-all-options*92959
-Ref: install-tl *-custom-bin* _path_93214
-Ref: install-tl *-debug-translation*94048
-Ref: install-tl *-force-platform* _platform_94267
-Ref: install-tl *-help*, *--help*, *-?*94511
-Ref: install-tl *-in-place*94924
-Ref: install-tl *-init-from-profile* _profile_file_95469
-Ref: install-tl *-logfile* _file_95738
-Ref: install-tl *-no-cls*96089
-Ref: install-tl *-no-persistent-downloads*96237
-Ref: install-tl *-persistent-downloads*96262
-Ref: install-tl *-no-verify-downloads*96880
-Ref: install-tl *-non-admin*97243
-Ref: install-tl *-portable*97336
-Ref: install-tl *-print-platform*97475
-Ref: install-tl *-profile* _profile_file_97673
-Ref: install-tl *-q*97894
-Ref: install-tl *-scheme* _scheme_97956
-Ref: install-tl *-v*98430
-Ref: install-tl *-version*, *--version*98585
-Node: install-tl PROFILES98719
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)101585
-Ref: install-tl instopt_adjustrepo (default 1)101661
-Ref: install-tl instopt_letter (default 0)101798
-Ref: install-tl instopt_portable (default 0)101889
-Ref: install-tl instopt_write18_restricted (default 1)101985
-Node: install-tl ENVIRONMENT VARIABLES103324
-Ref: install-tl TEXLIVE_DOWNLOADER103702
-Ref: install-tl TL_DOWNLOAD_PROGRAM103725
-Ref: install-tl TL_DOWNLOAD_ARGS103745
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK103949
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104151
-Ref: install-tl TEXLIVE_INSTALL_NO_IMPORT104260
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME104412
-Ref: install-tl TEXLIVE_INSTALL_PREFIX104534
-Ref: install-tl TEXLIVE_INSTALL_TEXDIR104560
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG104591
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR104619
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME104648
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL104678
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG104712
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR104743
-Ref: install-tl NOPERLDOC105114
-Node: install-tl AUTHORS AND COPYRIGHT105178
-Node: tlmgr105591
-Node: tlmgr NAME106076
-Node: tlmgr SYNOPSIS106208
-Node: tlmgr DESCRIPTION106398
-Node: tlmgr EXAMPLES107497
-Ref: tlmgr tlmgr option repository ctan107748
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet107820
-Ref: tlmgr tlmgr update --list108425
-Ref: tlmgr tlmgr update --all108518
-Ref: tlmgr tlmgr info _what_108675
-Node: tlmgr OPTIONS108937
-Ref: tlmgr *--repository* _url|path_109457
-Ref: tlmgr /some/local/dir110643
-Ref: tlmgr file:/some/local/dir110672
-Ref: tlmgr ctan110745
-Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet110798
-Ref: tlmgr http://server/path/to/tlnet111139
-Ref: tlmgr https://server/path/to/tlnet111520
-Ref: tlmgr ftp://server/path/to/tlnet111988
-Ref: tlmgr user@machine:/path/to/tlnet112120
-Ref: tlmgr scp://user@machine/path/to/tlnet112161
-Ref: tlmgr ssh://user@machine/path/to/tlnet112202
-Ref: tlmgr *--gui* [_action_]112595
-Ref: tlmgr *--gui-lang* _llcode_113408
-Ref: tlmgr *--debug-translation*114144
-Ref: tlmgr *--machine-readable*114347
-Ref: tlmgr *--no-execute-actions*114615
-Ref: tlmgr *--package-logfile* _file_114808
-Ref: tlmgr *--pause*115062
-Ref: tlmgr *--persistent-downloads*115217
-Ref: tlmgr *--no-persistent-downloads*115245
-Ref: tlmgr *--pin-file*115739
-Ref: tlmgr *--usermode*115957
-Ref: tlmgr *--usertree* _dir_116077
-Ref: tlmgr *--verify-repo=[none|main|all]*116203
-Node: tlmgr ACTIONS117102
-Node: tlmgr help117963
-Node: tlmgr version118440
-Node: tlmgr backup118703
-Ref: tlmgr *backup [_option_...] --all*118874
-Ref: tlmgr *backup [_option_...] _pkg_...*118907
-Ref: tlmgr *--backupdir* _directory_119973
-Ref: tlmgr *--all*120190
-Ref: tlmgr *--clean*[=_N_]120442
-Ref: tlmgr *--dry-run*120769
-Node: tlmgr candidates _pkg_120899
-Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]121254
-Ref: tlmgr *depends*121768
-Ref: tlmgr *executes*122110
-Ref: tlmgr *files*122225
-Ref: tlmgr *runfiles*122361
-Ref: tlmgr *texmfdbs*122498
-Ref: tlmgr - all items in TEXMFDBS have the !! prefix.122728
-Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).122804
-Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.122869
-Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.122944
-Ref: tlmgr *--use-svn*122969
-Node: tlmgr conf123110
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*123398
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*123462
-Node: tlmgr dump-tlpdb [_option_...] [--json]125877
-Ref: tlmgr *--local*126310
-Ref: tlmgr *--remote*126349
-Ref: tlmgr *--json*126387
-Node: tlmgr generate126958
-Ref: tlmgr *generate [_option_...] language*127154
-Ref: tlmgr *generate [_option_...] language.dat*127193
-Ref: tlmgr *generate [_option_...] language.def*127232
-Ref: tlmgr *generate [_option_...] language.dat.lua*127275
-Ref: tlmgr *--dest* _output_file_129602
-Ref: tlmgr *--localcfg* _local_conf_file_130178
-Ref: tlmgr *--rebuild-sys*130301
-Node: tlmgr gui131116
-Node: tlmgr info131294
-Ref: tlmgr *info [_option_...] _pkg_...*131456
-Ref: tlmgr *info [_option_...] collections*131490
-Ref: tlmgr *info [_option_...] schemes*131520
-Ref: tlmgr *--list*133050
-Ref: tlmgr *--only-installed*133364
-Ref: tlmgr *--only-remote*133552
-Ref: tlmgr *--data item1,item2,...*133856
-Ref: tlmgr *--json* 1134437
-Node: tlmgr init-usertree134820
-Node: tlmgr install [_option_...] _pkg_...135201
-Ref: tlmgr *--dry-run* 1135709
-Ref: tlmgr *--file*135826
-Ref: tlmgr *--force*136048
-Ref: tlmgr *--no-depends*136268
-Ref: tlmgr *--no-depends-at-all*136427
-Ref: tlmgr *--reinstall*136827
-Ref: tlmgr *--with-doc*137205
-Ref: tlmgr *--with-src*137218
-Node: tlmgr key137946
-Ref: tlmgr *key list*138104
-Ref: tlmgr *key add _file_*138122
-Ref: tlmgr *key remove _keyid_*138144
-Node: tlmgr list138738
-Node: tlmgr option138900
-Ref: tlmgr *option [--json] [show]*139055
-Ref: tlmgr *option [--json] showall|help*139086
-Ref: tlmgr *option _key_ [_value_]*139112
-Node: tlmgr paper143690
-Ref: tlmgr *paper [a4|letter]*143839
-Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>143915
-Ref: tlmgr *paper --json*143930
-Node: tlmgr path145145
-Ref: tlmgr *path [--w32mode=user|admin] add*145306
-Ref: tlmgr *path [--w32mode=user|admin] remove*145343
-Node: tlmgr pinning146828
-Ref: tlmgr pinning show147069
-Ref: tlmgr pinning add _repo_ _pkgglob_...147142
-Ref: tlmgr pinning remove _repo_ _pkgglob_...147261
-Ref: tlmgr pinning remove _repo_ --all147414
-Node: tlmgr platform147468
-Ref: tlmgr *platform list|add|remove _platform_...*147654
-Ref: tlmgr *platform set _platform_*147681
-Ref: tlmgr *platform set auto*147702
-Ref: tlmgr *--dry-run* 2148579
-Node: tlmgr postaction148698
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*148928
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*149002
-Ref: tlmgr *--w32mode=[user|admin]*149317
-Ref: tlmgr *--fileassocmode=[1|2]*149733
-Ref: tlmgr *--all* 1150018
-Node: tlmgr print-platform150073
-Node: tlmgr print-platform-info150404
-Node: tlmgr remove [_option_...] _pkg_...150704
-Ref: tlmgr *--all* 2151188
-Ref: tlmgr *--backup*151298
-Ref: tlmgr *--backupdir* _directory_ 1151324
-Ref: tlmgr *--no-depends* 1151729
-Ref: tlmgr *--no-depends-at-all* 1151791
-Ref: tlmgr *--force* 1151894
-Ref: tlmgr *--dry-run* 3152367
-Node: tlmgr repository152703
-Ref: tlmgr *repository list*152891
-Ref: tlmgr *repository list _path|url|tag_*152925
-Ref: tlmgr *repository add _path_ [_tag_]*152958
-Ref: tlmgr *repository remove _path|tag_*152990
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*153044
-Ref: tlmgr *repository status*153065
-Ref: tlmgr The tag (which can be the same as the url);154292
-Node: tlmgr restore154770
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*154949
-Ref: tlmgr *restore [_option_...] --all*154979
-Ref: tlmgr *--all* 3155679
-Ref: tlmgr *--backupdir* _directory_ 2155893
-Ref: tlmgr *--dry-run* 4156074
-Ref: tlmgr *--force* 2156206
-Ref: tlmgr *--json* 2156252
-Node: tlmgr search156579
-Ref: tlmgr *search [_option_...] _what_*156743
-Ref: tlmgr *search [_option_...] --file _what_*156780
-Ref: tlmgr *search [_option_...] --all _what_*156816
-Ref: tlmgr *--file* 1157036
-Ref: tlmgr *--all* 4157098
-Ref: tlmgr *--global*157187
-Ref: tlmgr *--word*157314
-Node: tlmgr shell157629
-Ref: tlmgr protocol158364
-Ref: tlmgr help 1158428
-Ref: tlmgr version 1158481
-Ref: tlmgr quit, end, bye, byebye, EOF158549
-Ref: tlmgr restart158570
-Ref: tlmgr load [local|remote]158693
-Ref: tlmgr save158763
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]158886
-Node: tlmgr show159487
-Node: tlmgr uninstall159654
-Node: tlmgr update [_option_...] [_pkg_...]159884
-Ref: tlmgr *--all* 5160255
-Ref: tlmgr *--self*162434
-Ref: tlmgr *--dry-run* 5163198
-Ref: tlmgr *--list* [_pkg_]163375
-Ref: tlmgr *--exclude* _pkg_164064
-Ref: tlmgr *--no-auto-remove* [_pkg_...]164864
-Ref: tlmgr *--no-auto-install* [_pkg_...]165348
-Ref: tlmgr *--reinstall-forcibly-removed*166110
-Ref: tlmgr *--backup* 1166645
-Ref: tlmgr *--backupdir* _directory_ 3166671
-Ref: tlmgr *--no-depends* 2167837
-Ref: tlmgr *--no-depends-at-all* 2168040
-Ref: tlmgr *--force* 3168143
-Node: tlmgr CONFIGURATION FILE FOR TLMGR169163
-Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.170170
-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.170307
-Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.170389
-Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).170443
-Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.170523
-Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.170603
-Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.170751
-Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.170827
-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).171096
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION172184
-Node: tlmgr Configuration of GnuPG invocation174357
-Node: tlmgr USER MODE174995
-Node: tlmgr User mode install177841
-Node: tlmgr User mode backup, restore, remove, update178985
-Node: tlmgr User mode generate, option, paper179427
-Node: tlmgr MULTIPLE REPOSITORIES179803
-Node: tlmgr Pinning181532
-Node: tlmgr GUI FOR TLMGR183455
-Node: tlmgr Main display185104
-Node: tlmgr Display configuration area185356
-Ref: tlmgr Status185717
-Ref: tlmgr Category185881
-Ref: tlmgr Match186067
-Ref: tlmgr Selection186248
-Ref: tlmgr Display configuration buttons186452
-Node: tlmgr Package list area186635
-Ref: tlmgr a checkbox187219
-Ref: tlmgr package name187355
-Ref: tlmgr local revision (and version)187454
-Ref: tlmgr remote revision (and version)187829
-Ref: tlmgr short description188126
-Node: tlmgr Main display action buttons188171
-Ref: tlmgr Update all installed188437
-Ref: tlmgr Update188809
-Ref: tlmgr Install188859
-Ref: tlmgr Remove189045
-Ref: tlmgr Backup189223
-Node: tlmgr Menu bar189380
-Ref: tlmgr tlmgr menu189603
-Ref: tlmgr Options menu189911
-Ref: tlmgr Actions menu190994
-Ref: tlmgr Help menu191422
-Node: tlmgr GUI options191556
-Ref: tlmgr -background _color_191802
-Ref: tlmgr -font " _fontname_ _fontsize_ "191867
-Ref: tlmgr -foreground _color_192025
-Ref: tlmgr -geometry _geomspec_192077
-Ref: tlmgr -xrm _xresource_192269
-Node: tlmgr MACHINE-READABLE OUTPUT192538
-Node: tlmgr Machine-readable update and install output193348
-Ref: tlmgr location-url _location_194624
-Ref: tlmgr total-bytes _count_194840
-Ref: tlmgr _pkgname_195250
-Ref: tlmgr _status_195460
-Ref: tlmgr d195538
-Ref: tlmgr f195598
-Ref: tlmgr u195777
-Ref: tlmgr r195823
-Ref: tlmgr a195946
-Ref: tlmgr i196124
-Ref: tlmgr I196243
-Ref: tlmgr _localrev_196345
-Ref: tlmgr _serverrev_196452
-Ref: tlmgr _size_196564
-Ref: tlmgr _runtime_196733
-Ref: tlmgr _esttot_196803
-Node: tlmgr Machine-readable option output196836
-Node: tlmgr ENVIRONMENT VARIABLES197348
-Ref: tlmgr TEXLIVE_COMPRESSOR197859
-Ref: tlmgr TEXLIVE_DOWNLOADER198707
-Ref: tlmgr TL_DOWNLOAD_PROGRAM198730
-Ref: tlmgr TL_DOWNLOAD_ARGS198750
-Ref: tlmgr TEXLIVE_PREFER_OWN199776
-Node: tlmgr AUTHORS AND COPYRIGHT200600
-Node: Index200998
+Node: Build one engine16368
+Node: Cross compilation17882
+Node: Cross configuring19162
+Node: Cross problems20839
+Node: Installing22501
+Node: Installation directories23521
+Node: Linked scripts25339
+Node: Distro builds26830
+Node: Layout and infrastructure29206
+Node: Build system tools30037
+Node: Top-level directories32254
+Node: Autoconf macros34490
+Node: General setup macros35252
+Node: Macros for programs36127
+Node: Macros for compilers36928
+Node: Macros for libraries38336
+Node: Macros for library and header flags38762
+Node: Macros for Windows40673
+Node: Library modules42260
+Node: png library42749
+Node: zlib library45097
+Node: freetype library45612
+Node: kpathsea library46308
+Node: Program modules47687
+Node: t1utils package48115
+Node: xindy package48660
+Node: xdvik package49774
+Node: asymptote50833
+Node: Extending TeX Live51329
+Node: Adding a new program module52112
+Node: Adding a new generic library module55451
+Node: Adding a new TeX-specific library module57680
+Node: Configure options58378
+Node: Global configure options59759
+Node: --disable-native-texlive-build60301
+Node: --prefix --bindir ...61263
+Node: --disable-largefile61803
+Node: --disable-missing62345
+Node: --enable-compiler-warnings=LEVEL62746
+Node: --enable-cxx-runtime-hack63402
+Node: --enable-maintainer-mode63822
+Node: --enable-multiplatform64351
+Node: --enable-shared64924
+Node: --enable-silent-rules65295
+Node: --without-ln-s65747
+Node: --without-x66094
+Node: Program-specific configure options66282
+Node: --enable-PROG --disable-PROG66925
+Node: --disable-all-pkgs67198
+Node: Configure options for texk/web2c67981
+Node: Configure options for texk/bibtex-x70519
+Node: Configure options for texk/dvipdfm-x71062
+Node: Configure options for texk/dvisvgm71838
+Node: Configure options for texk/texlive72719
+Node: Configure options for texk/xdvik73140
+Node: Configure options for utils/xindy73761
+Node: Library-specific configure options74651
+Node: Configure options for kpathsea75612
+Node: Variables for configure76316
+Node: Coding conventions77742
+Node: Declarations and definitions78457
+Node: Const80631
+Node: Continuous integration82495
+Node: Transfer from Subversion to Github83159
+Node: Automatic update of the Git mirror85321
+Node: CI testing on Travis-CI85903
+Node: Releases on Github86612
+Node: install-tl87052
+Node: install-tl NAME87421
+Node: install-tl SYNOPSIS87579
+Node: install-tl DESCRIPTION87837
+Node: install-tl REFERENCES88897
+Node: install-tl OPTIONS89421
+Ref: install-tl *-gui* [[=]_module_]89762
+Ref: install-tl text89970
+Ref: install-tl tcl90090
+Ref: install-tl wizard90432
+Ref: install-tl expert90565
+Ref: install-tl perltk90687
+Ref: install-tl *-no-gui*91233
+Ref: install-tl *-lang* _llcode_91323
+Ref: install-tl *-repository* _url|path_92079
+Ref: install-tl *-select-repository*92967
+Ref: install-tl *-all-options*93403
+Ref: install-tl *-custom-bin* _path_93658
+Ref: install-tl *-debug-translation*94492
+Ref: install-tl *-force-platform* _platform_94711
+Ref: install-tl *-help*, *--help*, *-?*94955
+Ref: install-tl *-in-place*95368
+Ref: install-tl *-init-from-profile* _profile_file_95913
+Ref: install-tl *-logfile* _file_96182
+Ref: install-tl *-no-cls*96533
+Ref: install-tl *-no-persistent-downloads*96681
+Ref: install-tl *-persistent-downloads*96706
+Ref: install-tl *-no-verify-downloads*97324
+Ref: install-tl *-non-admin*97687
+Ref: install-tl *-portable*97780
+Ref: install-tl *-print-platform*97919
+Ref: install-tl *-profile* _profile_file_98117
+Ref: install-tl *-q*98338
+Ref: install-tl *-scheme* _scheme_98400
+Ref: install-tl *-v*98874
+Ref: install-tl *-version*, *--version*99029
+Node: install-tl PROFILES99163
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102029
+Ref: install-tl instopt_adjustrepo (default 1)102105
+Ref: install-tl instopt_letter (default 0)102242
+Ref: install-tl instopt_portable (default 0)102333
+Ref: install-tl instopt_write18_restricted (default 1)102429
+Node: install-tl ENVIRONMENT VARIABLES103768
+Ref: install-tl TEXLIVE_DOWNLOADER104146
+Ref: install-tl TL_DOWNLOAD_PROGRAM104169
+Ref: install-tl TL_DOWNLOAD_ARGS104189
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104393
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104595
+Ref: install-tl TEXLIVE_INSTALL_NO_IMPORT104704
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME104856
+Ref: install-tl TEXLIVE_INSTALL_PREFIX104978
+Ref: install-tl TEXLIVE_INSTALL_TEXDIR105004
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105035
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105063
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105092
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105122
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105156
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105187
+Ref: install-tl NOPERLDOC105558
+Node: install-tl AUTHORS AND COPYRIGHT105622
+Node: tlmgr106035
+Node: tlmgr NAME106520
+Node: tlmgr SYNOPSIS106652
+Node: tlmgr DESCRIPTION106842
+Node: tlmgr EXAMPLES107941
+Ref: tlmgr tlmgr option repository ctan108192
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108264
+Ref: tlmgr tlmgr update --list108869
+Ref: tlmgr tlmgr update --all108962
+Ref: tlmgr tlmgr info _what_109119
+Node: tlmgr OPTIONS109381
+Ref: tlmgr *--repository* _url|path_109901
+Ref: tlmgr /some/local/dir111087
+Ref: tlmgr file:/some/local/dir111116
+Ref: tlmgr ctan111189
+Ref: tlmgr http://mirror.ctan.org/systems/texlive/tlnet111242
+Ref: tlmgr http://server/path/to/tlnet111583
+Ref: tlmgr https://server/path/to/tlnet111964
+Ref: tlmgr ftp://server/path/to/tlnet112432
+Ref: tlmgr user@machine:/path/to/tlnet112564
+Ref: tlmgr scp://user@machine/path/to/tlnet112605
+Ref: tlmgr ssh://user@machine/path/to/tlnet112646
+Ref: tlmgr *--gui* [_action_]113039
+Ref: tlmgr *--gui-lang* _llcode_113852
+Ref: tlmgr *--debug-translation*114588
+Ref: tlmgr *--machine-readable*114791
+Ref: tlmgr *--no-execute-actions*115059
+Ref: tlmgr *--package-logfile* _file_115252
+Ref: tlmgr *--pause*115506
+Ref: tlmgr *--persistent-downloads*115661
+Ref: tlmgr *--no-persistent-downloads*115689
+Ref: tlmgr *--pin-file*116183
+Ref: tlmgr *--usermode*116401
+Ref: tlmgr *--usertree* _dir_116521
+Ref: tlmgr *--verify-repo=[none|main|all]*116647
+Node: tlmgr ACTIONS117546
+Node: tlmgr help118407
+Node: tlmgr version118884
+Node: tlmgr backup119147
+Ref: tlmgr *backup [_option_...] --all*119318
+Ref: tlmgr *backup [_option_...] _pkg_...*119351
+Ref: tlmgr *--backupdir* _directory_120417
+Ref: tlmgr *--all*120634
+Ref: tlmgr *--clean*[=_N_]120886
+Ref: tlmgr *--dry-run*121213
+Node: tlmgr candidates _pkg_121343
+Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]121698
+Ref: tlmgr *depends*122212
+Ref: tlmgr *executes*122554
+Ref: tlmgr *files*122669
+Ref: tlmgr *runfiles*122805
+Ref: tlmgr *texmfdbs*122942
+Ref: tlmgr - all items in TEXMFDBS have the !! prefix.123172
+Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).123248
+Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.123313
+Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.123388
+Ref: tlmgr *--use-svn*123413
+Node: tlmgr conf123554
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*123842
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*123906
+Node: tlmgr dump-tlpdb [_option_...] [--json]126321
+Ref: tlmgr *--local*126754
+Ref: tlmgr *--remote*126793
+Ref: tlmgr *--json*126831
+Node: tlmgr generate127402
+Ref: tlmgr *generate [_option_...] language*127598
+Ref: tlmgr *generate [_option_...] language.dat*127637
+Ref: tlmgr *generate [_option_...] language.def*127676
+Ref: tlmgr *generate [_option_...] language.dat.lua*127719
+Ref: tlmgr *--dest* _output_file_130046
+Ref: tlmgr *--localcfg* _local_conf_file_130622
+Ref: tlmgr *--rebuild-sys*130745
+Node: tlmgr gui131560
+Node: tlmgr info131738
+Ref: tlmgr *info [_option_...] _pkg_...*131900
+Ref: tlmgr *info [_option_...] collections*131934
+Ref: tlmgr *info [_option_...] schemes*131964
+Ref: tlmgr *--list*133494
+Ref: tlmgr *--only-installed*133808
+Ref: tlmgr *--only-remote*133996
+Ref: tlmgr *--data item1,item2,...*134300
+Ref: tlmgr *--json* 1134881
+Node: tlmgr init-usertree135264
+Node: tlmgr install [_option_...] _pkg_...135645
+Ref: tlmgr *--dry-run* 1136153
+Ref: tlmgr *--file*136270
+Ref: tlmgr *--force*136492
+Ref: tlmgr *--no-depends*136712
+Ref: tlmgr *--no-depends-at-all*136871
+Ref: tlmgr *--reinstall*137271
+Ref: tlmgr *--with-doc*137649
+Ref: tlmgr *--with-src*137662
+Node: tlmgr key138390
+Ref: tlmgr *key list*138548
+Ref: tlmgr *key add _file_*138566
+Ref: tlmgr *key remove _keyid_*138588
+Node: tlmgr list139182
+Node: tlmgr option139344
+Ref: tlmgr *option [--json] [show]*139499
+Ref: tlmgr *option [--json] showall|help*139530
+Ref: tlmgr *option _key_ [_value_]*139556
+Node: tlmgr paper144134
+Ref: tlmgr *paper [a4|letter]*144283
+Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>144359
+Ref: tlmgr *paper --json*144374
+Node: tlmgr path145589
+Ref: tlmgr *path [--w32mode=user|admin] add*145750
+Ref: tlmgr *path [--w32mode=user|admin] remove*145787
+Node: tlmgr pinning147272
+Ref: tlmgr pinning show147513
+Ref: tlmgr pinning add _repo_ _pkgglob_...147586
+Ref: tlmgr pinning remove _repo_ _pkgglob_...147705
+Ref: tlmgr pinning remove _repo_ --all147858
+Node: tlmgr platform147912
+Ref: tlmgr *platform list|add|remove _platform_...*148098
+Ref: tlmgr *platform set _platform_*148125
+Ref: tlmgr *platform set auto*148146
+Ref: tlmgr *--dry-run* 2149023
+Node: tlmgr postaction149142
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*149372
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*149446
+Ref: tlmgr *--w32mode=[user|admin]*149761
+Ref: tlmgr *--fileassocmode=[1|2]*150177
+Ref: tlmgr *--all* 1150462
+Node: tlmgr print-platform150517
+Node: tlmgr print-platform-info150848
+Node: tlmgr remove [_option_...] _pkg_...151148
+Ref: tlmgr *--all* 2151632
+Ref: tlmgr *--backup*151742
+Ref: tlmgr *--backupdir* _directory_ 1151768
+Ref: tlmgr *--no-depends* 1152173
+Ref: tlmgr *--no-depends-at-all* 1152235
+Ref: tlmgr *--force* 1152338
+Ref: tlmgr *--dry-run* 3152811
+Node: tlmgr repository153147
+Ref: tlmgr *repository list*153335
+Ref: tlmgr *repository list _path|url|tag_*153369
+Ref: tlmgr *repository add _path_ [_tag_]*153402
+Ref: tlmgr *repository remove _path|tag_*153434
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*153488
+Ref: tlmgr *repository status*153509
+Ref: tlmgr The tag (which can be the same as the url);154736
+Node: tlmgr restore155214
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*155393
+Ref: tlmgr *restore [_option_...] --all*155423
+Ref: tlmgr *--all* 3156123
+Ref: tlmgr *--backupdir* _directory_ 2156337
+Ref: tlmgr *--dry-run* 4156518
+Ref: tlmgr *--force* 2156650
+Ref: tlmgr *--json* 2156696
+Node: tlmgr search157023
+Ref: tlmgr *search [_option_...] _what_*157187
+Ref: tlmgr *search [_option_...] --file _what_*157224
+Ref: tlmgr *search [_option_...] --all _what_*157260
+Ref: tlmgr *--file* 1157480
+Ref: tlmgr *--all* 4157542
+Ref: tlmgr *--global*157631
+Ref: tlmgr *--word*157758
+Node: tlmgr shell158073
+Ref: tlmgr protocol158808
+Ref: tlmgr help 1158872
+Ref: tlmgr version 1158925
+Ref: tlmgr quit, end, bye, byebye, EOF158993
+Ref: tlmgr restart159014
+Ref: tlmgr load [local|remote]159137
+Ref: tlmgr save159207
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]159330
+Node: tlmgr show159931
+Node: tlmgr uninstall160098
+Node: tlmgr update [_option_...] [_pkg_...]160328
+Ref: tlmgr *--all* 5160699
+Ref: tlmgr *--self*162878
+Ref: tlmgr *--dry-run* 5163642
+Ref: tlmgr *--list* [_pkg_]163819
+Ref: tlmgr *--exclude* _pkg_164508
+Ref: tlmgr *--no-auto-remove* [_pkg_...]165308
+Ref: tlmgr *--no-auto-install* [_pkg_...]165792
+Ref: tlmgr *--reinstall-forcibly-removed*166554
+Ref: tlmgr *--backup* 1167089
+Ref: tlmgr *--backupdir* _directory_ 3167115
+Ref: tlmgr *--no-depends* 2168281
+Ref: tlmgr *--no-depends-at-all* 2168484
+Ref: tlmgr *--force* 3168587
+Node: tlmgr CONFIGURATION FILE FOR TLMGR169607
+Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.170614
+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.170751
+Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.170833
+Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).170887
+Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.170967
+Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.171047
+Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.171195
+Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.171271
+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).171540
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION172628
+Node: tlmgr Configuration of GnuPG invocation174801
+Node: tlmgr USER MODE175439
+Node: tlmgr User mode install178285
+Node: tlmgr User mode backup, restore, remove, update179429
+Node: tlmgr User mode generate, option, paper179871
+Node: tlmgr MULTIPLE REPOSITORIES180247
+Node: tlmgr Pinning181976
+Node: tlmgr GUI FOR TLMGR183899
+Node: tlmgr Main display185548
+Node: tlmgr Display configuration area185800
+Ref: tlmgr Status186161
+Ref: tlmgr Category186325
+Ref: tlmgr Match186511
+Ref: tlmgr Selection186692
+Ref: tlmgr Display configuration buttons186896
+Node: tlmgr Package list area187079
+Ref: tlmgr a checkbox187663
+Ref: tlmgr package name187799
+Ref: tlmgr local revision (and version)187898
+Ref: tlmgr remote revision (and version)188273
+Ref: tlmgr short description188570
+Node: tlmgr Main display action buttons188615
+Ref: tlmgr Update all installed188881
+Ref: tlmgr Update189253
+Ref: tlmgr Install189303
+Ref: tlmgr Remove189489
+Ref: tlmgr Backup189667
+Node: tlmgr Menu bar189824
+Ref: tlmgr tlmgr menu190047
+Ref: tlmgr Options menu190355
+Ref: tlmgr Actions menu191438
+Ref: tlmgr Help menu191866
+Node: tlmgr GUI options192000
+Ref: tlmgr -background _color_192246
+Ref: tlmgr -font " _fontname_ _fontsize_ "192311
+Ref: tlmgr -foreground _color_192469
+Ref: tlmgr -geometry _geomspec_192521
+Ref: tlmgr -xrm _xresource_192713
+Node: tlmgr MACHINE-READABLE OUTPUT192982
+Node: tlmgr Machine-readable update and install output193792
+Ref: tlmgr location-url _location_195068
+Ref: tlmgr total-bytes _count_195284
+Ref: tlmgr _pkgname_195694
+Ref: tlmgr _status_195904
+Ref: tlmgr d195982
+Ref: tlmgr f196042
+Ref: tlmgr u196221
+Ref: tlmgr r196267
+Ref: tlmgr a196390
+Ref: tlmgr i196568
+Ref: tlmgr I196687
+Ref: tlmgr _localrev_196789
+Ref: tlmgr _serverrev_196896
+Ref: tlmgr _size_197008
+Ref: tlmgr _runtime_197177
+Ref: tlmgr _esttot_197247
+Node: tlmgr Machine-readable option output197280
+Node: tlmgr ENVIRONMENT VARIABLES197792
+Ref: tlmgr TEXLIVE_COMPRESSOR198303
+Ref: tlmgr TEXLIVE_DOWNLOADER199151
+Ref: tlmgr TL_DOWNLOAD_PROGRAM199174
+Ref: tlmgr TL_DOWNLOAD_ARGS199194
+Ref: tlmgr TEXLIVE_PREFER_OWN200220
+Node: tlmgr AUTHORS AND COPYRIGHT201044
+Node: Index201442
 
 End Tag Table
 
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 06b70960927..19f2c438cc0 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -441,7 +441,7 @@ library, first building any required libraries.
 
 Here is an example from start to finish for working on
 @code{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.)
 
 @example
 mkdir mydir && cd mydir  # new working directory
@@ -537,22 +537,33 @@ 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 Lua@TeX{}:
+explicitly specify what to make. For example, to build only the
+original @TeX{}:
 
 @example
-./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
 @end example
 
-This works because the @code{make} automatically runs @code{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 pdf@TeX{} and Lua@TeX{} source repositories do this, if
-you want to peruse examples).
+The first @code{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 pdf@TeX{} and Lua@TeX{} 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 @code{configure} options
+accordingly. Either @code{../Build} or @code{../configure} can be run.
 
+Then it is necessary to again specify the target engine (@code{tex},
+in the above) in the @code{make}.
+
+All this is somewhat unfortunate.  We hope to improve the situation in
+the future.  Patches are welcome.
 
 @node Cross compilation
 @section Cross compilation
@@ -702,6 +713,7 @@ and @file{tie}.
 Building @code{xindy} requires running the host system @code{clisp}
 binary, thus cross compilation is painful, but possible.
 
+
 @node Installing
 @chapter Installing