summaryrefslogtreecommitdiff
path: root/Build
diff options
context:
space:
mode:
Diffstat (limited to 'Build')
-rw-r--r--Build/source/doc/ChangeLog5
-rw-r--r--Build/source/doc/tlbuild.info802
-rw-r--r--Build/source/doc/tlbuild.texi58
3 files changed, 436 insertions, 429 deletions
diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog
index 1f529124814..7eb81910bf4 100644
--- a/Build/source/doc/ChangeLog
+++ b/Build/source/doc/ChangeLog
@@ -1,3 +1,7 @@
+2019-08-11 Karl Berry <karl@freefriends.org>
+
+ * tlbuild.texi (Build one package): rm sources to build without C++11.
+
2018-04-10 Karl Berry <karl@tug.org>
* tlbuild.texi (Cross compilation): move to under Building.
@@ -5,7 +9,6 @@
* Makefile.am (*_node_{good,bad}): update for current pod doc.
($(mydoc)-incl.texi): hint to symlink scripts for pod2texi.
-
2018-02-20 Karl Berry <karl@freefriends.org>
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index 59e87232c4e..3b71c77562c 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -169,19 +169,18 @@ Automake/Autoconf output in general) work with any reasonable 'make'.
A C++11 compiler is similarly required because of the third-party
libraries ICU and Poppler; the program 'dvisvgm' also requires C++11.
-It is possible to build everything else with older compilers;
-<https://tug.org/texlive/custom-bin.html> links to a build script for
-doing this.
+It is possible to build everything else with older compilers, but you
+have to remove the C++11-dependent sources. *Note Build one package::.
- However, a few programs in the tree have additional requirements:
+ A few programs in the tree have additional requirements:
'web2c'
requires 'perl' for some tests run by 'make check'.
'xdvik'
'xpdfopen'
- require X11 headers and libraries, often in "development" packages
- that are not installed by default.
+ require X11 headers and libraries, typically in "development"
+ packages that are not installed by default.
'xetex'
requires 'fontconfig' (again both headers and library), or, for
@@ -189,8 +188,8 @@ doing this.
'xindy'
requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally,
- to build the rules and/or documentation: 'perl', 'latex', and
- 'pdflatex'
+ to build the rules and/or documentation: 'perl', 'latex',
+ 'pdflatex'.
Lacking the required tools, building these programs must avoided, e.g.,
'configure --without-x --disable-xetex --disable-xindy'
@@ -329,16 +328,9 @@ library modules are configured but none are made. However, the
invoked to build an individual program or library, first building any
required libraries.
- This "build-on-demand" procedure is used, e.g., in the upstream
-LuaTeX repository to build LuaTeX, from a subset of the complete
-TeX Live source tree. As another example, when 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
-finish for working on 'dvipdfm-x'.
+ 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.)
mkdir mydir && cd mydir # new working directory
@@ -387,10 +379,19 @@ this approach, see the 'build-pdftex.sh' script in the 'pdftex'
development source (details at <http://pdftex.org>), which is indeed
such a cut-down TL source tree.
- 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.
+ Some libraries and programs require C++11. If you want to build with
+an older compiler lacking such support, you need to (re)move those
+source directories; specifying '--disable' for them does not suffice,
+unfortunately. Specifically, before running 'configure':
+
+ rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm
+
+ Also, even with '--disable-all-pkgs', dependencies are (currently)
+checked. For instance, if a (non-MacOSX) system does not have
+'fontconfig', XeTeX cannot be built (*note Prerequisites::), and
+'configure' will terminate even with '--disable-xetex'. To proceed
+without such dependencies, specify '--enable-missing' also. (Patches to
+improve this would be most welcome.)
By default, the 'gcc' compilers will be used if present; otherwise,
individual packages may use something different. You can explicitly
@@ -417,8 +418,9 @@ explicitly specify what to make. For example, to build only LuaTeX:
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 (as the
-separate pdfTeX and LuaTeX source repositories do).
+can be cut down to just what is needed for the given engine (the
+separate pdfTeX and LuaTeX source repositories do this, if you want to
+peruse examples).
We hope to improve the situation in the future. Patches are welcome.
@@ -771,7 +773,6 @@ runs of 'bison', 'flex', or 'makeinfo' with 'touch' of the generated
('.c', '.h', or '.info') files. With '--enable-maintainer-mode' it may
also be necessary to 'touch' first 'aclocal.m4', then 'configure' and
'config.h.in' (or 'c-auto.in'), and finally all 'Makefile.in' files.
-Perhaps 'make -t' will help.

File: tlbuild.info, Node: Top-level directories, Next: Autoconf macros, Prev: Build system tools, Up: Layout and infrastructure
@@ -5175,7 +5176,7 @@ Index
* ANSI C: Declarations and definitions.
(line 6)
* ApplicationServices Mac framework, required by xetex: Prerequisites.
- (line 32)
+ (line 31)
* asymptote: Linked scripts. (line 23)
* asymptote <1>: asymptote. (line 6)
* Autoconf: Overview of build system.
@@ -5206,6 +5207,7 @@ Index
* building: Building. (line 6)
* building a distribution: Build distribution. (line 6)
* building in parallel: Build in parallel. (line 6)
+* C++11, removing dependent sources: Build one package. (line 64)
* C++11, required: Prerequisites. (line 15)
* C, ANSI, required: Declarations and definitions.
(line 6)
@@ -5216,7 +5218,7 @@ Index
* callexe.c: Macros for Windows. (line 32)
* CC: Variables for configure.
(line 10)
-* CC=C-COMPILER: Build one package. (line 76)
+* CC=C-COMPILER: Build one package. (line 78)
* CC_BUILD: Cross problems. (line 13)
* chktex: Declarations and definitions.
(line 18)
@@ -5226,8 +5228,8 @@ Index
(line 17)
* CLISP <1>: Configure options for utils/xindy.
(line 14)
-* clisp, required by xindy: Prerequisites. (line 36)
-* Cocoa Mac framework, required by xetex: Prerequisites. (line 32)
+* clisp, required by xindy: Prerequisites. (line 35)
+* Cocoa Mac framework, required by xetex: Prerequisites. (line 31)
* coding conventions: Coding conventions. (line 6)
* compilers, C and C++11: Prerequisites. (line 6)
* config.guess, config.sub, ...: Top-level directories.
@@ -5273,7 +5275,7 @@ Index
* ctangle: Cross problems. (line 26)
* CXX: Variables for configure.
(line 11)
-* CXX=C++-COMPILER: Build one package. (line 76)
+* CXX=C++-COMPILER: Build one package. (line 78)
* declarations and definitions, in source code: Declarations and definitions.
(line 6)
* declarations before statements, avoiding: Declarations and definitions.
@@ -5305,7 +5307,7 @@ Index
* failure to build: Build problems. (line 6)
* flags, macros for library and header: Macros for library and header flags.
(line 6)
-* fontconfig library, required by xetex: Prerequisites. (line 32)
+* fontconfig library, required by xetex: Prerequisites. (line 31)
* FreeType: Prerequisites. (line 11)
* freetype cross compiling: Cross problems. (line 13)
* freetype library: freetype library. (line 6)
@@ -5314,7 +5316,7 @@ Index
(line 24)
* FT2_CONFIG: Variables for configure.
(line 21)
-* gcc, default compilers: Build one package. (line 76)
+* gcc, default compilers: Build one package. (line 78)
* general setup macros: General setup macros. (line 6)
* generic library module, adding: Adding a new generic library module.
(line 6)
@@ -5434,7 +5436,7 @@ Index
* library modules: Library modules. (line 6)
* library-specific configure options: Library-specific configure options.
(line 6)
-* libsigsegv, required by xindy: Prerequisites. (line 36)
+* libsigsegv, required by xindy: Prerequisites. (line 35)
* libstc++, statically linking: Macros for compilers. (line 29)
* Libtool: Overview of build system.
(line 6)
@@ -5473,7 +5475,7 @@ Index
* motif: Configure options for texk/xdvik.
(line 9)
* native cross compilation: Cross compilation. (line 10)
-* OBJCXX=OBJC-COMPILER: Build one package. (line 76)
+* OBJCXX=OBJC-COMPILER: Build one package. (line 78)
* one engine, building: Build one engine. (line 6)
* one package, building: Build one package. (line 6)
* OpenGL, required for Asymptote: asymptote. (line 6)
@@ -5488,7 +5490,7 @@ Index
(line 41)
* PERL: Variables for configure.
(line 39)
-* perl, required by web2c, etc.: Prerequisites. (line 24)
+* perl, required by web2c, etc.: Prerequisites. (line 23)
* PKG_CONFIG: Variables for configure.
(line 23)
* plain.tex, not in source tree: Installing. (line 8)
@@ -5518,7 +5520,7 @@ Index
* setup macros, general: General setup macros. (line 6)
* shared libraries, using vs. avoiding: Distro builds. (line 11)
* size of PDF and PS files: --disable-largefile. (line 11)
-* size of source tree: Build one package. (line 60)
+* size of source tree: Build one package. (line 53)
* source code declarations: Declarations and definitions.
(line 6)
* source directory building, not supported: Building. (line 17)
@@ -5580,7 +5582,7 @@ Index
* wrapper build system: freetype library. (line 6)
* X toolkit: Configure options for texk/web2c.
(line 22)
-* X11 development, required by X clients: Prerequisites. (line 28)
+* X11 development, required by X clients: Prerequisites. (line 27)
* X11 headers, and const: Const. (line 21)
* xasy: asymptote. (line 6)
* xaw: Configure options for texk/xdvik.
@@ -5611,368 +5613,368 @@ Node: Top1208
Node: Introduction2118
Node: Overview of build system3946
Node: Prerequisites5997
-Node: Building8616
-Node: Build iteration10002
-Node: Build problems11043
-Node: Build in parallel11497
-Node: Build distribution12101
-Node: Build one package12749
-Node: Build one engine16384
-Node: Cross compilation17399
-Node: Cross configuring18679
-Node: Cross problems20356
-Node: Installing22018
-Node: Installation directories23038
-Node: Linked scripts24856
-Node: Distro builds26347
-Node: Layout and infrastructure28723
-Node: Build system tools29554
-Node: Top-level directories31800
-Node: Autoconf macros34036
-Node: General setup macros34798
-Node: Macros for programs35673
-Node: Macros for compilers36474
-Node: Macros for libraries37882
-Node: Macros for library and header flags38308
-Node: Macros for Windows40219
-Node: Library modules41806
-Node: png library42295
-Node: zlib library44643
-Node: freetype library45158
-Node: kpathsea library45854
-Node: Program modules47233
-Node: t1utils package47661
-Node: xindy package48206
-Node: xdvik package49320
-Node: asymptote50379
-Node: Extending TeX Live50875
-Node: Adding a new program module51658
-Node: Adding a new generic library module54997
-Node: Adding a new TeX-specific library module57226
-Node: Configure options57924
-Node: Global configure options59305
-Node: --disable-native-texlive-build59847
-Node: --prefix --bindir ...60809
-Node: --disable-largefile61349
-Node: --disable-missing62050
-Node: --enable-compiler-warnings=LEVEL62451
-Node: --enable-cxx-runtime-hack63107
-Node: --enable-maintainer-mode63527
-Node: --enable-multiplatform64056
-Node: --enable-shared64629
-Node: --enable-silent-rules65000
-Node: --without-ln-s65452
-Node: --without-x65799
-Node: Program-specific configure options65987
-Node: --enable-PROG --disable-PROG66630
-Node: --disable-all-pkgs66903
-Node: Configure options for texk/web2c67686
-Node: Configure options for texk/bibtex-x70224
-Node: Configure options for texk/dvipdfm-x70767
-Node: Configure options for texk/dvisvgm71543
-Node: Configure options for texk/texlive72424
-Node: Configure options for texk/xdvik72845
-Node: Configure options for utils/xindy73466
-Node: Library-specific configure options74356
-Node: Configure options for kpathsea75358
-Node: Configure options for system poppler76107
-Node: Variables for configure76871
-Node: Coding conventions78297
-Node: Declarations and definitions79012
-Node: Const81186
-Node: Continuous integration83050
-Node: Transfer from Subversion to Github83714
-Node: Automatic update of the Git mirror85876
-Node: CI testing on Travis-CI86458
-Node: Releases on Github87167
-Node: install-tl87607
-Node: install-tl NAME87976
-Node: install-tl SYNOPSIS88134
-Node: install-tl DESCRIPTION88392
-Node: install-tl REFERENCES89459
-Node: install-tl OPTIONS89985
-Ref: install-tl *-gui* [[=]_module_]90326
-Ref: install-tl text90536
-Ref: install-tl wizard90659
-Ref: install-tl perltk90813
-Ref: install-tl *-no-gui*91244
-Ref: install-tl *-lang* _llcode_91325
-Ref: install-tl *-repository* _url|path_92012
-Ref: install-tl *-select-repository*93892
-Ref: install-tl *-all-options*94328
-Ref: install-tl *-custom-bin* _path_94583
-Ref: install-tl *-debug-translation*95415
-Ref: install-tl *-force-platform* _platform_95634
-Ref: install-tl *-help*, *--help*, *-?*95878
-Ref: install-tl *-in-place*96285
-Ref: install-tl *-init-from-profile* _profile_file_96830
-Ref: install-tl *-logfile* _file_97050
-Ref: install-tl *-no-cls*97401
-Ref: install-tl *-non-admin*97535
-Ref: install-tl *-persistent-downloads*97640
-Ref: install-tl *-no-persistent-downloads*97668
-Ref: install-tl *-no-verify-downloads*98286
-Ref: install-tl *-portable*98647
-Ref: install-tl *-print-platform*98786
-Ref: install-tl *-profile* _profile_file_98984
-Ref: install-tl *-q*99164
-Ref: install-tl *-scheme* _scheme_99226
-Ref: install-tl *-v*99700
-Ref: install-tl *-version*, *--version*99855
-Node: install-tl PROFILES99986
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102636
-Ref: install-tl instopt_adjustrepo (default 1)102712
-Ref: install-tl instopt_letter (default 0)102849
-Ref: install-tl instopt_portable (default 0)102940
-Ref: install-tl instopt_write18_restricted (default 1)103036
-Node: install-tl ENVIRONMENT VARIABLES104355
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104746
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104948
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105058
-Ref: install-tl TEXLIVE_INSTALL_PREFIX105179
-Ref: install-tl TEXLIVE_INSTALL_TEXDIR105205
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105236
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105264
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105293
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105323
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105357
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105388
-Ref: install-tl NOPERLDOC105759
-Node: install-tl AUTHORS AND COPYRIGHT105823
-Node: tlmgr106239
-Node: tlmgr NAME106692
-Node: tlmgr SYNOPSIS106824
-Node: tlmgr DESCRIPTION107014
-Node: tlmgr EXAMPLES108110
-Ref: tlmgr tlmgr option repository ctan108361
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108433
-Ref: tlmgr tlmgr update --list108885
-Ref: tlmgr tlmgr update --all108978
-Ref: tlmgr tlmgr info _what_109135
-Node: tlmgr OPTIONS109397
-Ref: tlmgr *--repository* _url|path_109917
-Ref: tlmgr *--gui* [_action_]110642
-Ref: tlmgr *--gui-lang* _llcode_111049
-Ref: tlmgr *--debug-translation*111732
-Ref: tlmgr *--machine-readable*111935
-Ref: tlmgr *--no-execute-actions*112203
-Ref: tlmgr *--package-logfile* _file_112396
-Ref: tlmgr *--pause*112650
-Ref: tlmgr *--persistent-downloads*112805
-Ref: tlmgr *--no-persistent-downloads*112833
-Ref: tlmgr *--pin-file*113327
-Ref: tlmgr *--usermode*113545
-Ref: tlmgr *--usertree* _dir_113665
-Ref: tlmgr *--verify-repo=[none|main|all]*113791
-Node: tlmgr ACTIONS114690
-Node: tlmgr help115542
-Node: tlmgr version116018
-Node: tlmgr backup116281
-Ref: tlmgr *backup [_option_...] --all*116452
-Ref: tlmgr *backup [_option_...] _pkg_...*116485
-Ref: tlmgr *--backupdir* _directory_117340
-Ref: tlmgr *--all*117557
-Ref: tlmgr *--clean*[=_N_]117809
-Ref: tlmgr *--dry-run*118136
-Node: tlmgr candidates _pkg_118266
-Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118612
-Ref: tlmgr *files*118985
-Ref: tlmgr *depends*119120
-Ref: tlmgr *executes*119462
-Ref: tlmgr *runfiles*119580
-Ref: tlmgr *--use-svn*119701
-Node: tlmgr conf119818
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*120097
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*120161
-Node: tlmgr dump-tlpdb [_option_...] [--json]122506
-Ref: tlmgr *--local*122939
-Ref: tlmgr *--remote*122978
-Ref: tlmgr *--json*123016
-Node: tlmgr generate123587
-Ref: tlmgr *generate [_option_...] language*123783
-Ref: tlmgr *generate [_option_...] language.dat*123822
-Ref: tlmgr *generate [_option_...] language.def*123861
-Ref: tlmgr *generate [_option_...] language.dat.lua*123904
-Ref: tlmgr *--dest* _output_file_126230
-Ref: tlmgr *--localcfg* _local_conf_file_126806
-Ref: tlmgr *--rebuild-sys*126929
-Node: tlmgr gui127744
-Node: tlmgr info127922
-Ref: tlmgr *info [_option_...] _pkg_...*128084
-Ref: tlmgr *info [_option_...] collections*128118
-Ref: tlmgr *info [_option_...] schemes*128148
-Ref: tlmgr *--list*129678
-Ref: tlmgr *--only-installed*129992
-Ref: tlmgr *--data item1,item2,...*130191
-Ref: tlmgr *--json* 1130772
-Node: tlmgr init-usertree131155
-Node: tlmgr install [_option_...] _pkg_...131536
-Ref: tlmgr *--dry-run* 1132046
-Ref: tlmgr *--file*132163
-Ref: tlmgr *--force*132385
-Ref: tlmgr *--no-depends*132605
-Ref: tlmgr *--no-depends-at-all*132764
-Ref: tlmgr *--reinstall*133164
-Ref: tlmgr *--with-doc*133542
-Ref: tlmgr *--with-src*133555
-Node: tlmgr key134077
-Ref: tlmgr *key list*134235
-Ref: tlmgr *key add _file_*134253
-Ref: tlmgr *key remove _keyid_*134275
-Node: tlmgr list134870
-Node: tlmgr option135032
-Ref: tlmgr *option [--json] [show]*135187
-Ref: tlmgr *option [--json] showall*135213
-Ref: tlmgr *option _key_ [_value_]*135239
-Node: tlmgr paper139636
-Ref: tlmgr *paper [a4|letter]*139785
-Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139859
-Ref: tlmgr *paper --json*139874
-Node: tlmgr path141089
-Ref: tlmgr *path [--w32mode=user|admin] add*141250
-Ref: tlmgr *path [--w32mode=user|admin] remove*141287
-Node: tlmgr pinning142627
-Ref: tlmgr pinning show142868
-Ref: tlmgr pinning add _repo_ _pkgglob_...142941
-Ref: tlmgr pinning remove _repo_ _pkgglob_...143060
-Ref: tlmgr pinning remove _repo_ --all143213
-Node: tlmgr platform143267
-Ref: tlmgr *platform list|add|remove _platform_...*143453
-Ref: tlmgr *platform set _platform_*143480
-Ref: tlmgr *platform set auto*143501
-Ref: tlmgr *--dry-run* 2144387
-Node: tlmgr postaction144506
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144736
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144810
-Ref: tlmgr *--w32mode=[user|admin]*145125
-Ref: tlmgr *--fileassocmode=[1|2]*145541
-Ref: tlmgr *--all* 1145826
-Node: tlmgr print-platform145881
-Node: tlmgr print-platform-info146212
-Node: tlmgr remove [_option_...] _pkg_...146512
-Ref: tlmgr *--all* 2146996
-Ref: tlmgr *--backup*147106
-Ref: tlmgr *--backupdir* _directory_ 1147132
-Ref: tlmgr *--no-depends* 1147537
-Ref: tlmgr *--no-depends-at-all* 1147599
-Ref: tlmgr *--force* 1147702
-Ref: tlmgr *--dry-run* 3148175
-Node: tlmgr repository148282
-Ref: tlmgr *repository list*148470
-Ref: tlmgr *repository list _path|tag_*148500
-Ref: tlmgr *repository add _path_ [_tag_]*148533
-Ref: tlmgr *repository remove _path|tag_*148565
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148619
-Node: tlmgr restore149672
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149851
-Ref: tlmgr *restore [_option_...] --all*149881
-Ref: tlmgr *--all* 3150581
-Ref: tlmgr *--backupdir* _directory_ 2150795
-Ref: tlmgr *--dry-run* 4150976
-Ref: tlmgr *--force* 2151108
-Ref: tlmgr *--json* 2151154
-Node: tlmgr search151481
-Ref: tlmgr *search [_option_...] _what_*151645
-Ref: tlmgr *search [_option_...] --file _what_*151682
-Ref: tlmgr *search [_option_...] --all _what_*151718
-Ref: tlmgr *--file* 1151938
-Ref: tlmgr *--all* 4152000
-Ref: tlmgr *--global*152089
-Ref: tlmgr *--word*152216
-Node: tlmgr shell152531
-Ref: tlmgr protocol153266
-Ref: tlmgr help 1153330
-Ref: tlmgr version 1153383
-Ref: tlmgr quit, end, bye, byebye, EOF153451
-Ref: tlmgr restart153472
-Ref: tlmgr load [local|remote]153595
-Ref: tlmgr save153665
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153788
-Node: tlmgr show154389
-Node: tlmgr uninstall154556
-Node: tlmgr update [_option_...] [_pkg_...]154786
-Ref: tlmgr *--all* 5155157
-Ref: tlmgr *--self*156898
-Ref: tlmgr *--dry-run* 5157662
-Ref: tlmgr *--list* [_pkg_]157839
-Ref: tlmgr *--exclude* _pkg_158528
-Ref: tlmgr *--no-auto-remove* [_pkg_...]159328
-Ref: tlmgr *--no-auto-install* [_pkg_...]159779
-Ref: tlmgr *--reinstall-forcibly-removed*160435
-Ref: tlmgr *--backup* 1160970
-Ref: tlmgr *--backupdir* _directory_ 3160996
-Ref: tlmgr *--no-depends* 2162162
-Ref: tlmgr *--no-depends-at-all* 2162365
-Ref: tlmgr *--force* 3162468
-Node: tlmgr CONFIGURATION FILE FOR TLMGR163283
-Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.164296
-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.164433
-Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164515
-Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164569
-Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164649
-Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164729
-Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164877
-Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164953
-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).165222
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION166308
-Node: tlmgr Configuration of GnuPG invocation168457
-Node: tlmgr USER MODE169095
-Node: tlmgr User mode install171941
-Node: tlmgr User mode backup, restore, remove, update173085
-Node: tlmgr User mode generate, option, paper173527
-Node: tlmgr MULTIPLE REPOSITORIES173903
-Node: tlmgr Pinning175632
-Node: tlmgr GUI FOR TLMGR177607
-Node: tlmgr Main display178947
-Node: tlmgr Display configuration area179199
-Ref: tlmgr Status179560
-Ref: tlmgr Category179724
-Ref: tlmgr Match179910
-Ref: tlmgr Selection180091
-Ref: tlmgr Display configuration buttons180295
-Node: tlmgr Package list area180478
-Ref: tlmgr a checkbox181062
-Ref: tlmgr package name181198
-Ref: tlmgr local revision (and version)181297
-Ref: tlmgr remote revision (and version)181672
-Ref: tlmgr short description181969
-Node: tlmgr Main display action buttons182014
-Ref: tlmgr Update all installed182280
-Ref: tlmgr Update182652
-Ref: tlmgr Install182702
-Ref: tlmgr Remove182888
-Ref: tlmgr Backup183066
-Node: tlmgr Menu bar183223
-Ref: tlmgr tlmgr menu183446
-Ref: tlmgr Options menu183754
-Ref: tlmgr Actions menu184837
-Ref: tlmgr Help menu185265
-Node: tlmgr GUI options185398
-Ref: tlmgr -background _color_185644
-Ref: tlmgr -font " _fontname_ _fontsize_ "185709
-Ref: tlmgr -foreground _color_185867
-Ref: tlmgr -geometry _geomspec_185919
-Ref: tlmgr -xrm _xresource_186111
-Node: tlmgr MACHINE-READABLE OUTPUT186379
-Node: tlmgr Machine-readable update and install output187189
-Ref: tlmgr location-url _location_188465
-Ref: tlmgr total-bytes _count_188681
-Ref: tlmgr _pkgname_189091
-Ref: tlmgr _status_189301
-Ref: tlmgr d189379
-Ref: tlmgr f189439
-Ref: tlmgr u189618
-Ref: tlmgr r189664
-Ref: tlmgr a189787
-Ref: tlmgr i189965
-Ref: tlmgr I190084
-Ref: tlmgr _localrev_190186
-Ref: tlmgr _serverrev_190293
-Ref: tlmgr _size_190405
-Ref: tlmgr _runtime_190574
-Ref: tlmgr _esttot_190644
-Node: tlmgr Machine-readable option output190677
-Node: tlmgr AUTHORS AND COPYRIGHT191189
-Node: Index191588
+Node: Building8606
+Node: Build iteration9992
+Node: Build problems11033
+Node: Build in parallel11487
+Node: Build distribution12091
+Node: Build one package12739
+Node: Build one engine16418
+Node: Cross compilation17467
+Node: Cross configuring18747
+Node: Cross problems20424
+Node: Installing22086
+Node: Installation directories23106
+Node: Linked scripts24924
+Node: Distro builds26415
+Node: Layout and infrastructure28791
+Node: Build system tools29622
+Node: Top-level directories31839
+Node: Autoconf macros34075
+Node: General setup macros34837
+Node: Macros for programs35712
+Node: Macros for compilers36513
+Node: Macros for libraries37921
+Node: Macros for library and header flags38347
+Node: Macros for Windows40258
+Node: Library modules41845
+Node: png library42334
+Node: zlib library44682
+Node: freetype library45197
+Node: kpathsea library45893
+Node: Program modules47272
+Node: t1utils package47700
+Node: xindy package48245
+Node: xdvik package49359
+Node: asymptote50418
+Node: Extending TeX Live50914
+Node: Adding a new program module51697
+Node: Adding a new generic library module55036
+Node: Adding a new TeX-specific library module57265
+Node: Configure options57963
+Node: Global configure options59344
+Node: --disable-native-texlive-build59886
+Node: --prefix --bindir ...60848
+Node: --disable-largefile61388
+Node: --disable-missing62089
+Node: --enable-compiler-warnings=LEVEL62490
+Node: --enable-cxx-runtime-hack63146
+Node: --enable-maintainer-mode63566
+Node: --enable-multiplatform64095
+Node: --enable-shared64668
+Node: --enable-silent-rules65039
+Node: --without-ln-s65491
+Node: --without-x65838
+Node: Program-specific configure options66026
+Node: --enable-PROG --disable-PROG66669
+Node: --disable-all-pkgs66942
+Node: Configure options for texk/web2c67725
+Node: Configure options for texk/bibtex-x70263
+Node: Configure options for texk/dvipdfm-x70806
+Node: Configure options for texk/dvisvgm71582
+Node: Configure options for texk/texlive72463
+Node: Configure options for texk/xdvik72884
+Node: Configure options for utils/xindy73505
+Node: Library-specific configure options74395
+Node: Configure options for kpathsea75397
+Node: Configure options for system poppler76146
+Node: Variables for configure76910
+Node: Coding conventions78336
+Node: Declarations and definitions79051
+Node: Const81225
+Node: Continuous integration83089
+Node: Transfer from Subversion to Github83753
+Node: Automatic update of the Git mirror85915
+Node: CI testing on Travis-CI86497
+Node: Releases on Github87206
+Node: install-tl87646
+Node: install-tl NAME88015
+Node: install-tl SYNOPSIS88173
+Node: install-tl DESCRIPTION88431
+Node: install-tl REFERENCES89498
+Node: install-tl OPTIONS90024
+Ref: install-tl *-gui* [[=]_module_]90365
+Ref: install-tl text90575
+Ref: install-tl wizard90698
+Ref: install-tl perltk90852
+Ref: install-tl *-no-gui*91283
+Ref: install-tl *-lang* _llcode_91364
+Ref: install-tl *-repository* _url|path_92051
+Ref: install-tl *-select-repository*93931
+Ref: install-tl *-all-options*94367
+Ref: install-tl *-custom-bin* _path_94622
+Ref: install-tl *-debug-translation*95454
+Ref: install-tl *-force-platform* _platform_95673
+Ref: install-tl *-help*, *--help*, *-?*95917
+Ref: install-tl *-in-place*96324
+Ref: install-tl *-init-from-profile* _profile_file_96869
+Ref: install-tl *-logfile* _file_97089
+Ref: install-tl *-no-cls*97440
+Ref: install-tl *-non-admin*97574
+Ref: install-tl *-persistent-downloads*97679
+Ref: install-tl *-no-persistent-downloads*97707
+Ref: install-tl *-no-verify-downloads*98325
+Ref: install-tl *-portable*98686
+Ref: install-tl *-print-platform*98825
+Ref: install-tl *-profile* _profile_file_99023
+Ref: install-tl *-q*99203
+Ref: install-tl *-scheme* _scheme_99265
+Ref: install-tl *-v*99739
+Ref: install-tl *-version*, *--version*99894
+Node: install-tl PROFILES100025
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102675
+Ref: install-tl instopt_adjustrepo (default 1)102751
+Ref: install-tl instopt_letter (default 0)102888
+Ref: install-tl instopt_portable (default 0)102979
+Ref: install-tl instopt_write18_restricted (default 1)103075
+Node: install-tl ENVIRONMENT VARIABLES104394
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104785
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104987
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105097
+Ref: install-tl TEXLIVE_INSTALL_PREFIX105218
+Ref: install-tl TEXLIVE_INSTALL_TEXDIR105244
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105275
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105303
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105332
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105362
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105396
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105427
+Ref: install-tl NOPERLDOC105798
+Node: install-tl AUTHORS AND COPYRIGHT105862
+Node: tlmgr106278
+Node: tlmgr NAME106731
+Node: tlmgr SYNOPSIS106863
+Node: tlmgr DESCRIPTION107053
+Node: tlmgr EXAMPLES108149
+Ref: tlmgr tlmgr option repository ctan108400
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108472
+Ref: tlmgr tlmgr update --list108924
+Ref: tlmgr tlmgr update --all109017
+Ref: tlmgr tlmgr info _what_109174
+Node: tlmgr OPTIONS109436
+Ref: tlmgr *--repository* _url|path_109956
+Ref: tlmgr *--gui* [_action_]110681
+Ref: tlmgr *--gui-lang* _llcode_111088
+Ref: tlmgr *--debug-translation*111771
+Ref: tlmgr *--machine-readable*111974
+Ref: tlmgr *--no-execute-actions*112242
+Ref: tlmgr *--package-logfile* _file_112435
+Ref: tlmgr *--pause*112689
+Ref: tlmgr *--persistent-downloads*112844
+Ref: tlmgr *--no-persistent-downloads*112872
+Ref: tlmgr *--pin-file*113366
+Ref: tlmgr *--usermode*113584
+Ref: tlmgr *--usertree* _dir_113704
+Ref: tlmgr *--verify-repo=[none|main|all]*113830
+Node: tlmgr ACTIONS114729
+Node: tlmgr help115581
+Node: tlmgr version116057
+Node: tlmgr backup116320
+Ref: tlmgr *backup [_option_...] --all*116491
+Ref: tlmgr *backup [_option_...] _pkg_...*116524
+Ref: tlmgr *--backupdir* _directory_117379
+Ref: tlmgr *--all*117596
+Ref: tlmgr *--clean*[=_N_]117848
+Ref: tlmgr *--dry-run*118175
+Node: tlmgr candidates _pkg_118305
+Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118651
+Ref: tlmgr *files*119024
+Ref: tlmgr *depends*119159
+Ref: tlmgr *executes*119501
+Ref: tlmgr *runfiles*119619
+Ref: tlmgr *--use-svn*119740
+Node: tlmgr conf119857
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*120136
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*120200
+Node: tlmgr dump-tlpdb [_option_...] [--json]122545
+Ref: tlmgr *--local*122978
+Ref: tlmgr *--remote*123017
+Ref: tlmgr *--json*123055
+Node: tlmgr generate123626
+Ref: tlmgr *generate [_option_...] language*123822
+Ref: tlmgr *generate [_option_...] language.dat*123861
+Ref: tlmgr *generate [_option_...] language.def*123900
+Ref: tlmgr *generate [_option_...] language.dat.lua*123943
+Ref: tlmgr *--dest* _output_file_126269
+Ref: tlmgr *--localcfg* _local_conf_file_126845
+Ref: tlmgr *--rebuild-sys*126968
+Node: tlmgr gui127783
+Node: tlmgr info127961
+Ref: tlmgr *info [_option_...] _pkg_...*128123
+Ref: tlmgr *info [_option_...] collections*128157
+Ref: tlmgr *info [_option_...] schemes*128187
+Ref: tlmgr *--list*129717
+Ref: tlmgr *--only-installed*130031
+Ref: tlmgr *--data item1,item2,...*130230
+Ref: tlmgr *--json* 1130811
+Node: tlmgr init-usertree131194
+Node: tlmgr install [_option_...] _pkg_...131575
+Ref: tlmgr *--dry-run* 1132085
+Ref: tlmgr *--file*132202
+Ref: tlmgr *--force*132424
+Ref: tlmgr *--no-depends*132644
+Ref: tlmgr *--no-depends-at-all*132803
+Ref: tlmgr *--reinstall*133203
+Ref: tlmgr *--with-doc*133581
+Ref: tlmgr *--with-src*133594
+Node: tlmgr key134116
+Ref: tlmgr *key list*134274
+Ref: tlmgr *key add _file_*134292
+Ref: tlmgr *key remove _keyid_*134314
+Node: tlmgr list134909
+Node: tlmgr option135071
+Ref: tlmgr *option [--json] [show]*135226
+Ref: tlmgr *option [--json] showall*135252
+Ref: tlmgr *option _key_ [_value_]*135278
+Node: tlmgr paper139675
+Ref: tlmgr *paper [a4|letter]*139824
+Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139898
+Ref: tlmgr *paper --json*139913
+Node: tlmgr path141128
+Ref: tlmgr *path [--w32mode=user|admin] add*141289
+Ref: tlmgr *path [--w32mode=user|admin] remove*141326
+Node: tlmgr pinning142666
+Ref: tlmgr pinning show142907
+Ref: tlmgr pinning add _repo_ _pkgglob_...142980
+Ref: tlmgr pinning remove _repo_ _pkgglob_...143099
+Ref: tlmgr pinning remove _repo_ --all143252
+Node: tlmgr platform143306
+Ref: tlmgr *platform list|add|remove _platform_...*143492
+Ref: tlmgr *platform set _platform_*143519
+Ref: tlmgr *platform set auto*143540
+Ref: tlmgr *--dry-run* 2144426
+Node: tlmgr postaction144545
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144775
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144849
+Ref: tlmgr *--w32mode=[user|admin]*145164
+Ref: tlmgr *--fileassocmode=[1|2]*145580
+Ref: tlmgr *--all* 1145865
+Node: tlmgr print-platform145920
+Node: tlmgr print-platform-info146251
+Node: tlmgr remove [_option_...] _pkg_...146551
+Ref: tlmgr *--all* 2147035
+Ref: tlmgr *--backup*147145
+Ref: tlmgr *--backupdir* _directory_ 1147171
+Ref: tlmgr *--no-depends* 1147576
+Ref: tlmgr *--no-depends-at-all* 1147638
+Ref: tlmgr *--force* 1147741
+Ref: tlmgr *--dry-run* 3148214
+Node: tlmgr repository148321
+Ref: tlmgr *repository list*148509
+Ref: tlmgr *repository list _path|tag_*148539
+Ref: tlmgr *repository add _path_ [_tag_]*148572
+Ref: tlmgr *repository remove _path|tag_*148604
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148658
+Node: tlmgr restore149711
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149890
+Ref: tlmgr *restore [_option_...] --all*149920
+Ref: tlmgr *--all* 3150620
+Ref: tlmgr *--backupdir* _directory_ 2150834
+Ref: tlmgr *--dry-run* 4151015
+Ref: tlmgr *--force* 2151147
+Ref: tlmgr *--json* 2151193
+Node: tlmgr search151520
+Ref: tlmgr *search [_option_...] _what_*151684
+Ref: tlmgr *search [_option_...] --file _what_*151721
+Ref: tlmgr *search [_option_...] --all _what_*151757
+Ref: tlmgr *--file* 1151977
+Ref: tlmgr *--all* 4152039
+Ref: tlmgr *--global*152128
+Ref: tlmgr *--word*152255
+Node: tlmgr shell152570
+Ref: tlmgr protocol153305
+Ref: tlmgr help 1153369
+Ref: tlmgr version 1153422
+Ref: tlmgr quit, end, bye, byebye, EOF153490
+Ref: tlmgr restart153511
+Ref: tlmgr load [local|remote]153634
+Ref: tlmgr save153704
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153827
+Node: tlmgr show154428
+Node: tlmgr uninstall154595
+Node: tlmgr update [_option_...] [_pkg_...]154825
+Ref: tlmgr *--all* 5155196
+Ref: tlmgr *--self*156937
+Ref: tlmgr *--dry-run* 5157701
+Ref: tlmgr *--list* [_pkg_]157878
+Ref: tlmgr *--exclude* _pkg_158567
+Ref: tlmgr *--no-auto-remove* [_pkg_...]159367
+Ref: tlmgr *--no-auto-install* [_pkg_...]159818
+Ref: tlmgr *--reinstall-forcibly-removed*160474
+Ref: tlmgr *--backup* 1161009
+Ref: tlmgr *--backupdir* _directory_ 3161035
+Ref: tlmgr *--no-depends* 2162201
+Ref: tlmgr *--no-depends-at-all* 2162404
+Ref: tlmgr *--force* 3162507
+Node: tlmgr CONFIGURATION FILE FOR TLMGR163322
+Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.164335
+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.164472
+Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164554
+Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164608
+Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164688
+Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164768
+Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164916
+Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164992
+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).165261
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION166347
+Node: tlmgr Configuration of GnuPG invocation168496
+Node: tlmgr USER MODE169134
+Node: tlmgr User mode install171980
+Node: tlmgr User mode backup, restore, remove, update173124
+Node: tlmgr User mode generate, option, paper173566
+Node: tlmgr MULTIPLE REPOSITORIES173942
+Node: tlmgr Pinning175671
+Node: tlmgr GUI FOR TLMGR177646
+Node: tlmgr Main display178986
+Node: tlmgr Display configuration area179238
+Ref: tlmgr Status179599
+Ref: tlmgr Category179763
+Ref: tlmgr Match179949
+Ref: tlmgr Selection180130
+Ref: tlmgr Display configuration buttons180334
+Node: tlmgr Package list area180517
+Ref: tlmgr a checkbox181101
+Ref: tlmgr package name181237
+Ref: tlmgr local revision (and version)181336
+Ref: tlmgr remote revision (and version)181711
+Ref: tlmgr short description182008
+Node: tlmgr Main display action buttons182053
+Ref: tlmgr Update all installed182319
+Ref: tlmgr Update182691
+Ref: tlmgr Install182741
+Ref: tlmgr Remove182927
+Ref: tlmgr Backup183105
+Node: tlmgr Menu bar183262
+Ref: tlmgr tlmgr menu183485
+Ref: tlmgr Options menu183793
+Ref: tlmgr Actions menu184876
+Ref: tlmgr Help menu185304
+Node: tlmgr GUI options185437
+Ref: tlmgr -background _color_185683
+Ref: tlmgr -font " _fontname_ _fontsize_ "185748
+Ref: tlmgr -foreground _color_185906
+Ref: tlmgr -geometry _geomspec_185958
+Ref: tlmgr -xrm _xresource_186150
+Node: tlmgr MACHINE-READABLE OUTPUT186418
+Node: tlmgr Machine-readable update and install output187228
+Ref: tlmgr location-url _location_188504
+Ref: tlmgr total-bytes _count_188720
+Ref: tlmgr _pkgname_189130
+Ref: tlmgr _status_189340
+Ref: tlmgr d189418
+Ref: tlmgr f189478
+Ref: tlmgr u189657
+Ref: tlmgr r189703
+Ref: tlmgr a189826
+Ref: tlmgr i190004
+Ref: tlmgr I190123
+Ref: tlmgr _localrev_190225
+Ref: tlmgr _serverrev_190332
+Ref: tlmgr _size_190444
+Ref: tlmgr _runtime_190613
+Ref: tlmgr _esttot_190683
+Node: tlmgr Machine-readable option output190716
+Node: tlmgr AUTHORS AND COPYRIGHT191228
+Node: Index191627

End Tag Table
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 010d0f6b1ff..3ea08d701b6 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -234,11 +234,11 @@ Automake/Autoconf output in general) work with any reasonable
@cindex C++11, required
A C++11 compiler is similarly required because of the third-party
libraries ICU and Poppler; the program @code{dvisvgm} also requires
-C++11. It is possible to build everything else with older compilers;
-@url{https://tug.org/texlive/custom-bin.html} links to a build script
-for doing this.
+C++11. It is possible to build everything else with older compilers,
+but you have to remove the C++11-dependent sources. @xref{Build one
+package}.
-However, a few programs in the tree have additional requirements:
+A few programs in the tree have additional requirements:
@table @file
@item web2c
@@ -248,7 +248,7 @@ requires @code{perl} for some tests run by @code{make check}.
@item xdvik
@itemx xpdfopen
@cindex X11 development, required by X clients
-require X11 headers and libraries, often in ``development'' packages
+require X11 headers and libraries, typically in ``development'' packages
that are not installed by default.
@item xetex
@@ -264,7 +264,7 @@ frameworks.
@cindex @code{libsigsegv}, required by @code{xindy}
requires GNU @code{clisp}, @code{libsigsegv}, and @code{libiconv};
additionally, to build the rules and/or documentation: @code{perl},
-@code{latex}, and @code{pdflatex}
+@code{latex}, @code{pdflatex}.
@end table
@@ -440,17 +440,9 @@ However, the @file{Makefile}s still contain all build rules and
dependencies and can be invoked to build an individual program or
library, first building any required libraries.
-This ``build-on-demand'' procedure is used, e.g., in the upstream
-Lua@TeX{} repository to build Lua@TeX{}, from a subset of the complete
-@TL{} source tree. As another example, when building the original
-e-@TeX{} has been disabled (as it is by default), one can run
-@code{make etex} (or @code{make etex.exe}) in @file{texk/web2c/} to
-build e-@TeX{} (although there is no comparably simple way to
-@emph{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
-finish for working on @code{dvipdfm-x}.
+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.)
@example
mkdir mydir && cd mydir # new working directory
@@ -492,7 +484,6 @@ tweak as desired; check the output from @code{configure --help}. It
is also a good idea to run @code{make check} after making any changes,
to ensure that whatever tests have been written still pass.
-
@cindex size of source tree
Finally, the above retrieves the entire TL source tree (several
hundred megabytes). It is natural to ask if this is really necessary.
@@ -506,12 +497,23 @@ in the @code{pdftex} development source (details at
@url{http://pdftex.org}), which is indeed such a cut-down TL source
tree.
+@cindex C++11, removing dependent sources
+Some libraries and programs require C++11. If you want to build with
+an older compiler lacking such support, you need to (re)move those
+source directories; specifying @code{--disable} for them does not
+suffice, unfortunately. Specifically, before running @code{configure}:
+
+@example
+rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm
+@end example
+
@vindex --enable-missing @r{to ignore dependencies}
-Even with @code{--disable-all-pkgs}, dependencies will be checked.
-For instance, if a (non-MacOSX) system does not have
-@code{fontconfig}, Xe@TeX{} cannot be built (@pxref{Prerequisites})
-and @code{configure} will terminate. To proceed without such
-dependencies, specify @code{--enable-missing} also.
+Also, even with @code{--disable-all-pkgs}, dependencies are (currently)
+checked. For instance, if a (non-MacOSX) system does not have
+@code{fontconfig}, Xe@TeX{} cannot be built (@pxref{Prerequisites}),
+and @code{configure} will terminate even with @code{--disable-xetex}.
+To proceed without such dependencies, specify @code{--enable-missing}
+also. (Patches to improve this would be most welcome.)
@vindex CC=@var{c-compiler}
@vindex CXX=@var{c++-compiler}
@@ -546,8 +548,9 @@ make luatex # specify target
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 (as
-the separate pdf@TeX{} and Lua@TeX{} source repositories do).
+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).
We hope to improve the situation in the future. Patches are welcome.
@@ -974,7 +977,6 @@ bugs). For this to be reflected by their timestamps in your checkout,
be sure to set @file{use-commit-times=yes} in
@file{~/.subversion/config} or the equivalent.
-
@cindex touching files to avoid rerunning
@pindex make -t
If timestamps are wrong, you may also be able to avoid unnecessary
@@ -983,7 +985,7 @@ runs of @code{bison}, @code{flex}, or @code{makeinfo} with
files. With @code{--enable-maintainer-mode} it may also be necessary
to @code{touch} first @file{aclocal.m4}, then @file{configure} and
@file{config.h.in} (or @file{c-auto.in}), and finally all
-@file{Makefile.in} files. Perhaps @code{make -t} will help.
+@file{Makefile.in} files.
@node Top-level directories
@@ -2031,7 +2033,7 @@ enabled. This is useful when one wants to work on only a single
program, which is specified with an additional @code{--enable} option,
e.g., @code{--enable-dvipdfm-x}. It's still simplest to check out and
configure the whole source tree, but at least only the program you are
-interested in, and its dependencies, are built. @xref{Build one package}.
+interested in, and its dependencies, are built. @xref{Build one package}.
Without this option, all modules are built except those that are
explicitly disabled or specify @code{disable} in their
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-02 14:41:34 +0000