diff options
author | Karl Berry <karl@freefriends.org> | 2022-01-11 22:47:10 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-01-11 22:47:10 +0000 |
commit | 4902f0bb638a2a0b2c74cb856c0d0985561f38c8 (patch) | |
tree | a3005d1694f9e8d004e3a5c55abf32cbd7234780 /Build/source/doc | |
parent | a348646a50088b57d1f9d21d7270d8fa3344b769 (diff) |
make tangle-sh, ctangleboot-sh, and make report what they do
git-svn-id: svn://tug.org/texlive/trunk@61575 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/doc')
-rw-r--r-- | Build/source/doc/ChangeLog | 5 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.info | 810 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.texi | 18 |
3 files changed, 427 insertions, 406 deletions
diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog index 4653778dcd9..3432f8878c8 100644 --- a/Build/source/doc/ChangeLog +++ b/Build/source/doc/ChangeLog @@ -1,3 +1,8 @@ +2022-01-11 Karl Berry <karl@freefriends.org> + + * tlbuild.texi (Prerequisites): mention use of GNU make $@ feature + wrt tangle-sh[.in], etc. + 2021-07-06 Karl Berry <karl@tug.org> * tlbuild.texi (Build one package, Build one engine): more diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info index ea002518bf2..77414ff945f 100644 --- a/Build/source/doc/tlbuild.info +++ b/Build/source/doc/tlbuild.info @@ -3,7 +3,7 @@ tlbuild.texi. This file documents the TeX Live build system and more. -Copyright (C) 2016-2021 Karl Berry. +Copyright (C) 2016-2022 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this @@ -59,7 +59,7 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated September 2021) corresponds to the TeX Live 2021 +This manual (dated January 2022) corresponds to the TeX Live 2021 release. This manual is aimed at system installers and programmers, and @@ -160,12 +160,12 @@ File: tlbuild.info, Node: Prerequisites, Next: Building, Prev: Overview of bu Overall, building the TeX Live programs, when using all libraries from the TL source tree, requires C and C++11 compilers and GNU 'make'. If -'make' from your 'PATH' is not GNU make, you can set the 'MAKE' +'make' from your 'PATH' is not GNU 'make,' you can set the 'MAKE' environment variable to whatever is necessary. GNU 'make' is required only because of some third-party libraries, -notably FreeType; all the TL-maintained directories (and -Automake/Autoconf output in general) work with any reasonable 'make'. +notably FreeType; Automake/Autoconf output in general, and the +TL-maintained directories, work with any reasonable 'make'.(1) A C++11 compiler is similarly required because of the third-party library ICU; the program 'dvisvgm' also requires C++11. It is possible @@ -216,6 +216,14 @@ 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. + ---------- Footnotes ---------- + + (1) There is one exception in TL: the 'tangle-sh' and related rules +use '$@' to mean the target name, a feature not present in all 'make's. +This could be alleviated by some laborious editing, but since there's no +way to avoid GNU 'make' for the entire tree, it does not seem worth the +trouble. + File: tlbuild.info, Node: Building, Next: Installing, Prev: Prerequisites, Up: Top @@ -5389,6 +5397,7 @@ Index * Menu: +* $@ target in normal make rules: Prerequisites. (line 11) * --bindir configure option: --prefix --bindir .... (line 6) * --bindir configure option <1>: --enable-multiplatform. @@ -5959,401 +5968,402 @@ Index Tag Table: Node: Top1208 Node: Introduction2118 -Node: Overview of build system3947 -Node: Prerequisites5998 -Node: Building8594 -Node: Build iteration9980 -Node: Build problems11021 -Node: Build in parallel11475 -Node: Build distribution12079 -Node: Build one package12727 -Node: Build one engine16501 -Node: Cross compilation18184 -Node: Cross configuring19464 -Node: Cross problems21141 -Node: Installing22803 -Node: Installation directories23823 -Node: Linked scripts25641 -Node: Distro builds27132 -Node: Layout and infrastructure29508 -Node: Build system tools30339 -Node: Top-level directories32556 -Node: Autoconf macros34792 -Node: General setup macros35554 -Node: Macros for programs36429 -Node: Macros for compilers37230 -Node: Macros for libraries38638 -Node: Macros for library and header flags39064 -Node: Macros for Windows40975 -Node: Library modules42562 -Node: png library43051 -Node: zlib library45399 -Node: freetype library45914 -Node: kpathsea library46610 -Node: Program modules47989 -Node: t1utils package48417 -Node: xindy package48962 -Node: xdvik package50078 -Node: asymptote51137 -Node: Extending TeX Live51633 -Node: Adding a new program module52440 -Node: Adding a new engine57203 -Node: Adding a new generic library module58988 -Node: Adding a new TeX-specific library module61209 -Node: Configure options61907 -Node: Global configure options63288 -Node: --disable-native-texlive-build63830 -Node: --prefix --bindir ...64792 -Node: --disable-largefile65332 -Node: --disable-missing65874 -Node: --enable-compiler-warnings=LEVEL66275 -Node: --enable-cxx-runtime-hack66931 -Node: --enable-maintainer-mode67351 -Node: --enable-multiplatform67880 -Node: --enable-shared68453 -Node: --enable-silent-rules68824 -Node: --without-ln-s69276 -Node: --without-x69623 -Node: Program-specific configure options69811 -Node: --enable-PROG --disable-PROG70454 -Node: --disable-all-pkgs70727 -Node: Configure options for texk/web2c71510 -Node: Configure options for texk/bibtex-x74048 -Node: Configure options for texk/dvipdfm-x74591 -Node: Configure options for texk/dvisvgm75367 -Node: Configure options for texk/texlive76248 -Node: Configure options for texk/xdvik76669 -Node: Configure options for utils/xindy77290 -Node: Library-specific configure options78180 -Node: Configure options for kpathsea79141 -Node: Variables for configure79845 -Node: Coding conventions81271 -Node: Declarations and definitions81986 -Node: Const84160 -Node: Continuous integration86024 -Node: Transfer from Subversion to Github86688 -Node: Automatic update of the Git mirror88850 -Node: CI testing on Travis-CI89432 -Node: Releases on Github90141 -Node: install-tl90581 -Node: install-tl NAME90950 -Node: install-tl SYNOPSIS91108 -Node: install-tl DESCRIPTION91366 -Node: install-tl REFERENCES92426 -Node: install-tl OPTIONS92950 -Ref: install-tl *-gui* [[=]_module_]93291 -Ref: install-tl text93499 -Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)93684 -Ref: install-tl *-no-gui*94316 -Ref: install-tl *-lang* _llcode_94406 -Ref: install-tl *-repository* _url|path_95030 -Ref: install-tl *-select-repository*95919 -Ref: install-tl *-all-options*96337 -Ref: install-tl *-custom-bin* _path_96592 -Ref: install-tl *-debug-translation*97426 -Ref: install-tl *-force-platform* _platform_97702 -Ref: install-tl *-help*, *--help*, *-?*97946 -Ref: install-tl *-in-place*98359 -Ref: install-tl *-init-from-profile* _profile_file_98904 -Ref: install-tl *-logfile* _file_99173 -Ref: install-tl *-no-cls*99524 -Ref: install-tl *-no-persistent-downloads*99672 -Ref: install-tl *-persistent-downloads*99697 -Ref: install-tl *-no-verify-downloads*100315 -Ref: install-tl *-non-admin*100678 -Ref: install-tl *-portable*100771 -Ref: install-tl *-print-platform*100910 -Ref: install-tl *-profile* _profile_file_101108 -Ref: install-tl *-q*101329 -Ref: install-tl *-scheme* _scheme_101391 -Ref: install-tl *-v*101865 -Ref: install-tl *-version*, *--version*102020 -Node: install-tl PROFILES102154 -Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)105020 -Ref: install-tl instopt_adjustrepo (default 1)105096 -Ref: install-tl instopt_letter (default 0)105233 -Ref: install-tl instopt_portable (default 0)105324 -Ref: install-tl instopt_write18_restricted (default 1)105420 -Node: install-tl ENVIRONMENT VARIABLES106759 -Ref: install-tl TEXLIVE_DOWNLOADER107137 -Ref: install-tl TL_DOWNLOAD_PROGRAM107160 -Ref: install-tl TL_DOWNLOAD_ARGS107180 -Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK107384 -Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE107586 -Ref: install-tl TEXLIVE_INSTALL_NO_RESUME107695 -Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME107847 -Ref: install-tl TEXLIVE_INSTALL_PAPER107968 -Ref: install-tl TEXLIVE_INSTALL_PREFIX108114 -Ref: install-tl TEXLIVE_INSTALL_TEXDIR108140 -Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG108171 -Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR108199 -Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME108228 -Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL108258 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG108292 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR108323 -Ref: install-tl NOPERLDOC108694 -Node: install-tl AUTHORS AND COPYRIGHT108758 -Node: tlmgr109171 -Node: tlmgr NAME109656 -Node: tlmgr SYNOPSIS109788 -Node: tlmgr DESCRIPTION109978 -Node: tlmgr EXAMPLES111077 -Ref: tlmgr tlmgr option repository ctan111328 -Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet111401 -Ref: tlmgr tlmgr update --list112006 -Ref: tlmgr tlmgr update --all112099 -Ref: tlmgr tlmgr info _what_112256 -Node: tlmgr OPTIONS112518 -Ref: tlmgr *--repository* _url|path_113038 -Ref: tlmgr /some/local/dir114224 -Ref: tlmgr file:/some/local/dir114253 -Ref: tlmgr ctan114326 -Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet114380 -Ref: tlmgr http://server/path/to/tlnet114721 -Ref: tlmgr https://server/path/to/tlnet115102 -Ref: tlmgr ftp://server/path/to/tlnet115570 -Ref: tlmgr user@machine:/path/to/tlnet115702 -Ref: tlmgr scp://user@machine/path/to/tlnet115743 -Ref: tlmgr ssh://user@machine/path/to/tlnet115784 -Ref: tlmgr *--gui* [_action_]116177 -Ref: tlmgr *--gui-lang* _llcode_116990 -Ref: tlmgr *--command-logfile* _file_117731 -Ref: tlmgr *--debug-translation*117997 -Ref: tlmgr *--machine-readable*118200 -Ref: tlmgr *--no-execute-actions*118468 -Ref: tlmgr *--package-logfile* _file_118661 -Ref: tlmgr *--pause*118915 -Ref: tlmgr *--persistent-downloads*119070 -Ref: tlmgr *--no-persistent-downloads*119098 -Ref: tlmgr *--pin-file*119592 -Ref: tlmgr *--usermode*119810 -Ref: tlmgr *--usertree* _dir_119930 -Ref: tlmgr *--verify-repo=[none|main|all]*120056 -Node: tlmgr ACTIONS120955 -Node: tlmgr help121816 -Node: tlmgr version122293 -Node: tlmgr backup122556 -Ref: tlmgr *backup [_option_...] --all*122727 -Ref: tlmgr *backup [_option_...] _pkg_...*122760 -Ref: tlmgr *--backupdir* _directory_123826 -Ref: tlmgr *--all*124043 -Ref: tlmgr *--clean*[=_N_]124295 -Ref: tlmgr *--dry-run*124622 -Node: tlmgr candidates _pkg_124752 -Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]125107 -Ref: tlmgr *depends*125621 -Ref: tlmgr *executes*125963 -Ref: tlmgr *files*126078 -Ref: tlmgr *runfiles*126214 -Ref: tlmgr *texmfdbs*126351 -Ref: tlmgr - all items in TEXMFDBS have the !! prefix.126581 -Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).126657 -Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.126722 -Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.126797 -Ref: tlmgr *--use-svn*126822 -Node: tlmgr conf126963 -Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*127251 -Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*127315 -Node: tlmgr dump-tlpdb [_option_...] [--json]129730 -Ref: tlmgr *--local*130163 -Ref: tlmgr *--remote*130202 -Ref: tlmgr *--json*130240 -Node: tlmgr generate130811 -Ref: tlmgr *generate [_option_...] language*131007 -Ref: tlmgr *generate [_option_...] language.dat*131046 -Ref: tlmgr *generate [_option_...] language.def*131085 -Ref: tlmgr *generate [_option_...] language.dat.lua*131128 -Ref: tlmgr *--dest* _output_file_133455 -Ref: tlmgr *--localcfg* _local_conf_file_134031 -Ref: tlmgr *--rebuild-sys*134154 -Node: tlmgr gui134969 -Node: tlmgr info135147 -Ref: tlmgr *info [_option_...] _pkg_...*135309 -Ref: tlmgr *info [_option_...] collections*135343 -Ref: tlmgr *info [_option_...] schemes*135373 -Ref: tlmgr *--list*136903 -Ref: tlmgr *--only-installed*137217 -Ref: tlmgr *--only-remote*137405 -Ref: tlmgr *--data item1,item2,...*137709 -Ref: tlmgr *--json* 1139072 -Node: tlmgr init-usertree139455 -Node: tlmgr install [_option_...] _pkg_...139836 -Ref: tlmgr *--dry-run* 1140344 -Ref: tlmgr *--file*140461 -Ref: tlmgr *--force*140683 -Ref: tlmgr *--no-depends*140903 -Ref: tlmgr *--no-depends-at-all*141062 -Ref: tlmgr *--reinstall*141462 -Ref: tlmgr *--with-doc*141840 -Ref: tlmgr *--with-src*141853 -Node: tlmgr key142581 -Ref: tlmgr *key list*142739 -Ref: tlmgr *key add _file_*142757 -Ref: tlmgr *key remove _keyid_*142779 -Node: tlmgr list143373 -Node: tlmgr option143535 -Ref: tlmgr *option [--json] [show]*143690 -Ref: tlmgr *option [--json] showall|help*143721 -Ref: tlmgr *option _key_ [_value_]*143747 -Node: tlmgr paper148326 -Ref: tlmgr *paper [a4|letter]*148475 -Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>148551 -Ref: tlmgr *paper --json*148566 -Node: tlmgr path149781 -Ref: tlmgr *path [--w32mode=user|admin] add*149942 -Ref: tlmgr *path [--w32mode=user|admin] remove*149979 -Node: tlmgr pinning151464 -Ref: tlmgr pinning show151705 -Ref: tlmgr pinning add _repo_ _pkgglob_...151778 -Ref: tlmgr pinning remove _repo_ _pkgglob_...151897 -Ref: tlmgr pinning remove _repo_ --all152050 -Node: tlmgr platform152104 -Ref: tlmgr *platform list|add|remove _platform_...*152290 -Ref: tlmgr *platform set _platform_*152317 -Ref: tlmgr *platform set auto*152338 -Ref: tlmgr *--dry-run* 2153215 -Node: tlmgr postaction153334 -Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*153564 -Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*153638 -Ref: tlmgr *--w32mode=[user|admin]*153953 -Ref: tlmgr *--fileassocmode=[1|2]*154369 -Ref: tlmgr *--all* 1154654 -Node: tlmgr print-platform154709 -Node: tlmgr print-platform-info155040 -Node: tlmgr remove [_option_...] _pkg_...155340 -Ref: tlmgr *--all* 2155824 -Ref: tlmgr *--backup*155934 -Ref: tlmgr *--backupdir* _directory_ 1155960 -Ref: tlmgr *--no-depends* 1156365 -Ref: tlmgr *--no-depends-at-all* 1156427 -Ref: tlmgr *--force* 1156530 -Ref: tlmgr *--dry-run* 3157003 -Node: tlmgr repository157339 -Ref: tlmgr *repository list*157527 -Ref: tlmgr *repository list _path|url|tag_*157561 -Ref: tlmgr *repository add _path_ [_tag_]*157594 -Ref: tlmgr *repository remove _path|tag_*157626 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*157680 -Ref: tlmgr *repository status*157701 -Ref: tlmgr The tag (which can be the same as the url);158928 -Node: tlmgr restore159406 -Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*159585 -Ref: tlmgr *restore [_option_...] --all*159615 -Ref: tlmgr *--all* 3160315 -Ref: tlmgr *--backupdir* _directory_ 2160529 -Ref: tlmgr *--dry-run* 4160710 -Ref: tlmgr *--force* 2160842 -Ref: tlmgr *--json* 2160888 -Node: tlmgr search161215 -Ref: tlmgr *search [_option_...] _what_*161379 -Ref: tlmgr *search [_option_...] --file _what_*161416 -Ref: tlmgr *search [_option_...] --all _what_*161452 -Ref: tlmgr *--file* 1161672 -Ref: tlmgr *--all* 4161734 -Ref: tlmgr *--global*161823 -Ref: tlmgr *--word*161950 -Node: tlmgr shell162265 -Ref: tlmgr protocol163000 -Ref: tlmgr help 1163064 -Ref: tlmgr version 1163117 -Ref: tlmgr quit, end, bye, byebye, EOF163185 -Ref: tlmgr restart163206 -Ref: tlmgr load [local|remote]163329 -Ref: tlmgr save163399 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]163522 -Node: tlmgr show164123 -Node: tlmgr uninstall164290 -Node: tlmgr update [_option_...] [_pkg_...]164520 -Ref: tlmgr *--all* 5164891 -Ref: tlmgr *--self*167070 -Ref: tlmgr *--dry-run* 5167834 -Ref: tlmgr *--list* [_pkg_]168011 -Ref: tlmgr *--exclude* _pkg_168700 -Ref: tlmgr *--no-auto-remove* [_pkg_...]169500 -Ref: tlmgr *--no-auto-install* [_pkg_...]169984 -Ref: tlmgr *--reinstall-forcibly-removed*170746 -Ref: tlmgr *--backup* 1171281 -Ref: tlmgr *--backupdir* _directory_ 3171307 -Ref: tlmgr *--no-depends* 2172473 -Ref: tlmgr *--no-depends-at-all* 2172676 -Ref: tlmgr *--force* 3172779 -Node: tlmgr CONFIGURATION FILE FOR TLMGR173770 -Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.174777 -Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.174914 -Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.174996 -Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).175050 -Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.175130 -Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.175210 -Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.175300 -Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.175448 -Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.175524 -Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).175793 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION176881 -Node: tlmgr Configuration of GnuPG invocation179054 -Node: tlmgr USER MODE179692 -Node: tlmgr User mode install182538 -Node: tlmgr User mode backup, restore, remove, update183682 -Node: tlmgr User mode generate, option, paper184124 -Node: tlmgr MULTIPLE REPOSITORIES184500 -Node: tlmgr Pinning186229 -Node: tlmgr GUI FOR TLMGR188152 -Node: tlmgr Main display189801 -Node: tlmgr Display configuration area190053 -Ref: tlmgr Status190414 -Ref: tlmgr Category190578 -Ref: tlmgr Match190764 -Ref: tlmgr Selection190945 -Ref: tlmgr Display configuration buttons191149 -Node: tlmgr Package list area191332 -Ref: tlmgr a checkbox191916 -Ref: tlmgr package name192052 -Ref: tlmgr local revision (and version)192151 -Ref: tlmgr remote revision (and version)192526 -Ref: tlmgr short description192823 -Node: tlmgr Main display action buttons192868 -Ref: tlmgr Update all installed193134 -Ref: tlmgr Update193506 -Ref: tlmgr Install193556 -Ref: tlmgr Remove193742 -Ref: tlmgr Backup193920 -Node: tlmgr Menu bar194077 -Ref: tlmgr tlmgr menu194300 -Ref: tlmgr Options menu194608 -Ref: tlmgr Actions menu195691 -Ref: tlmgr Help menu196119 -Node: tlmgr GUI options196253 -Ref: tlmgr -background _color_196499 -Ref: tlmgr -font " _fontname_ _fontsize_ "196564 -Ref: tlmgr -foreground _color_196722 -Ref: tlmgr -geometry _geomspec_196774 -Ref: tlmgr -xrm _xresource_196966 -Node: tlmgr MACHINE-READABLE OUTPUT197235 -Node: tlmgr Machine-readable update and install output198045 -Ref: tlmgr location-url _location_199321 -Ref: tlmgr total-bytes _count_199537 -Ref: tlmgr _pkgname_199947 -Ref: tlmgr _status_200157 -Ref: tlmgr d200235 -Ref: tlmgr f200295 -Ref: tlmgr u200474 -Ref: tlmgr r200520 -Ref: tlmgr a200643 -Ref: tlmgr i200821 -Ref: tlmgr I200940 -Ref: tlmgr _localrev_201042 -Ref: tlmgr _serverrev_201149 -Ref: tlmgr _size_201261 -Ref: tlmgr _runtime_201430 -Ref: tlmgr _esttot_201500 -Node: tlmgr Machine-readable option output201533 -Node: tlmgr ENVIRONMENT VARIABLES202045 -Ref: tlmgr TEXLIVE_COMPRESSOR202556 -Ref: tlmgr TEXLIVE_DOWNLOADER203404 -Ref: tlmgr TL_DOWNLOAD_PROGRAM203427 -Ref: tlmgr TL_DOWNLOAD_ARGS203447 -Ref: tlmgr TEXLIVE_PREFER_OWN204473 -Node: tlmgr AUTHORS AND COPYRIGHT205297 -Node: Index205695 +Node: Overview of build system3945 +Node: Prerequisites5996 +Ref: Prerequisites-Footnote-18629 +Node: Building8927 +Node: Build iteration10313 +Node: Build problems11354 +Node: Build in parallel11808 +Node: Build distribution12412 +Node: Build one package13060 +Node: Build one engine16834 +Node: Cross compilation18517 +Node: Cross configuring19797 +Node: Cross problems21474 +Node: Installing23136 +Node: Installation directories24156 +Node: Linked scripts25974 +Node: Distro builds27465 +Node: Layout and infrastructure29841 +Node: Build system tools30672 +Node: Top-level directories32889 +Node: Autoconf macros35125 +Node: General setup macros35887 +Node: Macros for programs36762 +Node: Macros for compilers37563 +Node: Macros for libraries38971 +Node: Macros for library and header flags39397 +Node: Macros for Windows41308 +Node: Library modules42895 +Node: png library43384 +Node: zlib library45732 +Node: freetype library46247 +Node: kpathsea library46943 +Node: Program modules48322 +Node: t1utils package48750 +Node: xindy package49295 +Node: xdvik package50411 +Node: asymptote51470 +Node: Extending TeX Live51966 +Node: Adding a new program module52773 +Node: Adding a new engine57536 +Node: Adding a new generic library module59321 +Node: Adding a new TeX-specific library module61542 +Node: Configure options62240 +Node: Global configure options63621 +Node: --disable-native-texlive-build64163 +Node: --prefix --bindir ...65125 +Node: --disable-largefile65665 +Node: --disable-missing66207 +Node: --enable-compiler-warnings=LEVEL66608 +Node: --enable-cxx-runtime-hack67264 +Node: --enable-maintainer-mode67684 +Node: --enable-multiplatform68213 +Node: --enable-shared68786 +Node: --enable-silent-rules69157 +Node: --without-ln-s69609 +Node: --without-x69956 +Node: Program-specific configure options70144 +Node: --enable-PROG --disable-PROG70787 +Node: --disable-all-pkgs71060 +Node: Configure options for texk/web2c71843 +Node: Configure options for texk/bibtex-x74381 +Node: Configure options for texk/dvipdfm-x74924 +Node: Configure options for texk/dvisvgm75700 +Node: Configure options for texk/texlive76581 +Node: Configure options for texk/xdvik77002 +Node: Configure options for utils/xindy77623 +Node: Library-specific configure options78513 +Node: Configure options for kpathsea79474 +Node: Variables for configure80178 +Node: Coding conventions81604 +Node: Declarations and definitions82319 +Node: Const84493 +Node: Continuous integration86357 +Node: Transfer from Subversion to Github87021 +Node: Automatic update of the Git mirror89183 +Node: CI testing on Travis-CI89765 +Node: Releases on Github90474 +Node: install-tl90914 +Node: install-tl NAME91283 +Node: install-tl SYNOPSIS91441 +Node: install-tl DESCRIPTION91699 +Node: install-tl REFERENCES92759 +Node: install-tl OPTIONS93283 +Ref: install-tl *-gui* [[=]_module_]93624 +Ref: install-tl text93832 +Ref: install-tl tcl (or "perltk" or "wizard" or "expert" or nothing)94017 +Ref: install-tl *-no-gui*94649 +Ref: install-tl *-lang* _llcode_94739 +Ref: install-tl *-repository* _url|path_95363 +Ref: install-tl *-select-repository*96252 +Ref: install-tl *-all-options*96670 +Ref: install-tl *-custom-bin* _path_96925 +Ref: install-tl *-debug-translation*97759 +Ref: install-tl *-force-platform* _platform_98035 +Ref: install-tl *-help*, *--help*, *-?*98279 +Ref: install-tl *-in-place*98692 +Ref: install-tl *-init-from-profile* _profile_file_99237 +Ref: install-tl *-logfile* _file_99506 +Ref: install-tl *-no-cls*99857 +Ref: install-tl *-no-persistent-downloads*100005 +Ref: install-tl *-persistent-downloads*100030 +Ref: install-tl *-no-verify-downloads*100648 +Ref: install-tl *-non-admin*101011 +Ref: install-tl *-portable*101104 +Ref: install-tl *-print-platform*101243 +Ref: install-tl *-profile* _profile_file_101441 +Ref: install-tl *-q*101662 +Ref: install-tl *-scheme* _scheme_101724 +Ref: install-tl *-v*102198 +Ref: install-tl *-version*, *--version*102353 +Node: install-tl PROFILES102487 +Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)105353 +Ref: install-tl instopt_adjustrepo (default 1)105429 +Ref: install-tl instopt_letter (default 0)105566 +Ref: install-tl instopt_portable (default 0)105657 +Ref: install-tl instopt_write18_restricted (default 1)105753 +Node: install-tl ENVIRONMENT VARIABLES107092 +Ref: install-tl TEXLIVE_DOWNLOADER107470 +Ref: install-tl TL_DOWNLOAD_PROGRAM107493 +Ref: install-tl TL_DOWNLOAD_ARGS107513 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK107717 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE107919 +Ref: install-tl TEXLIVE_INSTALL_NO_RESUME108028 +Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME108180 +Ref: install-tl TEXLIVE_INSTALL_PAPER108301 +Ref: install-tl TEXLIVE_INSTALL_PREFIX108447 +Ref: install-tl TEXLIVE_INSTALL_TEXDIR108473 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG108504 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR108532 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME108561 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL108591 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG108625 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR108656 +Ref: install-tl NOPERLDOC109027 +Node: install-tl AUTHORS AND COPYRIGHT109091 +Node: tlmgr109504 +Node: tlmgr NAME109989 +Node: tlmgr SYNOPSIS110121 +Node: tlmgr DESCRIPTION110311 +Node: tlmgr EXAMPLES111410 +Ref: tlmgr tlmgr option repository ctan111661 +Ref: tlmgr tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet111734 +Ref: tlmgr tlmgr update --list112339 +Ref: tlmgr tlmgr update --all112432 +Ref: tlmgr tlmgr info _what_112589 +Node: tlmgr OPTIONS112851 +Ref: tlmgr *--repository* _url|path_113371 +Ref: tlmgr /some/local/dir114557 +Ref: tlmgr file:/some/local/dir114586 +Ref: tlmgr ctan114659 +Ref: tlmgr https://mirror.ctan.org/systems/texlive/tlnet114713 +Ref: tlmgr http://server/path/to/tlnet115054 +Ref: tlmgr https://server/path/to/tlnet115435 +Ref: tlmgr ftp://server/path/to/tlnet115903 +Ref: tlmgr user@machine:/path/to/tlnet116035 +Ref: tlmgr scp://user@machine/path/to/tlnet116076 +Ref: tlmgr ssh://user@machine/path/to/tlnet116117 +Ref: tlmgr *--gui* [_action_]116510 +Ref: tlmgr *--gui-lang* _llcode_117323 +Ref: tlmgr *--command-logfile* _file_118064 +Ref: tlmgr *--debug-translation*118330 +Ref: tlmgr *--machine-readable*118533 +Ref: tlmgr *--no-execute-actions*118801 +Ref: tlmgr *--package-logfile* _file_118994 +Ref: tlmgr *--pause*119248 +Ref: tlmgr *--persistent-downloads*119403 +Ref: tlmgr *--no-persistent-downloads*119431 +Ref: tlmgr *--pin-file*119925 +Ref: tlmgr *--usermode*120143 +Ref: tlmgr *--usertree* _dir_120263 +Ref: tlmgr *--verify-repo=[none|main|all]*120389 +Node: tlmgr ACTIONS121288 +Node: tlmgr help122149 +Node: tlmgr version122626 +Node: tlmgr backup122889 +Ref: tlmgr *backup [_option_...] --all*123060 +Ref: tlmgr *backup [_option_...] _pkg_...*123093 +Ref: tlmgr *--backupdir* _directory_124159 +Ref: tlmgr *--all*124376 +Ref: tlmgr *--clean*[=_N_]124628 +Ref: tlmgr *--dry-run*124955 +Node: tlmgr candidates _pkg_125085 +Node: tlmgr check [_option_...] [depends|executes|files|runfiles|texmfdbs|all]125440 +Ref: tlmgr *depends*125954 +Ref: tlmgr *executes*126296 +Ref: tlmgr *files*126411 +Ref: tlmgr *runfiles*126547 +Ref: tlmgr *texmfdbs*126684 +Ref: tlmgr - all items in TEXMFDBS have the !! prefix.126914 +Ref: tlmgr - all items in TEXMFBDS have an ls-R file (if they exist at all).126990 +Ref: tlmgr - all items in TEXMF with !! are listed in TEXMFDBS.127055 +Ref: tlmgr - all items in TEXMF with an ls-R file are listed in TEXMFDBS.127130 +Ref: tlmgr *--use-svn*127155 +Node: tlmgr conf127296 +Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*127584 +Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|remove] [_value_]*127648 +Node: tlmgr dump-tlpdb [_option_...] [--json]130063 +Ref: tlmgr *--local*130496 +Ref: tlmgr *--remote*130535 +Ref: tlmgr *--json*130573 +Node: tlmgr generate131144 +Ref: tlmgr *generate [_option_...] language*131340 +Ref: tlmgr *generate [_option_...] language.dat*131379 +Ref: tlmgr *generate [_option_...] language.def*131418 +Ref: tlmgr *generate [_option_...] language.dat.lua*131461 +Ref: tlmgr *--dest* _output_file_133788 +Ref: tlmgr *--localcfg* _local_conf_file_134364 +Ref: tlmgr *--rebuild-sys*134487 +Node: tlmgr gui135302 +Node: tlmgr info135480 +Ref: tlmgr *info [_option_...] _pkg_...*135642 +Ref: tlmgr *info [_option_...] collections*135676 +Ref: tlmgr *info [_option_...] schemes*135706 +Ref: tlmgr *--list*137236 +Ref: tlmgr *--only-installed*137550 +Ref: tlmgr *--only-remote*137738 +Ref: tlmgr *--data item1,item2,...*138042 +Ref: tlmgr *--json* 1139405 +Node: tlmgr init-usertree139788 +Node: tlmgr install [_option_...] _pkg_...140169 +Ref: tlmgr *--dry-run* 1140677 +Ref: tlmgr *--file*140794 +Ref: tlmgr *--force*141016 +Ref: tlmgr *--no-depends*141236 +Ref: tlmgr *--no-depends-at-all*141395 +Ref: tlmgr *--reinstall*141795 +Ref: tlmgr *--with-doc*142173 +Ref: tlmgr *--with-src*142186 +Node: tlmgr key142914 +Ref: tlmgr *key list*143072 +Ref: tlmgr *key add _file_*143090 +Ref: tlmgr *key remove _keyid_*143112 +Node: tlmgr list143706 +Node: tlmgr option143868 +Ref: tlmgr *option [--json] [show]*144023 +Ref: tlmgr *option [--json] showall|help*144054 +Ref: tlmgr *option _key_ [_value_]*144080 +Node: tlmgr paper148659 +Ref: tlmgr *paper [a4|letter]*148808 +Ref: tlmgr *<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*>148884 +Ref: tlmgr *paper --json*148899 +Node: tlmgr path150114 +Ref: tlmgr *path [--w32mode=user|admin] add*150275 +Ref: tlmgr *path [--w32mode=user|admin] remove*150312 +Node: tlmgr pinning151797 +Ref: tlmgr pinning show152038 +Ref: tlmgr pinning add _repo_ _pkgglob_...152111 +Ref: tlmgr pinning remove _repo_ _pkgglob_...152230 +Ref: tlmgr pinning remove _repo_ --all152383 +Node: tlmgr platform152437 +Ref: tlmgr *platform list|add|remove _platform_...*152623 +Ref: tlmgr *platform set _platform_*152650 +Ref: tlmgr *platform set auto*152671 +Ref: tlmgr *--dry-run* 2153548 +Node: tlmgr postaction153667 +Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*153897 +Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*153971 +Ref: tlmgr *--w32mode=[user|admin]*154286 +Ref: tlmgr *--fileassocmode=[1|2]*154702 +Ref: tlmgr *--all* 1154987 +Node: tlmgr print-platform155042 +Node: tlmgr print-platform-info155373 +Node: tlmgr remove [_option_...] _pkg_...155673 +Ref: tlmgr *--all* 2156157 +Ref: tlmgr *--backup*156267 +Ref: tlmgr *--backupdir* _directory_ 1156293 +Ref: tlmgr *--no-depends* 1156698 +Ref: tlmgr *--no-depends-at-all* 1156760 +Ref: tlmgr *--force* 1156863 +Ref: tlmgr *--dry-run* 3157336 +Node: tlmgr repository157672 +Ref: tlmgr *repository list*157860 +Ref: tlmgr *repository list _path|url|tag_*157894 +Ref: tlmgr *repository add _path_ [_tag_]*157927 +Ref: tlmgr *repository remove _path|tag_*157959 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*158013 +Ref: tlmgr *repository status*158034 +Ref: tlmgr The tag (which can be the same as the url);159261 +Node: tlmgr restore159739 +Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*159918 +Ref: tlmgr *restore [_option_...] --all*159948 +Ref: tlmgr *--all* 3160648 +Ref: tlmgr *--backupdir* _directory_ 2160862 +Ref: tlmgr *--dry-run* 4161043 +Ref: tlmgr *--force* 2161175 +Ref: tlmgr *--json* 2161221 +Node: tlmgr search161548 +Ref: tlmgr *search [_option_...] _what_*161712 +Ref: tlmgr *search [_option_...] --file _what_*161749 +Ref: tlmgr *search [_option_...] --all _what_*161785 +Ref: tlmgr *--file* 1162005 +Ref: tlmgr *--all* 4162067 +Ref: tlmgr *--global*162156 +Ref: tlmgr *--word*162283 +Node: tlmgr shell162598 +Ref: tlmgr protocol163333 +Ref: tlmgr help 1163397 +Ref: tlmgr version 1163450 +Ref: tlmgr quit, end, bye, byebye, EOF163518 +Ref: tlmgr restart163539 +Ref: tlmgr load [local|remote]163662 +Ref: tlmgr save163732 +Ref: tlmgr get [_var_] =item set [_var_ [_val_]]163855 +Node: tlmgr show164456 +Node: tlmgr uninstall164623 +Node: tlmgr update [_option_...] [_pkg_...]164853 +Ref: tlmgr *--all* 5165224 +Ref: tlmgr *--self*167403 +Ref: tlmgr *--dry-run* 5168167 +Ref: tlmgr *--list* [_pkg_]168344 +Ref: tlmgr *--exclude* _pkg_169033 +Ref: tlmgr *--no-auto-remove* [_pkg_...]169833 +Ref: tlmgr *--no-auto-install* [_pkg_...]170317 +Ref: tlmgr *--reinstall-forcibly-removed*171079 +Ref: tlmgr *--backup* 1171614 +Ref: tlmgr *--backupdir* _directory_ 3171640 +Ref: tlmgr *--no-depends* 2172806 +Ref: tlmgr *--no-depends-at-all* 2173009 +Ref: tlmgr *--force* 3173112 +Node: tlmgr CONFIGURATION FILE FOR TLMGR174103 +Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.175110 +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.175247 +Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.175329 +Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).175383 +Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.175463 +Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.175543 +Ref: tlmgr tkfontscale, value any float. Controls the scaling of fonts in the Tk based frontends.175633 +Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.175781 +Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.175857 +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).176126 +Node: tlmgr CRYPTOGRAPHIC VERIFICATION177214 +Node: tlmgr Configuration of GnuPG invocation179387 +Node: tlmgr USER MODE180025 +Node: tlmgr User mode install182871 +Node: tlmgr User mode backup, restore, remove, update184015 +Node: tlmgr User mode generate, option, paper184457 +Node: tlmgr MULTIPLE REPOSITORIES184833 +Node: tlmgr Pinning186562 +Node: tlmgr GUI FOR TLMGR188485 +Node: tlmgr Main display190134 +Node: tlmgr Display configuration area190386 +Ref: tlmgr Status190747 +Ref: tlmgr Category190911 +Ref: tlmgr Match191097 +Ref: tlmgr Selection191278 +Ref: tlmgr Display configuration buttons191482 +Node: tlmgr Package list area191665 +Ref: tlmgr a checkbox192249 +Ref: tlmgr package name192385 +Ref: tlmgr local revision (and version)192484 +Ref: tlmgr remote revision (and version)192859 +Ref: tlmgr short description193156 +Node: tlmgr Main display action buttons193201 +Ref: tlmgr Update all installed193467 +Ref: tlmgr Update193839 +Ref: tlmgr Install193889 +Ref: tlmgr Remove194075 +Ref: tlmgr Backup194253 +Node: tlmgr Menu bar194410 +Ref: tlmgr tlmgr menu194633 +Ref: tlmgr Options menu194941 +Ref: tlmgr Actions menu196024 +Ref: tlmgr Help menu196452 +Node: tlmgr GUI options196586 +Ref: tlmgr -background _color_196832 +Ref: tlmgr -font " _fontname_ _fontsize_ "196897 +Ref: tlmgr -foreground _color_197055 +Ref: tlmgr -geometry _geomspec_197107 +Ref: tlmgr -xrm _xresource_197299 +Node: tlmgr MACHINE-READABLE OUTPUT197568 +Node: tlmgr Machine-readable update and install output198378 +Ref: tlmgr location-url _location_199654 +Ref: tlmgr total-bytes _count_199870 +Ref: tlmgr _pkgname_200280 +Ref: tlmgr _status_200490 +Ref: tlmgr d200568 +Ref: tlmgr f200628 +Ref: tlmgr u200807 +Ref: tlmgr r200853 +Ref: tlmgr a200976 +Ref: tlmgr i201154 +Ref: tlmgr I201273 +Ref: tlmgr _localrev_201375 +Ref: tlmgr _serverrev_201482 +Ref: tlmgr _size_201594 +Ref: tlmgr _runtime_201763 +Ref: tlmgr _esttot_201833 +Node: tlmgr Machine-readable option output201866 +Node: tlmgr ENVIRONMENT VARIABLES202378 +Ref: tlmgr TEXLIVE_COMPRESSOR202889 +Ref: tlmgr TEXLIVE_DOWNLOADER203737 +Ref: tlmgr TL_DOWNLOAD_PROGRAM203760 +Ref: tlmgr TL_DOWNLOAD_ARGS203780 +Ref: tlmgr TEXLIVE_PREFER_OWN204806 +Node: tlmgr AUTHORS AND COPYRIGHT205630 +Node: Index206028 End Tag Table diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi index 5afbd68b925..aa623d3dd01 100644 --- a/Build/source/doc/tlbuild.texi +++ b/Build/source/doc/tlbuild.texi @@ -2,7 +2,7 @@ @setfilename tlbuild.info @set version 2021 -@set month-year September 2021 +@set month-year January 2022 @set mytitle Building @TeX{} Live (@value{version}) @settitle @value{mytitle} @@ -15,7 +15,7 @@ This file documents the @TL{} build system and more. @noindent -Copyright @copyright{} 2016--2021 Karl Berry.@* +Copyright @copyright{} 2016--2022 Karl Berry.@* Copyright @copyright{} 2013--2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this @@ -220,16 +220,22 @@ efforts, neither task is easy.) @cindex compilers, C and C++11 Overall, building the @TL{} programs, when using all libraries from the TL source tree, requires C and C++11 compilers and GNU -@code{make}. If @code{make} from your @code{PATH} is not GNU make, +@code{make}. If @code{make} from your @code{PATH} is not GNU @code{make,} you can set the @code{MAKE} environment variable to whatever is necessary. @cindex GNU @code{make}, required @cindex @code{gmake}, required @cindex FreeType +@cindex @code{$@@} target in normal @code{make} rules GNU @code{make} is required only because of some third-party -libraries, notably FreeType; all the TL-maintained directories (and -Automake/Autoconf output in general) work with any reasonable -@code{make}. +libraries, notably FreeType; Automake/Autoconf output in general, and +the TL-maintained directories, work with any reasonable +@code{make}.@footnote{There is one exception in TL: the +@code{tangle-sh} and related rules use @code{$@@} to mean the target +name, a feature not present in all @code{make}s. This could be +alleviated by some laborious editing, but since there's no way to +avoid GNU @code{make} for the entire tree, it does not seem worth the +trouble.} @cindex C++11, required A C++11 compiler is similarly required because of the third-party |