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.config49
1 files changed, 26 insertions, 23 deletions
diff --git a/Build/source/README.config b/Build/source/README.config
index 2b4502afdbe..b9e6a6a1c63 100644
--- a/Build/source/README.config
+++ b/Build/source/README.config
@@ -22,7 +22,7 @@ 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.
+Options specified on the command line will never be modified.
1. Global configure options
@@ -69,22 +69,23 @@ Omit support for large files (>=2GB).
----------------
Do not use the X Window System.
-1.7. --enable-compiler-warnings=[no|min|yes|max]
-------------------------------------------------
+1.7. --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 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.
+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.
-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.
+At the moment these warning flags are only defined for the GNU compilers
+but flags for other compilers could be added when needed.
1.8. --disable-missing
----------------------
Immediately terminate the build process if a requested program or feature
must be disabled, e.g., due to missing libraries.
+
2. Configure options for program packages
=========================================
@@ -143,8 +144,8 @@ 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. The web
+Build the Web versions of the omega font utilies (ofm2opl, opl2ofm,
+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.
@@ -190,6 +191,12 @@ 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).
+3.5. Configure options for the icu libraries
+--------------------------------------------
+3.5.1. --with-system-icu
+Use installed icu headers and libraries for bibtexu (and icu-config to
+obtain the required flags). However, XeTeX, still requires the (modified)
+icu headers and libraries from the TL tree.
4. Interesting and/or important VAR=value configure arguments
=============================================================
@@ -199,27 +206,23 @@ Used instead of searching for programs in PATH.
----------------------------------------
For system freetype2 library.
-4.2. PKG_CONFIG=/path/to/pkg-config
+4.2. ICU_CONFIG=/path/to/icu-config
+----------------------------------------
+For system icu libraries.
+
+4.3. PKG_CONFIG=/path/to/pkg-config
-----------------------------------
For fontconfig and system xpdf (poppler) libraries.
-4.3. CLISP=/path/to/clisp
+4.4. 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
--------------------------------
+4.5. PERL=/path/to/perl, LATEX=/path/to/latex, PDFLATEX=/path/to/pdflatex
+-------------------------------------------------------------------------
To build xindy docs.
-4.7. KPSEWHICH=/path/to/kpsewhich
+4.6. KPSEWHICH=/path/to/kpsewhich
---------------------------------
For `make check'.