summaryrefslogtreecommitdiff
path: root/Build/source/doc/tlbuild.texi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-08-31 22:05:09 +0000
committerKarl Berry <karl@freefriends.org>2020-08-31 22:05:09 +0000
commitf2c3a00c5a4c8a9357422c0dcc50eaeae0e67893 (patch)
tree2e541274f99d398609c0d013730215b4479e5b35 /Build/source/doc/tlbuild.texi
parent579a9a84ceeb367e9ca4a7034844b043bf62ac05 (diff)
(Build one engine): update doc
git-svn-id: svn://tug.org/texlive/trunk@56229 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/doc/tlbuild.texi')
-rw-r--r--Build/source/doc/tlbuild.texi34
1 files changed, 23 insertions, 11 deletions
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 06b70960927..19f2c438cc0 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -441,7 +441,7 @@ library, first building any required libraries.
Here is an example from start to finish for working on
@code{dvipdfm-x}. (Unfortunately, this does not suffice for building
-one, or a subset, of the @TeX{} engines; see the next section.)
+the @TeX{} engines; see the next section.)
@example
mkdir mydir && cd mydir # new working directory
@@ -537,22 +537,33 @@ not suffice: wanting to build one, or a subset, of the @TeX{} engines
(or other Web2c programs).
The simplest way to do this is to disable everything and then
-explicitly specify what to make. For example, to build only Lua@TeX{}:
+explicitly specify what to make. For example, to build only the
+original @TeX{}:
@example
-./configure --disable-all-pkgs # or ./Build
-cd Work/texk/web2c # build directory
-make luatex # specify target
+cd Work # top build directory
+../configure --without-x --disable-shared --disable-all-pkgs \
+ --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g
+make
+cd texk/web2c # cd engine build directory
+make tex # must specify target
@end example
-This works because the @code{make} automatically runs @code{configure}
-as necessary for the dependencies and target. Furthermore, the source
-tree can be cut down to just what is needed for the given engine
-(the separate pdf@TeX{} and Lua@TeX{} source repositories do this, if
-you want to peruse examples).
+The first @code{make} run will configure everything, and even build
+the libraries, even though the packages are disabled.
+The source tree can be cut down to just what is needed for the given
+engine (the separate pdf@TeX{} and Lua@TeX{} source repositories do
+this, for example), but see caveats in previous section.
-We hope to improve the situation in the future. Patches are welcome.
+If you want to debug an X-related program or shared library setup, or
+other variants, change the @code{configure} options
+accordingly. Either @code{../Build} or @code{../configure} can be run.
+Then it is necessary to again specify the target engine (@code{tex},
+in the above) in the @code{make}.
+
+All this is somewhat unfortunate. We hope to improve the situation in
+the future. Patches are welcome.
@node Cross compilation
@section Cross compilation
@@ -702,6 +713,7 @@ and @file{tie}.
Building @code{xindy} requires running the host system @code{clisp}
binary, thus cross compilation is painful, but possible.
+
@node Installing
@chapter Installing