summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-06-01 18:48:40 +0000
committerKarl Berry <karl@freefriends.org>2009-06-01 18:48:40 +0000
commit1bdc132f5edb897391bd7ab4d11ccee00696e645 (patch)
tree67f8a2877184610fee4437195337c7dea16a9a12
parent0a24b5c2f300af1873202c13f53053a31b867625 (diff)
specify --with-tex-banner, doc tweaks
git-svn-id: svn://tug.org/texlive/trunk@13564 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xBuild/source/Build3
-rw-r--r--Build/source/README.config127
2 files changed, 55 insertions, 75 deletions
diff --git a/Build/source/Build b/Build/source/Build
index fa25ff8b567..53d20cc1bbe 100755
--- a/Build/source/Build
+++ b/Build/source/Build
@@ -68,6 +68,9 @@ cd $TL_WORKDIR || exit 1
# allow override of configure location, just in case.
: ${TL_CONFIGURE=../configure}
+# banner for TeX et al.
+: ${TL_CONF_BANNER=--with-tex-banner="TeX Live 2009"}
+
# default to static linking.
: ${TL_CONF_SHARED=--disable-shared}
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.