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