diff options
Diffstat (limited to 'Build')
| -rw-r--r-- | Build/source/README.1prerequisites | 4 | ||||
| -rw-r--r-- | Build/source/README.2building | 2 | ||||
| -rw-r--r-- | Build/source/README.3installing | 31 | ||||
| -rw-r--r-- | Build/source/README.4layout | 4 | ||||
| -rw-r--r-- | Build/source/doc/tlbuild.info | 143 | ||||
| -rw-r--r-- | Build/source/doc/tlbuild.texi | 6 |
6 files changed, 97 insertions, 93 deletions
diff --git a/Build/source/README.1prerequisites b/Build/source/README.1prerequisites index 3c3e72ae310..e118df53575 100644 --- a/Build/source/README.1prerequisites +++ b/Build/source/README.1prerequisites @@ -29,8 +29,8 @@ Automake/Autoconf output in general) should work with any reasonable requires 'fontconfig' (again both headers and library). 'xindy' - requires GNU 'clisp' and 'libffcall', and in addition 'perl', - 'latex', and 'pdflatex' to build the rules and/or documentation. + requires GNU 'clisp' and in addition 'perl', 'latex', and + 'pdflatex' to build the rules and/or documentation. Lacking the required tools, building these programs must avoided, e.g., 'configure --without-x --disable-xetex --disable-xindy' diff --git a/Build/source/README.2building b/Build/source/README.2building index cc4795229f0..65549a2d5ac 100644 --- a/Build/source/README.2building +++ b/Build/source/README.2building @@ -128,7 +128,7 @@ for debugging purposes. things are working. There are many 'configure' options you can tweak as desired; check the output from 'configure --help'. - Finally, the above retrieves the entire TL source tree (some 500mb). + Finally, the above retrieves the entire TL source tree (some 300mb). It is natural to ask if this is really necessary. Strictly speaking, the answer is no, but it is vastly more convenient to do so. If you cut down the source tree, you must also give additional 'configure' flags to diff --git a/Build/source/README.3installing b/Build/source/README.3installing index c65ebde5d9d..dad88c53430 100644 --- a/Build/source/README.3installing +++ b/Build/source/README.3installing @@ -7,10 +7,10 @@ This section discusses the results of 'make install' in the source tree. - The main consideration is that this is not enough to make a usable -TeX installation. Beyond the binaries that are built from the sources, -(thousands of) support files are needed; just as a first example -'plain.tex' is not in the source tree. + The main consideration is that 'make install' is not enough to make a +usable TeX installation. Beyond the compiled binaries, (thousands of) +support files are needed; just as a first example 'plain.tex' is not in +the source tree. These support files are maintained completely independently and are not present in the source tree. The best basis for dealing with them is @@ -75,17 +75,23 @@ to 'DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl'. For Windows, a standard wrapper binary (e.g., 'BINDIR/ps2eps.exe') serves the same purpose. (The source for the wrapper is in 'texk/texlive/w32_wrapper'.) - One reason for all this is to avoid having many copies of the same -script, but more importantly this allows invoking the same script on all -operating systems. Furthermore, we want the 'BINDIR' resulting from the -build to be exactly what is in the TL distribution; any deviations cause -considerable extra work. + One reason for this is to avoid having many copies of the same +script; a more important reason is that it guarantees the scripts will +stay in sync across the different supported operating systems. + + Most important of all, we want the 'BINDIR' resulting from the build +to be as close as possible to what is in the TL distribution. At +present, there are a few exceptions--Asymptote, Biber, Xindy--and each +one creates considerable extra work. We don't want to add more. (See +<http://tug.org/texlive/build.html> for information about building those +exceptions, as well as the 'xz' and 'wget' programs that are used in the +TL infrastructure.) 5.3 Distro builds ================= Although they use the same code base, building for the native TL -distribution as shipped by the TL user groups is typically quite +distribution as shipped by the TeX user groups is typically quite different from a "distro" build needed by, e.g., a full GNU/Linux or BSD operating system distribution. @@ -136,6 +142,7 @@ find most relevant: (*note Installing::), and many other issues, such as font maps, languages, and formats, independently of the build. Norbert Preining has written a detailed article on adapting TL for distros: -<http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf>. (If it needs -updating at some point, perhaps we will merge it into this document.) +<http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf>. (If the +article needs updating in the future, perhaps we will merge it into this +document.) diff --git a/Build/source/README.4layout b/Build/source/README.4layout index acf1bc24dbc..7abdeae15f9 100644 --- a/Build/source/README.4layout +++ b/Build/source/README.4layout @@ -89,8 +89,8 @@ and similar places. The 'reautoconf' script does not touch those, but a TL cron job keeps them in sync (nightly). The directory 'extra/' contains things which are not part of the TL -build, but are present for convenience, e.g., 'epstopdf' developed here -and 'xz/' required by the TL installer. +build, but are present just for (someone's) convenience, e.g., +'epstopdf' which is developed here. 6.3 Autoconf macros =================== diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info index 169300d111c..6fee5b6bd9f 100644 --- a/Build/source/doc/tlbuild.info +++ b/Build/source/doc/tlbuild.info @@ -157,8 +157,8 @@ Automake/Autoconf output in general) should work with any reasonable requires 'fontconfig' (again both headers and library). 'xindy' - requires GNU 'clisp' and 'libffcall', and in addition 'perl', - 'latex', and 'pdflatex' to build the rules and/or documentation. + requires GNU 'clisp' and in addition 'perl', 'latex', and + 'pdflatex' to build the rules and/or documentation. Lacking the required tools, building these programs must avoided, e.g., 'configure --without-x --disable-xetex --disable-xindy' @@ -2303,7 +2303,6 @@ Index (line 6) * LFS (large file support): '--disable-largefile'. (line 6) -* 'libffcall', required by 'xindy': Prerequisites. (line 30) * libfreetype: Variables for configure. (line 24) * 'libfreetype', and 'const': Const. (line 21) @@ -2485,74 +2484,74 @@ Node: Top993 Node: Introduction1786 Node: Overview of build system2965 Node: Prerequisites5029 -Node: Building7108 -Node: Build iteration8327 -Node: Build problems9399 -Node: Build in parallel9792 -Node: Build distribution10384 -Node: Build one package10955 -Node: Installing13728 -Node: Installation directories14743 -Node: Linked scripts16563 -Node: Distro builds18044 -Node: Layout and infrastructure20434 -Node: Build system tools21223 -Node: Top-level directories23235 -Node: Autoconf macros25289 -Node: General setup macros25990 -Node: Macros for programs26857 -Node: Macros for compilers27669 -Node: Macros for libraries29103 -Node: Macros for library and header flags29529 -Node: Macros for Windows31398 -Node: Library modules32975 -Node: 'png' library33472 -Node: 'zlib' library35765 -Node: 'freetype' library36286 -Node: 'kpathsea' library36820 -Node: Program modules38244 -Node: 't1utils' package38680 -Node: 'xindy' package39247 -Node: 'xdvik' package40426 -Node: 'asymptote'41505 -Node: Extending TeX Live41960 -Node: Adding a new program module42328 -Node: Adding a new generic library module43847 -Node: Adding a new TeX-specific library module46060 -Node: Configure options46747 -Node: Global configure options48138 -Node: '--disable-native-texlive-build'48706 -Node: '--prefix' '--bindir' ...49702 -Node: '--disable-largefile'50250 -Node: '--disable-missing'51017 -Node: '--enable-compiler-warnings='LEVEL51424 -Node: '--enable-cxx-runtime-hack'52169 -Node: '--enable-maintainer-mode'52602 -Node: '--enable-multiplatform'53137 -Node: '--enable-shared'53698 -Node: '--enable-silent-rules'54075 -Node: '--without-ln-s'54537 -Node: '--without-x'54894 -Node: Program-specific configure options55086 -Node: '--enable-PROG' '--disable-PROG'55749 -Node: '--disable-all-pkgs'56032 -Node: Configure options for 'texk/web2c'57026 -Node: Configure options for 'texk/bibtex-x'59693 -Node: Configure options for 'texk/dvipdfm-x'60269 -Node: Configure options for 'texk/dvisvgm'61108 -Node: Configure options for 'texk/texlive'61998 -Node: Configure options for 'texk/xdvik'62425 -Node: Configure options for 'utils/xindy'63035 -Node: Library-specific configure options64097 -Node: Configure options for 'kpathsea'65111 -Node: Configure options for system 'poppler'65824 -Node: Variables for configure66591 -Node: Cross compilation68019 -Node: Cross configuring69284 -Node: Cross problems70957 -Node: Coding conventions72818 -Node: Declarations and definitions73482 -Node: Const75665 -Node: Index77528 +Node: Building7091 +Node: Build iteration8310 +Node: Build problems9382 +Node: Build in parallel9775 +Node: Build distribution10367 +Node: Build one package10938 +Node: Installing13711 +Node: Installation directories14726 +Node: Linked scripts16546 +Node: Distro builds18027 +Node: Layout and infrastructure20417 +Node: Build system tools21206 +Node: Top-level directories23218 +Node: Autoconf macros25272 +Node: General setup macros25973 +Node: Macros for programs26840 +Node: Macros for compilers27652 +Node: Macros for libraries29086 +Node: Macros for library and header flags29512 +Node: Macros for Windows31381 +Node: Library modules32958 +Node: 'png' library33455 +Node: 'zlib' library35748 +Node: 'freetype' library36269 +Node: 'kpathsea' library36803 +Node: Program modules38227 +Node: 't1utils' package38663 +Node: 'xindy' package39230 +Node: 'xdvik' package40409 +Node: 'asymptote'41488 +Node: Extending TeX Live41943 +Node: Adding a new program module42311 +Node: Adding a new generic library module43830 +Node: Adding a new TeX-specific library module46043 +Node: Configure options46730 +Node: Global configure options48121 +Node: '--disable-native-texlive-build'48689 +Node: '--prefix' '--bindir' ...49685 +Node: '--disable-largefile'50233 +Node: '--disable-missing'51000 +Node: '--enable-compiler-warnings='LEVEL51407 +Node: '--enable-cxx-runtime-hack'52152 +Node: '--enable-maintainer-mode'52585 +Node: '--enable-multiplatform'53120 +Node: '--enable-shared'53681 +Node: '--enable-silent-rules'54058 +Node: '--without-ln-s'54520 +Node: '--without-x'54877 +Node: Program-specific configure options55069 +Node: '--enable-PROG' '--disable-PROG'55732 +Node: '--disable-all-pkgs'56015 +Node: Configure options for 'texk/web2c'57009 +Node: Configure options for 'texk/bibtex-x'59676 +Node: Configure options for 'texk/dvipdfm-x'60252 +Node: Configure options for 'texk/dvisvgm'61091 +Node: Configure options for 'texk/texlive'61981 +Node: Configure options for 'texk/xdvik'62408 +Node: Configure options for 'utils/xindy'63018 +Node: Library-specific configure options64080 +Node: Configure options for 'kpathsea'65094 +Node: Configure options for system 'poppler'65807 +Node: Variables for configure66574 +Node: Cross compilation68002 +Node: Cross configuring69267 +Node: Cross problems70940 +Node: Coding conventions72801 +Node: Declarations and definitions73465 +Node: Const75648 +Node: Index77511 End Tag Table diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi index 705fb1e320b..00595815874 100644 --- a/Build/source/doc/tlbuild.texi +++ b/Build/source/doc/tlbuild.texi @@ -233,11 +233,9 @@ requires @file{fontconfig} (again both headers and library). @item xindy @cindex @code{clisp}, required by @code{xindy} -@cindex @code{libffcall}, required by @code{xindy} @cindex @code{ffcall}, required by @code{xindy} -requires GNU @code{clisp} and @code{libffcall}, and in addition -@code{perl}, @code{latex}, and @code{pdflatex} to build the rules -and/or documentation. +requires GNU @code{clisp} and in addition @code{perl}, @code{latex}, +and @code{pdflatex} to build the rules and/or documentation. @end table |