summaryrefslogtreecommitdiff
path: root/Build/source/doc/tlbuild.texi
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/doc/tlbuild.texi')
-rw-r--r--Build/source/doc/tlbuild.texi40
1 files changed, 17 insertions, 23 deletions
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 77864610046..bb4a9fc6bda 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -486,38 +486,32 @@ things are working. There are many @code{configure} options you can
tweak as desired; check the output from @code{configure --help}.
@cindex size of source tree
-Finally, the above retrieves the entire TL source tree (some 300mb).
-It is natural to ask if this is really necessary. Strictly speaking,
-the answer is no, but it is vastly more convenient to do so. If you
-cut down the source tree, you must also give additional
-@code{configure} flags to individually disable using system versions
-of libraries, or the intricacies of the dependencies (such as
+Finally, the above retrieves the entire TL source tree (several
+hundred megabytes). It is natural to ask if this is really necessary.
+Strictly speaking, the answer is no, but it is vastly more convenient
+to do so. If you cut down the source tree, you must also give
+additional @code{configure} flags to individually disable using system
+versions of libraries, or the intricacies of the dependencies (such as
@code{teckit} requiring @code{zlib}) will have undesired side effects.
For an example, see the @code{build-pdftex.sh} script in the
-@code{pdftex} development sources (@url{http://pdftex.org}), which are
+@code{pdftex} development source (@url{http://pdftex.org}), which is
indeed a cut-down TL source tree.
@vindex --enable-missing @r{to ignore dependencies}
-Caveat 1: even with @code{--disable-all-pkgs}, dependencies will be
-checked. For instance, if a non-MacOSX system does not have
-@code{fontconfig}, Xe@TeX{} cannot be built (@pxref{Prerequisites})
-and @code{configure} will terminate. To proceed without such
-dependencies, specify @code{--enable-missing} also. (Arguably this
-should happen automatically.)
+Even with @code{--disable-all-pkgs}, dependencies will be checked.
+For instance, if a non-MacOSX system does not have @code{fontconfig},
+Xe@TeX{} cannot be built (@pxref{Prerequisites}) and @code{configure}
+will terminate. To proceed without such dependencies, specify
+@code{--enable-missing} also. (Arguably this should happen
+automatically.)
@vindex CC=@var{c-compiler}
@vindex CXX=@var{c++-compiler}
@vindex OBJCXX=@var{objc-compiler}
-@cindex ICU, prefers @code{clang} compilers
-@cindex @code{clang} compilers, preferred by ICU
-Caveat 2: unless @code{CC} and @code{CXX} and @code{OBJCXX} are
-explicitly specified, each package will configure its own compiler(s).
-In practice, this results in a conflict in only one instance: the ICU
-(@file{libs/icu}) library will prefer @code{clang} and @code{clang++}
-over all others if they are installed, whereas everything else prefers
-@code{gcc} and @code{g++}. Usually the results will be interoperable,
-but it can cause extra confusion and problems when debugging a program
-that uses ICU.
+By default, the @code{gcc} compilers will be used if present;
+otherwise, individual packages may use something different. You can
+explicitly specify the compilers to be used with the environment
+variables @code{CC}, @code{CXX}, and @code{OBJCXX}.
@node Installing