summaryrefslogtreecommitdiff
path: root/Build/source/README.config
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2009-06-15 15:20:15 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2009-06-15 15:20:15 +0000
commitd7f57509ce0c5b91ed9abb642f8263fe33178ff4 (patch)
tree66ec15ba1a12789c9554f1c85c9aff9c483a2ff1 /Build/source/README.config
parent4b9080e91796d90175624fb4968fecff03cf6a51 (diff)
upate
git-svn-id: svn://tug.org/texlive/trunk@13766 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.config')
-rw-r--r--Build/source/README.config40
1 files changed, 31 insertions, 9 deletions
diff --git a/Build/source/README.config b/Build/source/README.config
index 34a34e1e33c..330ad3cb245 100644
--- a/Build/source/README.config
+++ b/Build/source/README.config
@@ -32,11 +32,17 @@ Options explicitly specified on the command will never be modified.
-----------------------------------
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.
+'--enable-cxx-runtime-hack' unless they are explicitly disabled and
+enforces '--disable-shared'.
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).
+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.
+
1.2. --enable-multiplatform
---------------------------
If enabled, install executables and libraries in platform dependent
@@ -48,17 +54,31 @@ any program or library package.
1.3. --enable-cxx-runtime-hack
------------------------------
-If enabled and when using gcc, try to statically link with libstc++,
+If enabled and when using g++, try to statically link with libstc++,
somewhat improving portability.
-1.4. --disable-largefile
+1.4. --enable-shared
+---------------------
+Build a shared Kpathsea library (not allowed for a TeX Live native build).
+
+1.5. --disable-largefile
------------------------
Omit support for large files (>=2GB).
-1.5. --without-x
+1.6. --without-x
----------------
Do not use the X Window System.
+1.7. --enable-compiler-warnings=[no|min|yes|max]
+------------------------------------------------
+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 or CXXFLAGS, but these flags are not yet used by all
+library and program packages (actually only by a few of them). Using these
+compiler warnings should help to resolve portability problems.
+
+At the moment these warning flags are only defined for the GNU compilers gcc
+and g++, but flags for other compilers could be added when needed.
2. Configure options for program packages
=========================================
@@ -132,16 +152,17 @@ Hardwire the location of GhostScript (gs).
Use toolkit KIT (motif/xaw/xaw3d/neXtaw) for xdvi, default: Motif if
available, else Xaw.
+
3. Configure options for libraries
==================================
-3.1. --with-system-Lib
+3.1. --with-system-LIB
----------------------
-Use an installed (system) version of the library `Lib'; this option exists
-for most but not all libraries.
+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 many libraries there are in addition '--with-Lib-includes=DIR' and
-'--with-Lib-libdir=DIR' to indicate that the library is installed in an
+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.
The top-level configure script performs a consistency check for all
@@ -164,6 +185,7 @@ The flags for a system freetype library are determined via freetype-config.
3.4.1. --with-system-xpdf
Use libpoppler instead of xpdf (and pkg-config to obtain the required flags).
+
4. Interesting and/or important VAR=value configure arguments
==========================================
Used instead of searching for programs in PATH.