diff options
author | Karl Berry <karl@freefriends.org> | 2009-06-01 18:48:40 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-06-01 18:48:40 +0000 |
commit | 1bdc132f5edb897391bd7ab4d11ccee00696e645 (patch) | |
tree | 67f8a2877184610fee4437195337c7dea16a9a12 /Build/source/README.config | |
parent | 0a24b5c2f300af1873202c13f53053a31b867625 (diff) |
specify --with-tex-banner, doc tweaks
git-svn-id: svn://tug.org/texlive/trunk@13564 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.config')
-rw-r--r-- | Build/source/README.config | 127 |
1 files changed, 52 insertions, 75 deletions
diff --git a/Build/source/README.config b/Build/source/README.config index ef3b2047092..27e3a31150f 100644 --- a/Build/source/README.config +++ b/Build/source/README.config @@ -4,143 +4,131 @@ You may freely use, modify and/or distribute this file. Configure options for the TeX Live (TL) build system ===================================================== -The TL 2009 build system contains a collection of program packages, i.e., -subdirectories texk/Prog/ (where `Prog' is web2c, afm2pl, bibtex8, etc.) and -utils/Util/ (where `Util' is dialog, pdfopen, etc.) as well as library -packages, i.e., subdirectories texk/kpathsea/ and libs/Lib/ (where `Lib' is -zlib, libpng, t1lib, etc.) for most of the libraries required by the program -packages. Correspondingly there are plenty of configure options, most of -them described below. See 'configure --help' (at the top-level) for an -exhaustive list of all global options and a few important package specific -ones or run, e.g., 'texk/lcdf-typetools/configure --help' to also see -lcdf-typetools specific options not shown at the top-level. - -Note, however, that the ./Build script invokes the top-level configure with -a few additional options. Any defaults discussed below are those for the -configure script, invoking configure from ./Build yields different results. +The TL 2009 build system contains a collection of program packages, +i.e., subdirectories texk/PROG/ (where `PROG' is web2c, afm2pl, bibtex8, +etc.) and utils/UTIL/ (where `UTIL' is dialog, pdfopen, etc.) as well as +library packages, i.e., subdirectories texk/kpathsea/ and libs/LIB/ +(where `LIB' is zlib, libpng, t1lib, etc.) for most of the libraries +required by the program packages. Correspondingly there are plenty of +configure options, most of which are described below. + +See 'configure --help' (at the top-level) for an exhaustive list of all +global options and a few important package specific ones or run, e.g., +'texk/lcdf-typetools/configure --help' to also see lcdf-typetools +specific options not shown at the top level. + +Note, however, that the ./Build script used to make the binaries shipped +with TeX Live invokes the top-level configure with a few additional +options. Any defaults discussed below are those for the base configure +script; thus, invoking configure via ./Build yields different results. + Options explicitly specified on the command will never be modified. + 1. Global configure options =========================== 1.1. --disable-native-texlive-build ----------------------------------- - -If enabled (by default) build for a TeX Live binary distribution such as -the TL2009 DVD-Rom; this implies '--enable-multiplatform' and +If enabled (by default) build for a TeX Live binary distribution as +shipped by the user groups; this implies '--enable-multiplatform' and '--enable-cxx-runtime-hack' unless they are explicitly disabled. -Building TL for a Linux or other distribution, this would be disabled and -system versions of most libraries would be used (see below). +If building TL for a GNU/Linux or other distribution, this would be +disabled and system versions of most libraries would be used (see below). 1.2. --enable-multiplatform --------------------------- - If enabled, install executables and libraries in platform dependent subdirectories of EPREFIX/bin and EPREFIX/lib (unless '--bindir=DIR' or -'--libdir=DIR' is specified). This option automatically propagates the -values for bindir and libdir to all subdirectories to be configured, and -thus need not be used explicitly in any program or library package. +'--libdir=DIR' is specified), where EPREFIX is the exec-prefix. This +option automatically propagates the values for bindir and libdir to all +subdirectories to be configured, and thus need not be used explicitly in +any program or library package. 1.3. --enable-cxx-runtime-hack ------------------------------ - If enabled and when using gcc, try to statically link with libstc++, somewhat improving portability. 1.4. --disable-largefile ------------------------ - Omit support for large files (>=2GB). 1.5. --without-x ---------------- - Do not use the X Window System. + 2. Configure options for program packages ========================================= -2.1. --disable-Prog and --disable-Util +2.1. --disable-PROG and --disable-UTIL -------------------------------------- - -Do not build and install the program(s) of the package `Prog' or `Util'. +Do not build and install the program(s) of the package `PROG' or `UTIL'. 2.2. --disable-all-pkgs ----------------------- - -Do not build any program packages, except those explicitly enabled. Without -this options all packages are built except those explicitly disabled (except -for utils/xindy/ which is disabled by default due to its requirement for -clisp and others). +Do not build any program packages, except those explicitly enabled. +Without this option, all packages are built except those explicitly +disabled except for utils/xindy/ which is disabled by default due to +its requirement for clisp et al. 2.3. Configure options for texk/web2c/ -------------------------------------- - 2.3.1. --with-tex-banner=STR +Specify the version string STR appended to banner lines, replacing the +default `Web2C YYYY'; the string STR must contain the current Web2C +version, that is, the YYYY. -Specify the version string STR appended to banner lines, replacing the current -default `Web2C 2009'; the string STR must contain the current Web2C version. - -The Build script for a TL native build currently uses the default -`--with-tex-banner="TeX Live 2009"', whereas when buildind for a distro one -might specify, e.g., `--with-tex-banner="TeX Live 2009/Debian"' +The Build script for a TL native build currently specifies +`--with-tex-banner="TeX Live 2009"', whereas a distro build should alter +this to, e.g., `--with-tex-banner="TeX Live 2009/Debian"'. 2.3.1. --with-editor=CMD - Specify the command CMD to invoke from the `e' option, replacing the default `vi +%d %s'. 2.3.3. --enable-auto-core - This option causes TeX & MF to produce a core dump when a particular filename is encountered. 2.3.4. --disable-dump-share - -Make the fmt/base/mem dump files architecture dependend (somewhat faster +Make the fmt/base/mem dump files architecture dependent (somewhat faster on little-endian architectures). 2.3.5. --disable-ipc - If enabled (by default) allow TeX's '--ipc' option. 2.3.6. --disable-tex, --enable-etex, --disable-aleph, --disable-pdftex, --disable-luatex, --disable-xetex, --disable-mf, --disable-mp - Do or do not build the various TeX, METAFONT, and MetaPost engines. 2.3.7. --with-mf-x-toolkit - Use the X toolkit (libXt) for METAFONT (default is yes). 2.3.8. --enable-*win - -Include various types of window support for METAFONT. +Include various types of other window support for METAFONT. 2.3.9. --disable-mf-nowin - -Do not build a separate non-windows-capable METAFONT. +Do not build a separate non-graphically-capable METAFONT. 2.3.10. --disable-web-progs - -Do not build the WEB programs bibtex ... weave, e.g., when you just have to -rebuid some engines. +Do not build the WEB programs bibtex ... weave, e.g., if you just +want to rebuild engines. 2.3.11. --disable-omfonts - Build the Web2C versions of the omega font utilies (ofm2opl, opl2ofm, -ovf2ovp, and ovp2ovf) instead of the C version omfonts. +ovf2ovp, and ovp2ovf) instead of the C version, omfonts. The web +versions are needed in Japanese environments; the C versions fix some +(unknown) bugs. We hope the situation will be resolved. 2.4. Configure options for texk/xdvik/ -------------------------------------- - 2.4.1. --with-gs=PATH - Hardwire the location of GhostScript (gs). 2.4.2. --with-xdvi-x-toolkit=KIT - Use toolkit KIT (motif/xaw/xaw3d/neXtaw) for xdvi, default: Motif if available, else Xaw. @@ -149,7 +137,6 @@ available, else Xaw. 3.1. --with-system-Lib ---------------------- - Use an installed (system) version of the library `Lib'; this option exists for most but not all libraries. @@ -162,63 +149,53 @@ required system libraries and bails out early if one these tests fails. 3.2. Configure options for libfontconfig ---------------------------------------- - Building XeTeX and xdvipdfmx on non-Mac systems requires libfontconfig. 3.2.1. --with-fontconfig-includes=DIR, --with-fontconfig-libdir=DIR - If one or both of these options are given, the flags are derived from them. Otherwise, the flags are determined via pkg-config (if present). 3.3. Configure options for system libfreetype --------------------------------------------- - The flags for a system freetype library are determined via freetype-config. 3.4. Configure options for libpoppler ------------------------------------- - 3.4.1. --with-system-xpdf - Use libpoppler instead of xpdf (and pkg-config to obtain the required flags). -4. Important VAR=value configure arguments +4. Interesting and/or important VAR=value configure arguments ========================================== - Used instead of searching for programs in PATH. 4.1. FT2_CONFIG=/path/to/freetype-config ---------------------------------------- - For system freetype2 library. 4.2. PKG_CONFIG=/path/to/pkg-config ----------------------------------- - For fontconfig and system xpdf (poppler) libraries. 4.3. CLISP=/path/to/clisp ------------------------- - For xindy. 4.4. PERL=/path/to/perl ------------------------- - To build xindy rules and docs. 4.5. LATEX=/path/to/latex ------------------------- - To build xindy rules. 4.6. PDFLATEX=/path/to/pdflatex ------------------------------- - To build xindy docs. 4.7. KPSEWHICH=/path/to/kpsewhich --------------------------------- +For `make check'. -For 'make check'. +Happy building. Please use the tlbuild list for questions or +discussion: http://lists.tug.org/tlbuild. |