tlbuild apt-get note, remake README.*

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

7 files changed, 354 insertions, 330 deletions

diff --git a/Build/source/README.1prerequisites b/Build/source/README.1prerequisites
index 0834359dafb..80f0186cde6 100644
--- a/Build/source/README.1prerequisites
+++ b/Build/source/README.1prerequisites
@@ -26,7 +26,8 @@ Automake/Autoconf output in general) should work with any reasonable
      that are not installed by default.
 
 'xetex'
-     requires 'fontconfig' (again both headers and library).
+     requires 'fontconfig' (again both headers and library), or, for
+     MacOSX only, the 'ApplicationServices' and 'Cocoa' frameworks.
 
 'xindy'
      requires GNU 'clisp' and in addition 'perl', 'latex', and
@@ -54,9 +55,8 @@ timestamps--notably, 'use-commit-times' must be set to 'yes' in your
 Subversion configuration (*note Build system tools::).  Barring buggy
 commits, no infrastructure tools are needed to do a normal build.
 
+   As an example, on Debian systems the necessary build dependencies can
+be installed via:
 
-Building on Debian
-------------------
+     apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
 
-On Debian systems the necessary build dependencies are installed by
-	apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
diff --git a/Build/source/README.2building b/Build/source/README.2building
index 05ecfadb6b0..0e256d93a65 100644
--- a/Build/source/README.2building
+++ b/Build/source/README.2building
@@ -8,13 +8,13 @@
 The top-level 'Build' script is intended to simplify building the
 binaries distributed with TeX Live itself--we call this the "native" TL
 build.  It configures and makes everything in a subdirectory of the main
-build tree (default 'Work/'), installs everything in an other
+build tree (default 'Work/'), installs everything in another
 subdirectory (default 'inst/'), and finally runs 'make check'.  The
 exact directory and command names can be specified via environment
 variables and a few leading options.  All remaining arguments
 (assignments or options) are passed to the 'configure' script.  Please
-take a look at the script itself for more information; it is not
-complicated.
+take a look at the './Build' source file itself for more information; it
+is a straightforward shell script.
 
    An alternative, and the one we will mainly discuss here, is to run
 'configure' and 'make' oneself in a suitable empty subdirectory.
@@ -78,18 +78,18 @@ since all the support files are lacking; *note Installing::.
 =====================
 
 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 and causes to first
 build any required libraries.
 
-   This "build-on-demand" procedure is used, e.g., in the 'luatex'
-repository to build LuaTeX, essentially from a subset of the complete
-TeX Live tree.  Similarly, when, e.g., building the original e-TeX has
-been disabled (as it is by default), one can run 'make etex' (or 'make
-etex.exe') in 'texk/web2c/' to build e-TeX (although there is no
-comparably simple way to install e-TeX).
+   This "build-on-demand" procedure is used, e.g., in the upstream
+LuaTeX repository to build LuaTeX, essentially from a subset of the
+complete TeX Live tree.  Similarly, when, e.g., building the original
+e-TeX has been disabled (as it is by default), one can run 'make etex'
+(or 'make etex.exe') in 'texk/web2c/' to build e-TeX (although there is
+no comparably simple way to install e-TeX).
 
    If you want to work on a single program within the TL sources, this
 is the recommended way to do it.  Here is an example from start to
@@ -138,3 +138,18 @@ have undesired side effects.  For an example, see the 'build-pdftex.sh'
 script in the 'pdftex' development sources (<http://pdftex.org>), which
 are indeed a cut-down TL source tree.
 
+   Caveat 1: even with '--disable-all-pkgs', dependencies will be
+checked.  For instance, if a non-MacOSX system does not have
+'fontconfig', XeTeX cannot be built (*note Prerequisites::) and
+'configure' will terminate.  To proceed without such dependencies,
+specify '--enable-missing' also.  (Arguably this should happen
+automatically.)
+
+   Caveat 2: unless 'CC' and 'CXX' and 'OBJCXX' are explicitly
+specified, each package will configure its own compiler(s).  In
+practice, this results in a conflict in only one instance: the ICU
+('libs/icu') library will prefer 'clang' and 'clang++' over all others
+if they are installed, whereas everything else prefers 'gcc' and 'g++'.
+Usually the results will be interoperable, but it can cause extra
+confusion and problems when debugging a program that uses ICU.
+
diff --git a/Build/source/README.4layout b/Build/source/README.4layout
index efb1a567098..d2585430bbc 100644
--- a/Build/source/README.4layout
+++ b/Build/source/README.4layout
@@ -30,10 +30,10 @@ many extra hassles, so don't do that, tempting as it may be.
      autoconf (GNU Autoconf) 2.69
      automake (GNU automake) 1.15
      bison (GNU Bison) 3.0.4
-     flex 2.5.39
+     flex 2.6.0
      ltmain.sh (GNU libtool) 2.4.6
      m4 (GNU M4) 1.4.17
-     makeinfo (GNU texinfo) 5.2
+     makeinfo (GNU texinfo) 6.1
 
    These versions should be used to update the generated files (e.g.,
 'configure' or 'Makefile.in') in all or parts of the TL tree after their
diff --git a/Build/source/README.5configure b/Build/source/README.5configure
index bd6699beb16..6b4b00a45d0 100644
--- a/Build/source/README.5configure
+++ b/Build/source/README.5configure
@@ -382,7 +382,7 @@ LuaJITTeX) and XeTeX, and use 'pkg-config' to obtain the required flags.
 '--with-system-xpdf'
 Use a system version (0.12 or better) of 'poppler' (and 'pkg-config')
 for pdfTeX instead of 'xpdf' from the TL tree.  *Note
-'--disable-largefile'::.
+--disable-largefile::.
 
 7.4 Variables for configure
 ===========================
diff --git a/Build/source/README.6cross b/Build/source/README.6cross
index c00525a0ad7..51c37d04a1c 100644
--- a/Build/source/README.6cross
+++ b/Build/source/README.6cross
@@ -88,15 +88,10 @@ avoided if possible and otherwise must supply a pessimistic test result.
 into a subdirectory that is configured natively as is done for
 'texk/web2c/web2c', 'texk/dvipsk/squeeze', and 'texk/xdvik/squeeze'.
 The module 'libs/freetype2' uses the value of 'CC_BUILD', 'BUILD-gcc',
-'gcc', or 'cc' as compiler for the auxiliary program.
-
-   Building LuaTeX (or LuaJITTeX) uses the auxiliary program 'txt2zlib'
-to create 'pdflua.c' and, if necessary, update the distributed version
-of that file.  In a cross compilation we simply use that distributed
-file.
+'gcc', or 'cc' as the compiler for the auxiliary program.
 
    The situation for installable programs needed by the build process is
-somewhat different.  A quite expensive possibility, chosen for the ICU
+somewhat different.  A rather expensive possibility, chosen for the ICU
 libraries in module 'libs/icu', is to first compile natively for the
 build system and in a second step to use these (uninstalled) programs
 during the cross compilation.
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index e79706e17be..c54cd9473ff 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -200,6 +200,11 @@ timestamps--notably, 'use-commit-times' must be set to 'yes' in your
 Subversion configuration (*note Build system tools::).  Barring buggy
 commits, no infrastructure tools are needed to do a normal build.
 
+   As an example, on Debian systems the necessary build dependencies can
+be installed via:
+
+     apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
+
 
 File: tlbuild.info,  Node: Building,  Next: Installing,  Prev: Prerequisites,  Up: Top
 
@@ -4599,6 +4604,7 @@ Index
 * CXX:                                   Variables for configure.
                                                                (line 11)
 * CXX=C++-COMPILER:                      Build one package.    (line 74)
+* Debian installation of build prerequisites: Prerequisites.   (line 56)
 * declarations and definitions, in source code: Declarations and definitions.
                                                                (line  6)
 * dependencies, with several output files: Build in parallel.  (line  6)
@@ -4912,309 +4918,309 @@ Node: Top1030
 Node: Introduction1948
 Node: Overview of build system3705
 Node: Prerequisites5769
-Node: Building7907
-Node: Build iteration9155
-Node: Build problems10227
-Node: Build in parallel10630
-Node: Build distribution11222
-Node: Build one package11793
-Node: Installing15379
-Node: Installation directories16394
-Node: Linked scripts18210
-Node: Distro builds19691
-Node: Layout and infrastructure22081
-Node: Build system tools22870
-Node: Top-level directories24879
-Node: Autoconf macros26920
-Node: General setup macros27621
-Node: Macros for programs28488
-Node: Macros for compilers29300
-Node: Macros for libraries30734
-Node: Macros for library and header flags31160
-Node: Macros for Windows33040
-Node: Library modules34617
-Node: png library35106
-Node: zlib library37395
-Node: freetype library37910
-Node: kpathsea library38438
-Node: Program modules39837
-Node: t1utils package40265
-Node: xindy package40828
-Node: xdvik package42007
-Node: asymptote43080
-Node: Extending TeX Live43531
-Node: Adding a new program module43899
-Node: Adding a new generic library module45418
-Node: Adding a new TeX-specific library module47631
-Node: Configure options48318
-Node: Global configure options49700
-Node: --disable-native-texlive-build50242
-Node: --prefix --bindir ...51232
-Node: --disable-largefile51772
-Node: --disable-missing52457
-Node: --enable-compiler-warnings=LEVEL52858
-Node: --enable-cxx-runtime-hack53597
-Node: --enable-maintainer-mode54024
-Node: --enable-multiplatform54553
-Node: --enable-shared55091
-Node: --enable-silent-rules55462
-Node: --without-ln-s55918
-Node: --without-x56269
-Node: Program-specific configure options56457
-Node: --enable-PROG --disable-PROG57100
-Node: --disable-all-pkgs57377
-Node: Configure options for texk/web2c58363
-Node: Configure options for texk/bibtex-x60881
-Node: Configure options for texk/dvipdfm-x61424
-Node: Configure options for texk/dvisvgm62197
-Node: Configure options for texk/texlive63083
-Node: Configure options for texk/xdvik63504
-Node: Configure options for utils/xindy64108
-Node: Library-specific configure options65009
-Node: Configure options for kpathsea66020
-Node: Configure options for system poppler66729
-Node: Variables for configure67520
-Node: Cross compilation68948
-Node: Cross configuring70247
-Node: Cross problems71920
-Node: Coding conventions73567
-Node: Declarations and definitions74236
-Node: Const76418
-Node: install-tl78281
-Node: install-tl NAME78622
-Node: install-tl SYNOPSIS78780
-Node: install-tl DESCRIPTION78988
-Node: install-tl REFERENCES79989
-Node: install-tl OPTIONS80505
-Ref: install-tl *-gui* [[=]_module_]80859
-Ref: install-tl text81068
-Ref: install-tl wizard81191
-Ref: install-tl perltk81345
-Ref: install-tl *-no-gui*81779
-Ref: install-tl *-lang* _llcode_81860
-Ref: install-tl *-repository* _url|path_82547
-Ref: install-tl *-select-repository*84358
-Ref: install-tl *-all-options*84794
-Ref: install-tl *-custom-bin* _path_85101
-Ref: install-tl *-debug-translation*85756
-Ref: install-tl *-force-platform* _platform_85975
-Ref: install-tl *-help*, *--help*, *-?*86219
-Ref: install-tl *-in-place*86612
-Ref: install-tl *-logfile* _file_87139
-Ref: install-tl *-no-cls*87490
-Ref: install-tl *-non-admin*87621
-Ref: install-tl *--persistent-downloads*87726
-Ref: install-tl *--no-persistent-downloads*87754
-Ref: install-tl *-portable*88362
-Ref: install-tl *-print-platform*88501
-Ref: install-tl *-profile* _profile_88694
-Ref: install-tl *-q*90188
-Ref: install-tl *-scheme* _scheme_90250
-Ref: install-tl *-v*90724
-Ref: install-tl *-version*, *--version*90885
-Node: install-tl ENVIRONMENT VARIABLES91016
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK91405
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE91607
-Ref: install-tl TEXLIVE_INSTALL_PREFIX91713
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG91744
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME91773
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL91803
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG91837
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR91868
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR91896
-Ref: install-tl NOPERLDOC91951
-Node: install-tl AUTHORS AND COPYRIGHT92015
-Node: tlmgr92373
-Node: tlmgr NAME92810
-Node: tlmgr SYNOPSIS92935
-Node: tlmgr DESCRIPTION93125
-Node: tlmgr EXAMPLES94221
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet94512
-Ref: tlmgr tlmgr update --list94693
-Ref: tlmgr tlmgr update --all94786
-Ref: tlmgr tlmgr info _pkg_94942
-Node: tlmgr OPTIONS95148
-Ref: tlmgr *--repository* _url|path_95668
-Ref: tlmgr *--gui* [_action_]96393
-Ref: tlmgr *--gui-lang* _llcode_96800
-Ref: tlmgr *--debug-translation*97483
-Ref: tlmgr *--machine-readable*97686
-Ref: tlmgr *--no-execute-actions*97954
-Ref: tlmgr *--package-logfile* _file_98147
-Ref: tlmgr *--pause*98402
-Ref: tlmgr *--persistent-downloads*98557
-Ref: tlmgr *--no-persistent-downloads*98585
-Ref: tlmgr *--pin-file*99079
-Ref: tlmgr *--usermode*99297
-Ref: tlmgr *--usertree* _dir_99417
-Node: tlmgr ACTIONS99967
-Node: tlmgr help101199
-Node: tlmgr version101675
-Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...101993
-Ref: tlmgr *--backupdir* _directory_103087
-Ref: tlmgr *--all*103284
-Ref: tlmgr *--clean*[=_N_]103506
-Ref: tlmgr *--dry-run*103803
-Node: tlmgr candidates _pkg_103923
-Ref: tlmgr *candidates _pkg_* 1104210
-Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]104354
-Ref: tlmgr *files*104797
-Ref: tlmgr *depends*104932
-Ref: tlmgr *executes*105274
-Ref: tlmgr *runfiles*105392
-Ref: tlmgr *--use-svn*105504
-Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]105621
-Node: tlmgr dump-tlpdb [--local|--remote]107693
-Ref: tlmgr *--local*108203
-Ref: tlmgr *--remote*108242
-Node: tlmgr generate [_option_]... _what_108664
-Ref: tlmgr *generate language*108905
-Ref: tlmgr *generate language.dat*108930
-Ref: tlmgr *generate language.def*108955
-Ref: tlmgr *generate language.dat.lua*108984
-Ref: tlmgr *generate fmtutil*109004
-Ref: tlmgr *--dest* _output_file_111241
-Ref: tlmgr *--localcfg* _local_conf_file_111817
-Ref: tlmgr *--rebuild-sys*111940
-Node: tlmgr gui112801
-Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]113045
-Ref: tlmgr *--list*114250
-Ref: tlmgr *--only-installed*114529
-Ref: tlmgr *--taxonomy*114744
-Ref: tlmgr *--keyword*114756
-Ref: tlmgr *--functionality*114774
-Ref: tlmgr *--characterization*114795
-Node: tlmgr init-usertree115008
-Node: tlmgr install [_option_]... _pkg_...115434
-Ref: tlmgr *--file*115798
-Ref: tlmgr *--reinstall*116024
-Ref: tlmgr *--no-depends*116404
-Ref: tlmgr *--no-depends-at-all*116563
-Ref: tlmgr *--dry-run* 1116961
-Ref: tlmgr *--force*117079
-Node: tlmgr option117285
-Ref: tlmgr *option [show]*117458
-Ref: tlmgr *option showall*117476
-Ref: tlmgr *option _key_ [_value_]*117502
-Node: tlmgr paper121350
-Ref: tlmgr *paper [a4|letter]*121535
-Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*121609
-Node: tlmgr path [--w32mode=user|admin] [add|remove]122636
-Node: tlmgr pinning124119
-Ref: tlmgr pinning show124426
-Ref: tlmgr pinning add _repo_ _pkgglob_...124499
-Ref: tlmgr pinning remove _repo_ _pkgglob_...124618
-Ref: tlmgr pinning remove _repo_ --all124771
-Node: tlmgr platform list|add|remove _platform_...124825
-Node: tlmgr platform set _platform_125073
-Node: tlmgr platform set auto125301
-Ref: tlmgr *--dry-run* 2126418
-Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...126527
-Node: tlmgr print-platform127829
-Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]128301
-Ref: tlmgr *--all* 1129197
-Ref: tlmgr *--backupdir* _directory_ 1129391
-Ref: tlmgr *--dry-run* 3129547
-Ref: tlmgr *--force* 1129664
-Node: tlmgr remove [_option_]... _pkg_...129692
-Ref: tlmgr *--no-depends* 1130215
-Ref: tlmgr *--no-depends-at-all* 1130277
-Ref: tlmgr *--force* 2130333
-Ref: tlmgr *--dry-run* 4130805
-Node: tlmgr repository130912
-Ref: tlmgr *repository list*131120
-Ref: tlmgr *repository list _path|tag_*131150
-Ref: tlmgr *repository add _path_ [_tag_]*131183
-Ref: tlmgr *repository remove _path|tag_*131215
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*131269
-Node: tlmgr search [_option_...] _what_132353
-Node: tlmgr search [_option_...] --file _what_132864
-Node: tlmgr search [_option_...] --taxonomy _what_133115
-Node: tlmgr search [_option_...] --keyword _what_133426
-Node: tlmgr search [_option_...] --functionality _what_133744
-Node: tlmgr search [_option_...] --characterization _what_134082
-Node: tlmgr search [_option_...] --all _what_134422
-Ref: tlmgr *--global*134870
-Ref: tlmgr *--word*134982
-Ref: tlmgr *--list* 1135221
-Ref: tlmgr *--file* 1135567
-Ref: tlmgr *--taxonomy* 1135624
-Ref: tlmgr *--keyword* 1135636
-Ref: tlmgr *--functionality* 1135654
-Ref: tlmgr *--characterization* 1135675
-Ref: tlmgr *--all* 2135830
-Node: tlmgr uninstall135913
-Ref: tlmgr *--force* 3136167
-Node: tlmgr update [_option_]... [_pkg_]...136223
-Ref: tlmgr *--all* 3136594
-Ref: tlmgr *--self*138335
-Ref: tlmgr *--dry-run* 5139099
-Ref: tlmgr *--list* [_pkg_]139276
-Ref: tlmgr *--exclude* _pkg_139965
-Ref: tlmgr *--no-auto-remove* [_pkg_]...140658
-Ref: tlmgr *--no-auto-install* [_pkg_]...141109
-Ref: tlmgr *--reinstall-forcibly-removed*141765
-Ref: tlmgr *--backup* and *--backupdir* _directory_142329
-Ref: tlmgr *--no-depends* 2143510
-Ref: tlmgr *--no-depends-at-all* 2143713
-Ref: tlmgr *--force* 4143769
-Node: tlmgr USER MODE144195
-Node: tlmgr user mode install147006
-Node: tlmgr user mode backup; restore; remove; update147953
-Node: tlmgr user mode generate; option; paper148395
-Node: tlmgr CONFIGURATION FILE FOR TLMGR148771
-Node: tlmgr TAXONOMIES149862
-Ref: tlmgr --keyword 2150488
-Ref: tlmgr --functionality 2150573
-Ref: tlmgr --characterization 2150729
-Ref: tlmgr --taxonomy 2150870
-Node: tlmgr MULTIPLE REPOSITORIES151411
-Node: tlmgr Pinning153132
-Node: tlmgr GUI FOR TLMGR155107
-Node: tlmgr Main display156329
-Node: tlmgr Display configuration area156581
-Ref: tlmgr Status156942
-Ref: tlmgr Category157106
-Ref: tlmgr Match157292
-Ref: tlmgr Selection157552
-Ref: tlmgr Display configuration buttons157756
-Node: tlmgr Package list area157939
-Ref: tlmgr a checkbox158523
-Ref: tlmgr package name158659
-Ref: tlmgr local revision (and version)158758
-Ref: tlmgr remote revision (and version)159133
-Ref: tlmgr short description159430
-Node: tlmgr Main display action buttons159475
-Ref: tlmgr Update all installed159741
-Ref: tlmgr Update160113
-Ref: tlmgr Install160163
-Ref: tlmgr Remove160349
-Ref: tlmgr Backup160527
-Node: tlmgr Menu bar160684
-Ref: tlmgr tlmgr menu160881
-Ref: tlmgr Options menu161189
-Ref: tlmgr Actions menu162272
-Ref: tlmgr Help menu162700
-Node: tlmgr MACHINE-READABLE OUTPUT162833
-Node: tlmgr Machine-readable update and install output163643
-Ref: tlmgr location-url _location_164919
-Ref: tlmgr total-bytes _count_165135
-Ref: tlmgr _pkgname_165545
-Ref: tlmgr _status_165755
-Ref: tlmgr d165833
-Ref: tlmgr f165893
-Ref: tlmgr u166072
-Ref: tlmgr r166118
-Ref: tlmgr a166241
-Ref: tlmgr i166419
-Ref: tlmgr I166538
-Ref: tlmgr _localrev_166640
-Ref: tlmgr _serverrev_166747
-Ref: tlmgr _size_166859
-Ref: tlmgr _runtime_167028
-Ref: tlmgr _esttot_167098
-Node: tlmgr Machine-readable option output167131
-Node: tlmgr AUTHORS AND COPYRIGHT167643
-Node: Index167990
+Node: Building8073
+Node: Build iteration9321
+Node: Build problems10393
+Node: Build in parallel10796
+Node: Build distribution11388
+Node: Build one package11959
+Node: Installing15545
+Node: Installation directories16560
+Node: Linked scripts18376
+Node: Distro builds19857
+Node: Layout and infrastructure22247
+Node: Build system tools23036
+Node: Top-level directories25045
+Node: Autoconf macros27086
+Node: General setup macros27787
+Node: Macros for programs28654
+Node: Macros for compilers29466
+Node: Macros for libraries30900
+Node: Macros for library and header flags31326
+Node: Macros for Windows33206
+Node: Library modules34783
+Node: png library35272
+Node: zlib library37561
+Node: freetype library38076
+Node: kpathsea library38604
+Node: Program modules40003
+Node: t1utils package40431
+Node: xindy package40994
+Node: xdvik package42173
+Node: asymptote43246
+Node: Extending TeX Live43697
+Node: Adding a new program module44065
+Node: Adding a new generic library module45584
+Node: Adding a new TeX-specific library module47797
+Node: Configure options48484
+Node: Global configure options49866
+Node: --disable-native-texlive-build50408
+Node: --prefix --bindir ...51398
+Node: --disable-largefile51938
+Node: --disable-missing52623
+Node: --enable-compiler-warnings=LEVEL53024
+Node: --enable-cxx-runtime-hack53763
+Node: --enable-maintainer-mode54190
+Node: --enable-multiplatform54719
+Node: --enable-shared55257
+Node: --enable-silent-rules55628
+Node: --without-ln-s56084
+Node: --without-x56435
+Node: Program-specific configure options56623
+Node: --enable-PROG --disable-PROG57266
+Node: --disable-all-pkgs57543
+Node: Configure options for texk/web2c58529
+Node: Configure options for texk/bibtex-x61047
+Node: Configure options for texk/dvipdfm-x61590
+Node: Configure options for texk/dvisvgm62363
+Node: Configure options for texk/texlive63249
+Node: Configure options for texk/xdvik63670
+Node: Configure options for utils/xindy64274
+Node: Library-specific configure options65175
+Node: Configure options for kpathsea66186
+Node: Configure options for system poppler66895
+Node: Variables for configure67686
+Node: Cross compilation69114
+Node: Cross configuring70413
+Node: Cross problems72086
+Node: Coding conventions73733
+Node: Declarations and definitions74402
+Node: Const76584
+Node: install-tl78447
+Node: install-tl NAME78788
+Node: install-tl SYNOPSIS78946
+Node: install-tl DESCRIPTION79154
+Node: install-tl REFERENCES80155
+Node: install-tl OPTIONS80671
+Ref: install-tl *-gui* [[=]_module_]81025
+Ref: install-tl text81234
+Ref: install-tl wizard81357
+Ref: install-tl perltk81511
+Ref: install-tl *-no-gui*81945
+Ref: install-tl *-lang* _llcode_82026
+Ref: install-tl *-repository* _url|path_82713
+Ref: install-tl *-select-repository*84524
+Ref: install-tl *-all-options*84960
+Ref: install-tl *-custom-bin* _path_85267
+Ref: install-tl *-debug-translation*85922
+Ref: install-tl *-force-platform* _platform_86141
+Ref: install-tl *-help*, *--help*, *-?*86385
+Ref: install-tl *-in-place*86778
+Ref: install-tl *-logfile* _file_87305
+Ref: install-tl *-no-cls*87656
+Ref: install-tl *-non-admin*87787
+Ref: install-tl *--persistent-downloads*87892
+Ref: install-tl *--no-persistent-downloads*87920
+Ref: install-tl *-portable*88528
+Ref: install-tl *-print-platform*88667
+Ref: install-tl *-profile* _profile_88860
+Ref: install-tl *-q*90354
+Ref: install-tl *-scheme* _scheme_90416
+Ref: install-tl *-v*90890
+Ref: install-tl *-version*, *--version*91051
+Node: install-tl ENVIRONMENT VARIABLES91182
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK91571
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE91773
+Ref: install-tl TEXLIVE_INSTALL_PREFIX91879
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG91910
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME91939
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL91969
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG92003
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR92034
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR92062
+Ref: install-tl NOPERLDOC92117
+Node: install-tl AUTHORS AND COPYRIGHT92181
+Node: tlmgr92539
+Node: tlmgr NAME92976
+Node: tlmgr SYNOPSIS93101
+Node: tlmgr DESCRIPTION93291
+Node: tlmgr EXAMPLES94387
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet94678
+Ref: tlmgr tlmgr update --list94859
+Ref: tlmgr tlmgr update --all94952
+Ref: tlmgr tlmgr info _pkg_95108
+Node: tlmgr OPTIONS95314
+Ref: tlmgr *--repository* _url|path_95834
+Ref: tlmgr *--gui* [_action_]96559
+Ref: tlmgr *--gui-lang* _llcode_96966
+Ref: tlmgr *--debug-translation*97649
+Ref: tlmgr *--machine-readable*97852
+Ref: tlmgr *--no-execute-actions*98120
+Ref: tlmgr *--package-logfile* _file_98313
+Ref: tlmgr *--pause*98568
+Ref: tlmgr *--persistent-downloads*98723
+Ref: tlmgr *--no-persistent-downloads*98751
+Ref: tlmgr *--pin-file*99245
+Ref: tlmgr *--usermode*99463
+Ref: tlmgr *--usertree* _dir_99583
+Node: tlmgr ACTIONS100133
+Node: tlmgr help101365
+Node: tlmgr version101841
+Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...102159
+Ref: tlmgr *--backupdir* _directory_103253
+Ref: tlmgr *--all*103450
+Ref: tlmgr *--clean*[=_N_]103672
+Ref: tlmgr *--dry-run*103969
+Node: tlmgr candidates _pkg_104089
+Ref: tlmgr *candidates _pkg_* 1104376
+Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]104520
+Ref: tlmgr *files*104963
+Ref: tlmgr *depends*105098
+Ref: tlmgr *executes*105440
+Ref: tlmgr *runfiles*105558
+Ref: tlmgr *--use-svn*105670
+Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]105787
+Node: tlmgr dump-tlpdb [--local|--remote]107859
+Ref: tlmgr *--local*108369
+Ref: tlmgr *--remote*108408
+Node: tlmgr generate [_option_]... _what_108830
+Ref: tlmgr *generate language*109071
+Ref: tlmgr *generate language.dat*109096
+Ref: tlmgr *generate language.def*109121
+Ref: tlmgr *generate language.dat.lua*109150
+Ref: tlmgr *generate fmtutil*109170
+Ref: tlmgr *--dest* _output_file_111407
+Ref: tlmgr *--localcfg* _local_conf_file_111983
+Ref: tlmgr *--rebuild-sys*112106
+Node: tlmgr gui112967
+Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]113211
+Ref: tlmgr *--list*114416
+Ref: tlmgr *--only-installed*114695
+Ref: tlmgr *--taxonomy*114910
+Ref: tlmgr *--keyword*114922
+Ref: tlmgr *--functionality*114940
+Ref: tlmgr *--characterization*114961
+Node: tlmgr init-usertree115174
+Node: tlmgr install [_option_]... _pkg_...115600
+Ref: tlmgr *--file*115964
+Ref: tlmgr *--reinstall*116190
+Ref: tlmgr *--no-depends*116570
+Ref: tlmgr *--no-depends-at-all*116729
+Ref: tlmgr *--dry-run* 1117127
+Ref: tlmgr *--force*117245
+Node: tlmgr option117451
+Ref: tlmgr *option [show]*117624
+Ref: tlmgr *option showall*117642
+Ref: tlmgr *option _key_ [_value_]*117668
+Node: tlmgr paper121516
+Ref: tlmgr *paper [a4|letter]*121701
+Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*121775
+Node: tlmgr path [--w32mode=user|admin] [add|remove]122802
+Node: tlmgr pinning124285
+Ref: tlmgr pinning show124592
+Ref: tlmgr pinning add _repo_ _pkgglob_...124665
+Ref: tlmgr pinning remove _repo_ _pkgglob_...124784
+Ref: tlmgr pinning remove _repo_ --all124937
+Node: tlmgr platform list|add|remove _platform_...124991
+Node: tlmgr platform set _platform_125239
+Node: tlmgr platform set auto125467
+Ref: tlmgr *--dry-run* 2126584
+Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...126693
+Node: tlmgr print-platform127995
+Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]128467
+Ref: tlmgr *--all* 1129363
+Ref: tlmgr *--backupdir* _directory_ 1129557
+Ref: tlmgr *--dry-run* 3129713
+Ref: tlmgr *--force* 1129830
+Node: tlmgr remove [_option_]... _pkg_...129858
+Ref: tlmgr *--no-depends* 1130381
+Ref: tlmgr *--no-depends-at-all* 1130443
+Ref: tlmgr *--force* 2130499
+Ref: tlmgr *--dry-run* 4130971
+Node: tlmgr repository131078
+Ref: tlmgr *repository list*131286
+Ref: tlmgr *repository list _path|tag_*131316
+Ref: tlmgr *repository add _path_ [_tag_]*131349
+Ref: tlmgr *repository remove _path|tag_*131381
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*131435
+Node: tlmgr search [_option_...] _what_132519
+Node: tlmgr search [_option_...] --file _what_133030
+Node: tlmgr search [_option_...] --taxonomy _what_133281
+Node: tlmgr search [_option_...] --keyword _what_133592
+Node: tlmgr search [_option_...] --functionality _what_133910
+Node: tlmgr search [_option_...] --characterization _what_134248
+Node: tlmgr search [_option_...] --all _what_134588
+Ref: tlmgr *--global*135036
+Ref: tlmgr *--word*135148
+Ref: tlmgr *--list* 1135387
+Ref: tlmgr *--file* 1135733
+Ref: tlmgr *--taxonomy* 1135790
+Ref: tlmgr *--keyword* 1135802
+Ref: tlmgr *--functionality* 1135820
+Ref: tlmgr *--characterization* 1135841
+Ref: tlmgr *--all* 2135996
+Node: tlmgr uninstall136079
+Ref: tlmgr *--force* 3136333
+Node: tlmgr update [_option_]... [_pkg_]...136389
+Ref: tlmgr *--all* 3136760
+Ref: tlmgr *--self*138501
+Ref: tlmgr *--dry-run* 5139265
+Ref: tlmgr *--list* [_pkg_]139442
+Ref: tlmgr *--exclude* _pkg_140131
+Ref: tlmgr *--no-auto-remove* [_pkg_]...140824
+Ref: tlmgr *--no-auto-install* [_pkg_]...141275
+Ref: tlmgr *--reinstall-forcibly-removed*141931
+Ref: tlmgr *--backup* and *--backupdir* _directory_142495
+Ref: tlmgr *--no-depends* 2143676
+Ref: tlmgr *--no-depends-at-all* 2143879
+Ref: tlmgr *--force* 4143935
+Node: tlmgr USER MODE144361
+Node: tlmgr user mode install147172
+Node: tlmgr user mode backup; restore; remove; update148119
+Node: tlmgr user mode generate; option; paper148561
+Node: tlmgr CONFIGURATION FILE FOR TLMGR148937
+Node: tlmgr TAXONOMIES150028
+Ref: tlmgr --keyword 2150654
+Ref: tlmgr --functionality 2150739
+Ref: tlmgr --characterization 2150895
+Ref: tlmgr --taxonomy 2151036
+Node: tlmgr MULTIPLE REPOSITORIES151577
+Node: tlmgr Pinning153298
+Node: tlmgr GUI FOR TLMGR155273
+Node: tlmgr Main display156495
+Node: tlmgr Display configuration area156747
+Ref: tlmgr Status157108
+Ref: tlmgr Category157272
+Ref: tlmgr Match157458
+Ref: tlmgr Selection157718
+Ref: tlmgr Display configuration buttons157922
+Node: tlmgr Package list area158105
+Ref: tlmgr a checkbox158689
+Ref: tlmgr package name158825
+Ref: tlmgr local revision (and version)158924
+Ref: tlmgr remote revision (and version)159299
+Ref: tlmgr short description159596
+Node: tlmgr Main display action buttons159641
+Ref: tlmgr Update all installed159907
+Ref: tlmgr Update160279
+Ref: tlmgr Install160329
+Ref: tlmgr Remove160515
+Ref: tlmgr Backup160693
+Node: tlmgr Menu bar160850
+Ref: tlmgr tlmgr menu161047
+Ref: tlmgr Options menu161355
+Ref: tlmgr Actions menu162438
+Ref: tlmgr Help menu162866
+Node: tlmgr MACHINE-READABLE OUTPUT162999
+Node: tlmgr Machine-readable update and install output163809
+Ref: tlmgr location-url _location_165085
+Ref: tlmgr total-bytes _count_165301
+Ref: tlmgr _pkgname_165711
+Ref: tlmgr _status_165921
+Ref: tlmgr d165999
+Ref: tlmgr f166059
+Ref: tlmgr u166238
+Ref: tlmgr r166284
+Ref: tlmgr a166407
+Ref: tlmgr i166585
+Ref: tlmgr I166704
+Ref: tlmgr _localrev_166806
+Ref: tlmgr _serverrev_166913
+Ref: tlmgr _size_167025
+Ref: tlmgr _runtime_167194
+Ref: tlmgr _esttot_167264
+Node: tlmgr Machine-readable option output167297
+Node: tlmgr AUTHORS AND COPYRIGHT167809
+Node: Index168156
 
 End Tag Table
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 8aa305f8267..da48523a166 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -282,6 +282,14 @@ your timestamps---notably, @code{use-commit-times} must be set to
 tools}).  Barring buggy commits, no infrastructure tools are needed to
 do a normal build.
 
+@cindex Debian installation of build prerequisites
+As an example, on Debian systems the necessary build dependencies can
+be installed via:
+
+@example
+apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
+@end example
+
 
 @node Building
 @chapter Building