diff options
Diffstat (limited to 'Build')
-rw-r--r-- | Build/source/README.2building | 12 | ||||
-rw-r--r-- | Build/source/README.4layout | 18 | ||||
-rw-r--r-- | Build/source/README.5configure | 3 | ||||
-rw-r--r-- | Build/source/doc/build-tools.txt | 4 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.info | 655 | ||||
-rw-r--r-- | Build/source/doc/tlbuild.texi | 51 |
6 files changed, 371 insertions, 372 deletions
diff --git a/Build/source/README.2building b/Build/source/README.2building index a5600e0dcc7..05ecfadb6b0 100644 --- a/Build/source/README.2building +++ b/Build/source/README.2building @@ -45,10 +45,10 @@ done unless some source files have been modified. 4.2 Build problems ================== -If configuring or building a module fails, you could either (a) find and -fix the problem, or (b) remove the subdirectory for that module from the -build tree, and rerun the top-level 'make' (or 'Build' with '--no-clean' -as its first argument). +If configuring or building a module fails, you should first find and fix +the problem, then perhaps remove the subdirectory for that module from +the build tree, and finally rerun the top-level 'make' (or 'Build' with +'--no-clean' as its first argument). 4.3 Build in parallel ===================== @@ -93,7 +93,7 @@ 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 'dvipdfmx'. +finish for working on 'dvipdfm-x'. mkdir mydir && cd mydir # new working directory @@ -112,7 +112,7 @@ finish for working on 'dvipdfmx'. make >&outm # Test: - cd texk/dvipdfmx + cd texk/dvipdfm-x make check Then you modify source files in 'mydir/texk/dvipdfm-x' and rerun diff --git a/Build/source/README.4layout b/Build/source/README.4layout index ef1a805fbfa..9fb8774dbd3 100644 --- a/Build/source/README.4layout +++ b/Build/source/README.4layout @@ -29,9 +29,9 @@ many extra hassles, so don't do that, tempting as it may be. autoconf (GNU Autoconf) 2.69 automake (GNU automake) 1.15 - bison (GNU Bison) 3.0.3 + bison (GNU Bison) 3.0.4 flex 2.5.39 - ltmain.sh (GNU libtool) 2.4.5 + ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.17 makeinfo (GNU texinfo) 5.2 @@ -278,8 +278,8 @@ structure and variation. ---------------------------------------- This generic library uses the source tree in, e.g., the subdirectory -'libpng-1.5.17' with all modifications for TL recorded in -'libpng-1.5.17-PATCHES/*'. The 'configure.ac' fragment +'libpng-1.6.16' with all modifications for TL recorded in +'libpng-1.6.16-PATCHES/*'. The 'configure.ac' fragment 'ac/withenable.ac' contains KPSE_WITH_LIB([libpng], [zlib]) @@ -377,8 +377,8 @@ for a few of the programs in TL. 6.5.1 The 't1utils' package in 'utils/t1utils' ---------------------------------------------- -Once again we use the distributed source tree 't1utils-1.38' with -modifications documented in 't1utils-1.38-PATCHES/*' and a proxy build +Once again we use the distributed source tree 't1utils-1.39' with +modifications documented in 't1utils-1.39-PATCHES/*' and a proxy build system consisting of 'configure.ac' and 'Makefile.am'. The fragment 'ac/withenable.ac' contains @@ -390,10 +390,10 @@ configure option '--disable-t1utils'. 6.5.2 The 'xindy' package in 'utils/xindy' ------------------------------------------ -This module uses the distributed source tree 'xindy-2.4' with -modifications documented in 'xindy-2.4-PATCHES/*', a proxy +This module uses the distributed source tree 'xindy-2.5.1' with +modifications documented in 'xindy-2.5.1-PATCHES/*', a proxy 'configure.ac', and a wrapper 'Makefile.am' that descends into -'xindy-2.4'. The 'xindy' build requires that the distributed +'xindy-2.5.1'. The 'xindy' build requires that the distributed 'Makefile's allow a 'VPATH' build, can handle all targets, and do not refer to '${top_srcdir}' or '${top_builddir}'. The fragment 'ac/withenable.ac' contains diff --git a/Build/source/README.5configure b/Build/source/README.5configure index d6c6503f3df..00a1309ee9e 100644 --- a/Build/source/README.5configure +++ b/Build/source/README.5configure @@ -261,8 +261,7 @@ created by default. In addition, 'dvipdfm' is created as a symlink to Do not build the 'dvipdfmx' program or create the 'dvipdfm' symlink. '--disable-xdvipdfmx' -Do not build the 'xdvipdfmx' program (building 'xdvipdfmx' requires the -'freetype' library). +Do not build the 'xdvipdfmx' program. 7.2.6 Configure options for 'texk/dvisvgm' ------------------------------------------ diff --git a/Build/source/doc/build-tools.txt b/Build/source/doc/build-tools.txt index 320335728ec..7b15903153e 100644 --- a/Build/source/doc/build-tools.txt +++ b/Build/source/doc/build-tools.txt @@ -1,7 +1,7 @@ autoconf (GNU Autoconf) 2.69 automake (GNU automake) 1.15 -bison (GNU Bison) 3.0.3 +bison (GNU Bison) 3.0.4 flex 2.5.39 -ltmain.sh (GNU libtool) 2.4.5 +ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.17 makeinfo (GNU texinfo) 5.2 diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info index ddb94f94dc6..5355561f1ad 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) 2013, 2014 Karl Berry & Peter Breitenlohner. + Copyright (C) 2013, 2014, 2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -26,7 +26,7 @@ END-INFO-DIR-ENTRY File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir) -Building TeX Live (2014) +Building TeX Live (2015) ************************ For an overview of this manual, *note Introduction::. @@ -52,7 +52,7 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated May 2014) corresponds to the TeX Live 2014 release. +This manual (dated May 2015) corresponds to the TeX Live 2015 release. This manual is aimed at system installers and programmers, and focuses on how to configure, build, and develop the TeX Live (TL) @@ -250,10 +250,10 @@ File: tlbuild.info, Node: Build problems, Next: Build in parallel, Prev: Buil 4.2 Build problems ================== -If configuring or building a module fails, you could either (a) find and -fix the problem, or (b) remove the subdirectory for that module from the -build tree, and rerun the top-level 'make' (or 'Build' with '--no-clean' -as its first argument). +If configuring or building a module fails, you should first find and fix +the problem, then perhaps remove the subdirectory for that module from +the build tree, and finally rerun the top-level 'make' (or 'Build' with +'--no-clean' as its first argument). File: tlbuild.info, Node: Build in parallel, Next: Build distribution, Prev: Build problems, Up: Building @@ -307,7 +307,7 @@ 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 'dvipdfmx'. +finish for working on 'dvipdfm-x'. mkdir mydir && cd mydir # new working directory @@ -326,7 +326,7 @@ finish for working on 'dvipdfmx'. make >&outm # Test: - cd texk/dvipdfmx + cd texk/dvipdfm-x make check Then you modify source files in 'mydir/texk/dvipdfm-x' and rerun @@ -556,9 +556,9 @@ many extra hassles, so don't do that, tempting as it may be. autoconf (GNU Autoconf) 2.69 automake (GNU automake) 1.15 - bison (GNU Bison) 3.0.3 + bison (GNU Bison) 3.0.4 flex 2.5.39 - ltmain.sh (GNU libtool) 2.4.5 + ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.17 makeinfo (GNU texinfo) 5.2 @@ -851,8 +851,8 @@ File: tlbuild.info, Node: 'png' library, Next: 'zlib' library, Up: Library mo ---------------------------------------- This generic library uses the source tree in, e.g., the subdirectory -'libpng-1.5.17' with all modifications for TL recorded in -'libpng-1.5.17-PATCHES/*'. The 'configure.ac' fragment +'libpng-1.6.16' with all modifications for TL recorded in +'libpng-1.6.16-PATCHES/*'. The 'configure.ac' fragment 'ac/withenable.ac' contains KPSE_WITH_LIB([libpng], [zlib]) @@ -972,8 +972,8 @@ File: tlbuild.info, Node: 't1utils' package, Next: 'xindy' package, Up: Progr 6.5.1 The 't1utils' package in 'utils/t1utils' ---------------------------------------------- -Once again we use the distributed source tree 't1utils-1.38' with -modifications documented in 't1utils-1.38-PATCHES/*' and a proxy build +Once again we use the distributed source tree 't1utils-1.39' with +modifications documented in 't1utils-1.39-PATCHES/*' and a proxy build system consisting of 'configure.ac' and 'Makefile.am'. The fragment 'ac/withenable.ac' contains @@ -988,10 +988,10 @@ File: tlbuild.info, Node: 'xindy' package, Next: 'xdvik' package, Prev: 't1ut 6.5.2 The 'xindy' package in 'utils/xindy' ------------------------------------------ -This module uses the distributed source tree 'xindy-2.4' with -modifications documented in 'xindy-2.4-PATCHES/*', a proxy +This module uses the distributed source tree 'xindy-2.5.1' with +modifications documented in 'xindy-2.5.1-PATCHES/*', a proxy 'configure.ac', and a wrapper 'Makefile.am' that descends into -'xindy-2.4'. The 'xindy' build requires that the distributed +'xindy-2.5.1'. The 'xindy' build requires that the distributed 'Makefile's allow a 'VPATH' build, can handle all targets, and do not refer to '${top_srcdir}' or '${top_builddir}'. The fragment 'ac/withenable.ac' contains @@ -1504,8 +1504,7 @@ created by default. In addition, 'dvipdfm' is created as a symlink to Do not build the 'dvipdfmx' program or create the 'dvipdfm' symlink. '--disable-xdvipdfmx' -Do not build the 'xdvipdfmx' program (building 'xdvipdfmx' requires the -'freetype' library). +Do not build the 'xdvipdfmx' program. File: tlbuild.info, Node: Configure options for 'texk/dvisvgm', Next: Configure options for 'texk/texlive', Prev: Configure options for 'texk/dvipdfm-x', Up: Program-specific configure options @@ -4883,313 +4882,313 @@ Index Tag Table: -Node: Top993 -Node: Introduction1911 -Node: Overview of build system3384 -Node: Prerequisites5448 -Node: Building7510 -Node: Build iteration8729 -Node: Build problems9801 -Node: Build in parallel10194 -Node: Build distribution10786 -Node: Build one package11357 -Node: Installing14131 -Node: Installation directories15146 -Node: Linked scripts16966 -Node: Distro builds18447 -Node: Layout and infrastructure20837 -Node: Build system tools21626 -Node: Top-level directories23636 -Node: Autoconf macros25691 -Node: General setup macros26392 -Node: Macros for programs27259 -Node: Macros for compilers28071 -Node: Macros for libraries29505 -Node: Macros for library and header flags29931 -Node: Macros for Windows31803 -Node: Library modules33380 -Node: 'png' library33877 -Node: 'zlib' library36170 -Node: 'freetype' library36691 -Node: 'kpathsea' library37225 -Node: Program modules38650 -Node: 't1utils' package39086 -Node: 'xindy' package39653 -Node: 'xdvik' package40832 -Node: 'asymptote'41911 -Node: Extending TeX Live42366 -Node: Adding a new program module42734 -Node: Adding a new generic library module44253 -Node: Adding a new TeX-specific library module46466 -Node: Configure options47153 -Node: Global configure options48544 -Node: '--disable-native-texlive-build'49112 -Node: '--prefix' '--bindir' ...50108 -Node: '--disable-largefile'50656 -Node: '--disable-missing'51349 -Node: '--enable-compiler-warnings='LEVEL51756 -Node: '--enable-cxx-runtime-hack'52501 -Node: '--enable-maintainer-mode'52934 -Node: '--enable-multiplatform'53469 -Node: '--enable-shared'54013 -Node: '--enable-silent-rules'54390 -Node: '--without-ln-s'54852 -Node: '--without-x'55209 -Node: Program-specific configure options55401 -Node: '--enable-PROG' '--disable-PROG'56064 -Node: '--disable-all-pkgs'56347 -Node: Configure options for 'texk/web2c'57341 -Node: Configure options for 'texk/bibtex-x'59799 -Node: Configure options for 'texk/dvipdfm-x'60355 -Node: Configure options for 'texk/dvisvgm'61194 -Node: Configure options for 'texk/texlive'62086 -Node: Configure options for 'texk/xdvik'62513 -Node: Configure options for 'utils/xindy'63123 -Node: Library-specific configure options64028 -Node: Configure options for 'kpathsea'65043 -Node: Configure options for system 'poppler'65756 -Node: Variables for configure66553 -Node: Cross compilation67981 -Node: Cross configuring69280 -Node: Cross problems70953 -Node: Coding conventions72814 -Node: Declarations and definitions73483 -Node: Const75665 -Node: install-tl77528 -Node: install-tl NAME77869 -Node: install-tl SYNOPSIS78027 -Node: install-tl DESCRIPTION78235 -Node: install-tl REFERENCES79236 -Node: install-tl OPTIONS79752 -Ref: install-tl *-gui* [[=]_module_]80106 -Ref: install-tl 'text'80315 -Ref: install-tl 'wizard'80438 -Ref: install-tl 'perltk'80592 -Ref: install-tl *-no-gui*81026 -Ref: install-tl *-lang* _llcode_81107 -Ref: install-tl *-repository* _url|path_81794 -Ref: install-tl *-select-repository*83605 -Ref: install-tl *-all-options*84041 -Ref: install-tl *-custom-bin* _path_84348 -Ref: install-tl *-debug-translation*85003 -Ref: install-tl *-force-platform* _platform_85222 -Ref: install-tl *-help*, *--help*, *-?*85466 -Ref: install-tl *-in-place*85859 -Ref: install-tl *-logfile* _file_86386 -Ref: install-tl *-no-cls*86737 -Ref: install-tl *-non-admin*86868 -Ref: install-tl *--persistent-downloads*86973 -Ref: install-tl *--no-persistent-downloads*87001 -Ref: install-tl *-portable*87609 -Ref: install-tl *-print-platform*87748 -Ref: install-tl *-profile* _profile_87941 -Ref: install-tl *-q*89435 -Ref: install-tl *-scheme* _scheme_89497 -Ref: install-tl *-v*89971 -Ref: install-tl *-version*, *--version*90132 -Node: install-tl ENVIRONMENT VARIABLES90263 -Ref: install-tl 'TEXLIVE_INSTALL_ENV_NOCHECK'90652 -Ref: install-tl 'TEXLIVE_INSTALL_NO_CONTEXT_CACHE'90854 -Ref: install-tl 'TEXLIVE_INSTALL_PREFIX'90960 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFCONFIG'90991 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFHOME'91020 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFLOCAL'91050 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSCONFIG'91084 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSVAR'91115 -Ref: install-tl 'TEXLIVE_INSTALL_TEXMFVAR'91143 -Ref: install-tl 'NOPERLDOC'91198 -Node: install-tl AUTHORS AND COPYRIGHT91262 -Node: tlmgr91620 -Node: tlmgr NAME92057 -Node: tlmgr SYNOPSIS92182 -Node: tlmgr DESCRIPTION92372 -Node: tlmgr EXAMPLES93468 -Ref: tlmgr 'tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet'93759 -Ref: tlmgr 'tlmgr update --list'93940 -Ref: tlmgr 'tlmgr update --all'94033 -Ref: tlmgr 'tlmgr info' _pkg_94189 -Node: tlmgr OPTIONS94395 -Ref: tlmgr *--repository* _url|path_94915 -Ref: tlmgr *--gui* [_action_]95640 -Ref: tlmgr *--gui-lang* _llcode_96047 -Ref: tlmgr *--debug-translation*96730 -Ref: tlmgr *--machine-readable*96933 -Ref: tlmgr *--no-execute-actions*97201 -Ref: tlmgr *--package-logfile* _file_97394 -Ref: tlmgr *--pause*97649 -Ref: tlmgr *--persistent-downloads*97804 -Ref: tlmgr *--no-persistent-downloads*97832 -Ref: tlmgr *--pin-file*98326 -Ref: tlmgr *--usermode*98544 -Ref: tlmgr *--usertree* _dir_98664 -Node: tlmgr ACTIONS99214 -Node: tlmgr help100446 -Node: tlmgr version100922 -Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...101240 -Ref: tlmgr *--backupdir* _directory_102334 -Ref: tlmgr *--all*102531 -Ref: tlmgr *--clean*[=_N_]102753 -Ref: tlmgr *--dry-run*103050 -Node: tlmgr candidates _pkg_103170 -Ref: tlmgr *candidates _pkg_* 1103457 -Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]103601 -Ref: tlmgr *files*104044 -Ref: tlmgr *depends*104179 -Ref: tlmgr *executes*104521 -Ref: tlmgr *runfiles*104639 -Ref: tlmgr *--use-svn*104751 -Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]104868 -Node: tlmgr dump-tlpdb [--local|--remote]106940 -Ref: tlmgr *--local*107450 -Ref: tlmgr *--remote*107489 -Node: tlmgr generate [_option_]... _what_107911 -Ref: tlmgr *generate language*108152 -Ref: tlmgr *generate language.dat*108177 -Ref: tlmgr *generate language.def*108202 -Ref: tlmgr *generate language.dat.lua*108231 -Ref: tlmgr *generate fmtutil*108251 -Ref: tlmgr *--dest* _output_file_110488 -Ref: tlmgr *--localcfg* _local_conf_file_111064 -Ref: tlmgr *--rebuild-sys*111187 -Node: tlmgr gui112048 -Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]112292 -Ref: tlmgr *--list*113497 -Ref: tlmgr *--only-installed*113776 -Ref: tlmgr *--taxonomy*113991 -Ref: tlmgr *--keyword*114003 -Ref: tlmgr *--functionality*114021 -Ref: tlmgr *--characterization*114042 -Node: tlmgr init-usertree114255 -Node: tlmgr install [_option_]... _pkg_...114681 -Ref: tlmgr *--file*115045 -Ref: tlmgr *--reinstall*115271 -Ref: tlmgr *--no-depends*115651 -Ref: tlmgr *--no-depends-at-all*115810 -Ref: tlmgr *--dry-run* 1116208 -Ref: tlmgr *--force*116326 -Node: tlmgr option116532 -Ref: tlmgr *option [show]*116705 -Ref: tlmgr *option showall*116723 -Ref: tlmgr *option _key_ [_value_]*116749 -Node: tlmgr paper120597 -Ref: tlmgr *paper [a4|letter]*120782 -Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*120856 -Node: tlmgr path [--w32mode=user|admin] [add|remove]121883 -Node: tlmgr pinning123366 -Ref: tlmgr 'pinning show'123673 -Ref: tlmgr 'pinning add' _repo_ _pkgglob_...123746 -Ref: tlmgr 'pinning remove' _repo_ _pkgglob_...123865 -Ref: tlmgr 'pinning remove _repo_ --all'124018 -Node: tlmgr platform list|add|remove _platform_...124072 -Node: tlmgr platform set _platform_124320 -Node: tlmgr platform set auto124548 -Ref: tlmgr *--dry-run* 2125665 -Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...125774 -Node: tlmgr print-platform127076 -Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]127548 -Ref: tlmgr *--all* 1128444 -Ref: tlmgr *--backupdir* _directory_ 1128638 -Ref: tlmgr *--dry-run* 3128794 -Ref: tlmgr *--force* 1128911 -Node: tlmgr remove [_option_]... _pkg_...128939 -Ref: tlmgr *--no-depends* 1129462 -Ref: tlmgr *--no-depends-at-all* 1129524 -Ref: tlmgr *--force* 2129580 -Ref: tlmgr *--dry-run* 4130052 -Node: tlmgr repository130159 -Ref: tlmgr *repository list*130367 -Ref: tlmgr *repository list _path|tag_*130397 -Ref: tlmgr *repository add _path_ [_tag_]*130430 -Ref: tlmgr *repository remove _path|tag_*130462 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*130516 -Node: tlmgr search [_option_...] _what_131600 -Node: tlmgr search [_option_...] --file _what_132111 -Node: tlmgr search [_option_...] --taxonomy _what_132362 -Node: tlmgr search [_option_...] --keyword _what_132673 -Node: tlmgr search [_option_...] --functionality _what_132991 -Node: tlmgr search [_option_...] --characterization _what_133329 -Node: tlmgr search [_option_...] --all _what_133669 -Ref: tlmgr *--global*134117 -Ref: tlmgr *--word*134229 -Ref: tlmgr *--list* 1134468 -Ref: tlmgr *--file* 1134814 -Ref: tlmgr *--taxonomy* 1134871 -Ref: tlmgr *--keyword* 1134883 -Ref: tlmgr *--functionality* 1134901 -Ref: tlmgr *--characterization* 1134922 -Ref: tlmgr *--all* 2135077 -Node: tlmgr uninstall135160 -Ref: tlmgr *--force* 3135414 -Node: tlmgr update [_option_]... [_pkg_]...135470 -Ref: tlmgr *--all* 3135841 -Ref: tlmgr *--self*137582 -Ref: tlmgr *--dry-run* 5138346 -Ref: tlmgr *--list* [_pkg_]138523 -Ref: tlmgr *--exclude* _pkg_139212 -Ref: tlmgr *--no-auto-remove* [_pkg_]...139905 -Ref: tlmgr *--no-auto-install* [_pkg_]...140356 -Ref: tlmgr *--reinstall-forcibly-removed*141012 -Ref: tlmgr *--backup* and *--backupdir* _directory_141576 -Ref: tlmgr *--no-depends* 2142757 -Ref: tlmgr *--no-depends-at-all* 2142960 -Ref: tlmgr *--force* 4143016 -Node: tlmgr USER MODE143442 -Node: tlmgr user mode install146253 -Node: tlmgr user mode backup; restore; remove; update147200 -Node: tlmgr user mode generate; option; paper147642 -Node: tlmgr CONFIGURATION FILE FOR TLMGR148018 -Node: tlmgr TAXONOMIES149109 -Ref: tlmgr '--keyword' 2149735 -Ref: tlmgr '--functionality' 2149820 -Ref: tlmgr '--characterization' 2149976 -Ref: tlmgr '--taxonomy' 2150117 -Node: tlmgr MULTIPLE REPOSITORIES150658 -Node: tlmgr Pinning152379 -Node: tlmgr GUI FOR TLMGR154354 -Node: tlmgr Main display155576 -Node: tlmgr Display configuration area155828 -Ref: tlmgr Status156189 -Ref: tlmgr Category156353 -Ref: tlmgr Match156539 -Ref: tlmgr Selection156799 -Ref: tlmgr Display configuration buttons157003 -Node: tlmgr Package list area157186 -Ref: tlmgr a checkbox157770 -Ref: tlmgr package name157906 -Ref: tlmgr local revision (and version)158005 -Ref: tlmgr remote revision (and version)158380 -Ref: tlmgr short description158677 -Node: tlmgr Main display action buttons158722 -Ref: tlmgr Update all installed158988 -Ref: tlmgr Update159360 -Ref: tlmgr Install159410 -Ref: tlmgr Remove159596 -Ref: tlmgr Backup159774 -Node: tlmgr Menu bar159931 -Ref: tlmgr 'tlmgr' menu160128 -Ref: tlmgr 'Options menu'160436 -Ref: tlmgr 'Actions menu'161519 -Ref: tlmgr 'Help menu'161947 -Node: tlmgr MACHINE-READABLE OUTPUT162080 -Node: tlmgr Machine-readable 'update' and 'install' output162896 -Ref: tlmgr 'location-url' _location_164178 -Ref: tlmgr 'total-bytes' _count_164394 -Ref: tlmgr _pkgname_164804 -Ref: tlmgr _status_165014 -Ref: tlmgr 'd'165092 -Ref: tlmgr 'f'165152 -Ref: tlmgr 'u'165331 -Ref: tlmgr 'r'165377 -Ref: tlmgr 'a'165500 -Ref: tlmgr 'i'165678 -Ref: tlmgr 'I'165797 -Ref: tlmgr _localrev_165899 -Ref: tlmgr _serverrev_166006 -Ref: tlmgr _size_166118 -Ref: tlmgr _runtime_166287 -Ref: tlmgr _esttot_166357 -Node: tlmgr Machine-readable 'option' output166390 -Node: tlmgr AUTHORS AND COPYRIGHT166908 -Node: Index167255 +Node: Top999 +Node: Introduction1917 +Node: Overview of build system3390 +Node: Prerequisites5454 +Node: Building7516 +Node: Build iteration8735 +Node: Build problems9807 +Node: Build in parallel10210 +Node: Build distribution10802 +Node: Build one package11373 +Node: Installing14149 +Node: Installation directories15164 +Node: Linked scripts16984 +Node: Distro builds18465 +Node: Layout and infrastructure20855 +Node: Build system tools21644 +Node: Top-level directories23654 +Node: Autoconf macros25709 +Node: General setup macros26410 +Node: Macros for programs27277 +Node: Macros for compilers28089 +Node: Macros for libraries29523 +Node: Macros for library and header flags29949 +Node: Macros for Windows31821 +Node: Library modules33398 +Node: 'png' library33895 +Node: 'zlib' library36188 +Node: 'freetype' library36709 +Node: 'kpathsea' library37243 +Node: Program modules38668 +Node: 't1utils' package39104 +Node: 'xindy' package39671 +Node: 'xdvik' package40856 +Node: 'asymptote'41935 +Node: Extending TeX Live42390 +Node: Adding a new program module42758 +Node: Adding a new generic library module44277 +Node: Adding a new TeX-specific library module46490 +Node: Configure options47177 +Node: Global configure options48568 +Node: '--disable-native-texlive-build'49136 +Node: '--prefix' '--bindir' ...50132 +Node: '--disable-largefile'50680 +Node: '--disable-missing'51373 +Node: '--enable-compiler-warnings='LEVEL51780 +Node: '--enable-cxx-runtime-hack'52525 +Node: '--enable-maintainer-mode'52958 +Node: '--enable-multiplatform'53493 +Node: '--enable-shared'54037 +Node: '--enable-silent-rules'54414 +Node: '--without-ln-s'54876 +Node: '--without-x'55233 +Node: Program-specific configure options55425 +Node: '--enable-PROG' '--disable-PROG'56088 +Node: '--disable-all-pkgs'56371 +Node: Configure options for 'texk/web2c'57365 +Node: Configure options for 'texk/bibtex-x'59823 +Node: Configure options for 'texk/dvipdfm-x'60379 +Node: Configure options for 'texk/dvisvgm'61163 +Node: Configure options for 'texk/texlive'62055 +Node: Configure options for 'texk/xdvik'62482 +Node: Configure options for 'utils/xindy'63092 +Node: Library-specific configure options63997 +Node: Configure options for 'kpathsea'65012 +Node: Configure options for system 'poppler'65725 +Node: Variables for configure66522 +Node: Cross compilation67950 +Node: Cross configuring69249 +Node: Cross problems70922 +Node: Coding conventions72783 +Node: Declarations and definitions73452 +Node: Const75634 +Node: install-tl77497 +Node: install-tl NAME77838 +Node: install-tl SYNOPSIS77996 +Node: install-tl DESCRIPTION78204 +Node: install-tl REFERENCES79205 +Node: install-tl OPTIONS79721 +Ref: install-tl *-gui* [[=]_module_]80075 +Ref: install-tl 'text'80284 +Ref: install-tl 'wizard'80407 +Ref: install-tl 'perltk'80561 +Ref: install-tl *-no-gui*80995 +Ref: install-tl *-lang* _llcode_81076 +Ref: install-tl *-repository* _url|path_81763 +Ref: install-tl *-select-repository*83574 +Ref: install-tl *-all-options*84010 +Ref: install-tl *-custom-bin* _path_84317 +Ref: install-tl *-debug-translation*84972 +Ref: install-tl *-force-platform* _platform_85191 +Ref: install-tl *-help*, *--help*, *-?*85435 +Ref: install-tl *-in-place*85828 +Ref: install-tl *-logfile* _file_86355 +Ref: install-tl *-no-cls*86706 +Ref: install-tl *-non-admin*86837 +Ref: install-tl *--persistent-downloads*86942 +Ref: install-tl *--no-persistent-downloads*86970 +Ref: install-tl *-portable*87578 +Ref: install-tl *-print-platform*87717 +Ref: install-tl *-profile* _profile_87910 +Ref: install-tl *-q*89404 +Ref: install-tl *-scheme* _scheme_89466 +Ref: install-tl *-v*89940 +Ref: install-tl *-version*, *--version*90101 +Node: install-tl ENVIRONMENT VARIABLES90232 +Ref: install-tl 'TEXLIVE_INSTALL_ENV_NOCHECK'90621 +Ref: install-tl 'TEXLIVE_INSTALL_NO_CONTEXT_CACHE'90823 +Ref: install-tl 'TEXLIVE_INSTALL_PREFIX'90929 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFCONFIG'90960 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFHOME'90989 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFLOCAL'91019 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSCONFIG'91053 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFSYSVAR'91084 +Ref: install-tl 'TEXLIVE_INSTALL_TEXMFVAR'91112 +Ref: install-tl 'NOPERLDOC'91167 +Node: install-tl AUTHORS AND COPYRIGHT91231 +Node: tlmgr91589 +Node: tlmgr NAME92026 +Node: tlmgr SYNOPSIS92151 +Node: tlmgr DESCRIPTION92341 +Node: tlmgr EXAMPLES93437 +Ref: tlmgr 'tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet'93728 +Ref: tlmgr 'tlmgr update --list'93909 +Ref: tlmgr 'tlmgr update --all'94002 +Ref: tlmgr 'tlmgr info' _pkg_94158 +Node: tlmgr OPTIONS94364 +Ref: tlmgr *--repository* _url|path_94884 +Ref: tlmgr *--gui* [_action_]95609 +Ref: tlmgr *--gui-lang* _llcode_96016 +Ref: tlmgr *--debug-translation*96699 +Ref: tlmgr *--machine-readable*96902 +Ref: tlmgr *--no-execute-actions*97170 +Ref: tlmgr *--package-logfile* _file_97363 +Ref: tlmgr *--pause*97618 +Ref: tlmgr *--persistent-downloads*97773 +Ref: tlmgr *--no-persistent-downloads*97801 +Ref: tlmgr *--pin-file*98295 +Ref: tlmgr *--usermode*98513 +Ref: tlmgr *--usertree* _dir_98633 +Node: tlmgr ACTIONS99183 +Node: tlmgr help100415 +Node: tlmgr version100891 +Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...101209 +Ref: tlmgr *--backupdir* _directory_102303 +Ref: tlmgr *--all*102500 +Ref: tlmgr *--clean*[=_N_]102722 +Ref: tlmgr *--dry-run*103019 +Node: tlmgr candidates _pkg_103139 +Ref: tlmgr *candidates _pkg_* 1103426 +Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]103570 +Ref: tlmgr *files*104013 +Ref: tlmgr *depends*104148 +Ref: tlmgr *executes*104490 +Ref: tlmgr *runfiles*104608 +Ref: tlmgr *--use-svn*104720 +Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]104837 +Node: tlmgr dump-tlpdb [--local|--remote]106909 +Ref: tlmgr *--local*107419 +Ref: tlmgr *--remote*107458 +Node: tlmgr generate [_option_]... _what_107880 +Ref: tlmgr *generate language*108121 +Ref: tlmgr *generate language.dat*108146 +Ref: tlmgr *generate language.def*108171 +Ref: tlmgr *generate language.dat.lua*108200 +Ref: tlmgr *generate fmtutil*108220 +Ref: tlmgr *--dest* _output_file_110457 +Ref: tlmgr *--localcfg* _local_conf_file_111033 +Ref: tlmgr *--rebuild-sys*111156 +Node: tlmgr gui112017 +Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]112261 +Ref: tlmgr *--list*113466 +Ref: tlmgr *--only-installed*113745 +Ref: tlmgr *--taxonomy*113960 +Ref: tlmgr *--keyword*113972 +Ref: tlmgr *--functionality*113990 +Ref: tlmgr *--characterization*114011 +Node: tlmgr init-usertree114224 +Node: tlmgr install [_option_]... _pkg_...114650 +Ref: tlmgr *--file*115014 +Ref: tlmgr *--reinstall*115240 +Ref: tlmgr *--no-depends*115620 +Ref: tlmgr *--no-depends-at-all*115779 +Ref: tlmgr *--dry-run* 1116177 +Ref: tlmgr *--force*116295 +Node: tlmgr option116501 +Ref: tlmgr *option [show]*116674 +Ref: tlmgr *option showall*116692 +Ref: tlmgr *option _key_ [_value_]*116718 +Node: tlmgr paper120566 +Ref: tlmgr *paper [a4|letter]*120751 +Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*120825 +Node: tlmgr path [--w32mode=user|admin] [add|remove]121852 +Node: tlmgr pinning123335 +Ref: tlmgr 'pinning show'123642 +Ref: tlmgr 'pinning add' _repo_ _pkgglob_...123715 +Ref: tlmgr 'pinning remove' _repo_ _pkgglob_...123834 +Ref: tlmgr 'pinning remove _repo_ --all'123987 +Node: tlmgr platform list|add|remove _platform_...124041 +Node: tlmgr platform set _platform_124289 +Node: tlmgr platform set auto124517 +Ref: tlmgr *--dry-run* 2125634 +Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...125743 +Node: tlmgr print-platform127045 +Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]127517 +Ref: tlmgr *--all* 1128413 +Ref: tlmgr *--backupdir* _directory_ 1128607 +Ref: tlmgr *--dry-run* 3128763 +Ref: tlmgr *--force* 1128880 +Node: tlmgr remove [_option_]... _pkg_...128908 +Ref: tlmgr *--no-depends* 1129431 +Ref: tlmgr *--no-depends-at-all* 1129493 +Ref: tlmgr *--force* 2129549 +Ref: tlmgr *--dry-run* 4130021 +Node: tlmgr repository130128 +Ref: tlmgr *repository list*130336 +Ref: tlmgr *repository list _path|tag_*130366 +Ref: tlmgr *repository add _path_ [_tag_]*130399 +Ref: tlmgr *repository remove _path|tag_*130431 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*130485 +Node: tlmgr search [_option_...] _what_131569 +Node: tlmgr search [_option_...] --file _what_132080 +Node: tlmgr search [_option_...] --taxonomy _what_132331 +Node: tlmgr search [_option_...] --keyword _what_132642 +Node: tlmgr search [_option_...] --functionality _what_132960 +Node: tlmgr search [_option_...] --characterization _what_133298 +Node: tlmgr search [_option_...] --all _what_133638 +Ref: tlmgr *--global*134086 +Ref: tlmgr *--word*134198 +Ref: tlmgr *--list* 1134437 +Ref: tlmgr *--file* 1134783 +Ref: tlmgr *--taxonomy* 1134840 +Ref: tlmgr *--keyword* 1134852 +Ref: tlmgr *--functionality* 1134870 +Ref: tlmgr *--characterization* 1134891 +Ref: tlmgr *--all* 2135046 +Node: tlmgr uninstall135129 +Ref: tlmgr *--force* 3135383 +Node: tlmgr update [_option_]... [_pkg_]...135439 +Ref: tlmgr *--all* 3135810 +Ref: tlmgr *--self*137551 +Ref: tlmgr *--dry-run* 5138315 +Ref: tlmgr *--list* [_pkg_]138492 +Ref: tlmgr *--exclude* _pkg_139181 +Ref: tlmgr *--no-auto-remove* [_pkg_]...139874 +Ref: tlmgr *--no-auto-install* [_pkg_]...140325 +Ref: tlmgr *--reinstall-forcibly-removed*140981 +Ref: tlmgr *--backup* and *--backupdir* _directory_141545 +Ref: tlmgr *--no-depends* 2142726 +Ref: tlmgr *--no-depends-at-all* 2142929 +Ref: tlmgr *--force* 4142985 +Node: tlmgr USER MODE143411 +Node: tlmgr user mode install146222 +Node: tlmgr user mode backup; restore; remove; update147169 +Node: tlmgr user mode generate; option; paper147611 +Node: tlmgr CONFIGURATION FILE FOR TLMGR147987 +Node: tlmgr TAXONOMIES149078 +Ref: tlmgr '--keyword' 2149704 +Ref: tlmgr '--functionality' 2149789 +Ref: tlmgr '--characterization' 2149945 +Ref: tlmgr '--taxonomy' 2150086 +Node: tlmgr MULTIPLE REPOSITORIES150627 +Node: tlmgr Pinning152348 +Node: tlmgr GUI FOR TLMGR154323 +Node: tlmgr Main display155545 +Node: tlmgr Display configuration area155797 +Ref: tlmgr Status156158 +Ref: tlmgr Category156322 +Ref: tlmgr Match156508 +Ref: tlmgr Selection156768 +Ref: tlmgr Display configuration buttons156972 +Node: tlmgr Package list area157155 +Ref: tlmgr a checkbox157739 +Ref: tlmgr package name157875 +Ref: tlmgr local revision (and version)157974 +Ref: tlmgr remote revision (and version)158349 +Ref: tlmgr short description158646 +Node: tlmgr Main display action buttons158691 +Ref: tlmgr Update all installed158957 +Ref: tlmgr Update159329 +Ref: tlmgr Install159379 +Ref: tlmgr Remove159565 +Ref: tlmgr Backup159743 +Node: tlmgr Menu bar159900 +Ref: tlmgr 'tlmgr' menu160097 +Ref: tlmgr 'Options menu'160405 +Ref: tlmgr 'Actions menu'161488 +Ref: tlmgr 'Help menu'161916 +Node: tlmgr MACHINE-READABLE OUTPUT162049 +Node: tlmgr Machine-readable 'update' and 'install' output162865 +Ref: tlmgr 'location-url' _location_164147 +Ref: tlmgr 'total-bytes' _count_164363 +Ref: tlmgr _pkgname_164773 +Ref: tlmgr _status_164983 +Ref: tlmgr 'd'165061 +Ref: tlmgr 'f'165121 +Ref: tlmgr 'u'165300 +Ref: tlmgr 'r'165346 +Ref: tlmgr 'a'165469 +Ref: tlmgr 'i'165647 +Ref: tlmgr 'I'165766 +Ref: tlmgr _localrev_165868 +Ref: tlmgr _serverrev_165975 +Ref: tlmgr _size_166087 +Ref: tlmgr _runtime_166256 +Ref: tlmgr _esttot_166326 +Node: tlmgr Machine-readable 'option' output166359 +Node: tlmgr AUTHORS AND COPYRIGHT166877 +Node: Index167224 End Tag Table diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi index 9be53064d6d..ecebe12f2b5 100644 --- a/Build/source/doc/tlbuild.texi +++ b/Build/source/doc/tlbuild.texi @@ -1,8 +1,8 @@ \input texinfo @setfilename tlbuild.info -@set version 2014 -@set month-year May 2014 +@set version 2015 +@set month-year May 2015 @set mytitle Building @TeX{} Live (@value{version}) @settitle @value{mytitle} @@ -14,7 +14,7 @@ @copying This file documents the @TL{} build system and more. -Copyright @copyright{} 2013, 2014 Karl Berry & Peter Breitenlohner. +Copyright @copyright{} 2013, 2014, 2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -344,11 +344,10 @@ to be done unless some source files have been modified. @cindex problems with build @cindex failure to build @vindex --no-clean Build @r{option} -If configuring or building a module fails, you could either -(a)@tie{}find and fix the problem, or (b)@tie{}remove the subdirectory -for that module from the build tree, and rerun the top-level -@code{make} (or @file{Build} with @code{--no-clean} as its first -argument). +If configuring or building a module fails, you should first find and fix the +problem, then perhaps remove the subdirectory for that module from the build +tree, and finally rerun the top-level @code{make} (or @file{Build} with +@code{--no-clean} as its first argument). @node Build in parallel @@ -414,7 +413,7 @@ 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{dvipdfmx}. +finish for working on @code{dvipdfm-x}. @example mkdir mydir && cd mydir # new working directory @@ -434,7 +433,7 @@ mkdir Work && cd Work make >&outm # Test: -cd texk/dvipdfmx +cd texk/dvipdfm-x make check @end example @@ -1078,9 +1077,10 @@ structure and variation. @pindex png @r{library} @pindex libpng @r{library} +@set libpngversion libpng-1.6.16 This generic library uses the source tree in, e.g., the subdirectory -@file{libpng-1.5.17} with all modifications for TL recorded in -@file{libpng-1.5.17-PATCHES/*}. The @file{configure.ac} fragment +@file{@value{libpngversion}} with all modifications for TL recorded in +@file{@value{libpngversion}-PATCHES/*}. The @file{configure.ac} fragment @file{ac/withenable.ac} contains @example @@ -1224,11 +1224,12 @@ details for a few of the programs in TL. @subsection The @code{t1utils} package in @file{utils/t1utils} @pindex t1utils @r{package} +@set t1utilsversion t1utils-1.39 -Once again we use the distributed source tree @file{t1utils-1.38} with -modifications documented in @file{t1utils-1.38-PATCHES/*} and a proxy -build system consisting of @file{configure.ac} and @file{Makefile.am}. -The fragment @file{ac/withenable.ac} contains +Once again we use the distributed source tree @file{@value{t1utilsversion}} +with modifications documented in @file{@value{t1utilsversion}-PATCHES/*} and +a proxy build system consisting of @file{configure.ac} and +@file{Makefile.am}. The fragment @file{ac/withenable.ac} contains @example KPSE_ENABLE_PROG([t1utils]) @@ -1242,15 +1243,15 @@ supplies the configure option @code{--disable-t1utils}. @subsection The @code{xindy} package in @file{utils/xindy} @pindex xindy +@set xindyversion xindy-2.5.1 -This module uses the distributed source tree @file{xindy-2.4} with -modifications documented in @file{xindy-2.4-PATCHES/*}, a proxy -@file{configure.ac}, and a wrapper @file{Makefile.am} that descends -into @file{xindy-2.4}. The @code{xindy} build requires that the -distributed @file{Makefile}s allow a @code{VPATH} build, can handle -all targets, and do not refer to @code{$@{top_srcdir@}} or -@code{$@{top_builddir@}}. The fragment @code{ac/withenable.ac} -contains +This module uses the distributed source tree @file{@value{xindyversion}} +with modifications documented in @file{@value{xindyversion}-PATCHES/*}, a +proxy @file{configure.ac}, and a wrapper @file{Makefile.am} that descends +into @file{@value{xindyversion}}. The @code{xindy} build requires that the +distributed @file{Makefile}s allow a @code{VPATH} build, can handle all +targets, and do not refer to @code{$@{top_srcdir@}} or +@code{$@{top_builddir@}}. The fragment @code{ac/withenable.ac} contains @example KPSE_ENABLE_PROG([xindy], , [disable native]) @@ -1847,7 +1848,7 @@ program or create the @file{dvipdfm} symlink. @vindex --disable-xdvipdfmx @noindent @code{--disable-xdvipdfmx}@*Do not build the @file{xdvipdfmx} -program (building @file{xdvipdfmx} requires the @code{freetype} library). +program. @node Configure options for @file{texk/dvisvgm} |