summaryrefslogtreecommitdiff
path: root/Build/source/README.config
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/README.config')
-rw-r--r--Build/source/README.config26
1 files changed, 14 insertions, 12 deletions
diff --git a/Build/source/README.config b/Build/source/README.config
index f109e03b4ac..22a46bee3c5 100644
--- a/Build/source/README.config
+++ b/Build/source/README.config
@@ -22,6 +22,9 @@ 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.
+Defaults for most options are set at the top-level and then propagated
+explicitly to all subdirectories.
+
Options specified on the command line will never be modified.
@@ -40,8 +43,8 @@ disabled and system versions of most libraries would be used (see below).
A related option '--enable-texlive-build' is automatically passed to all
subdirectories (and can not be disabled). Programs that could also be built
-independent from the TL tree (such as utils/xindy/ or texk/dvipng/) use this
-option, e.g., to choose TL specific installation directories.
+independently from the TL tree (such as utils/xindy/ or texk/dvipng/) can
+use this option, e.g., to choose TL specific installation directories.
1.2. --enable-multiplatform
---------------------------
@@ -76,11 +79,11 @@ Do not use the X Window System.
1.8. --enable-compiler-warnings=[no|min|yes|max|all]
----------------------------------------------------
-Enable various degrees of compiler warnings for C and C++. The default is
-'yes' in maintainer-mode and 'min' otherwise. This options defines
-additional CFLAGS, CXXFLAGS, OBJCFLAGS, and OBJCXXFLAGS but these flags are
-not yet used by all library and program packages. Using these compiler
-warnings should help to resolve portability problems.
+Enable various degrees of compiler warnings for (Objective) C and C++. The
+default is 'yes' in maintainer-mode and 'min' otherwise. This option
+defines WARNING_[OBJ]C[XX]FLAGS but these flags are not yet used by all
+library and program packages. Using them should help to resolve portability
+problems.
At the moment these warning flags are only defined for the GNU compilers
but flags for other compilers could be added when needed.
@@ -110,7 +113,7 @@ its requirement for clisp et al.).
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.
+version, that is, the YYYY (currently 2009).
The Build script for a TL native build currently specifies
`--with-tex-banner="TeX Live 2009"', whereas a distro build should alter
@@ -179,14 +182,13 @@ Non standard search locations for libgs.
3.1. --with-system-LIB
----------------------
Use an installed (system) version of the library `LIB'; this option exists
-for most but not all libraries (not allowed for a TeX Live native build).
+for most libraries (not allowed for a TeX Live native build).
For many libraries there are in addition '--with-LIB-includes=DIR' and
-'--with-LIB-libdir=DIR' to indicate that the library is installed in an
-unusual location.
+'--with-LIB-libdir=DIR' to indicate non standard search locations.
The top-level configure script performs a consistency check for all
-required system libraries and bails out early if one these tests fails.
+required system libraries and bails out early if some these tests fail.
3.2. Configure options for libfontconfig
----------------------------------------