summaryrefslogtreecommitdiff
path: root/Build/source/README.layout
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2009-03-29 16:03:30 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2009-03-29 16:03:30 +0000
commit1de70c5fe1e18157efb4a592390ce08534139aa0 (patch)
treee95068190830febe15dfaab6f0600fb769492706 /Build/source/README.layout
parent5b8dcec4983808da1a0b25a4f41435b03370a79f (diff)
new build system: multiplatform, cxx-runtime-hack, luatex
git-svn-id: svn://tug.org/texlive/trunk@12563 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.layout')
-rw-r--r--Build/source/README.layout40
1 files changed, 40 insertions, 0 deletions
diff --git a/Build/source/README.layout b/Build/source/README.layout
index 406154adf44..dbb5139c2c9 100644
--- a/Build/source/README.layout
+++ b/Build/source/README.layout
@@ -75,3 +75,43 @@ texk/Prog/ac/Prog.ac defines Prog specific configure option that should
utils/Util/ac/withenable.ac defines libraries required by Util, provides the
configure option --disable-Util
+2. Running `configure'
+======================
+
+Running configure for the top-level directory will in addition configure the
+directories texk/kpathsea/, libs/, libs/dummy/, utils/, utils/dummy, texk/,
+and texk/dummy/. This will determine the programs to be built (utils/Util/
+and texk/Prog) and libraries from the TL tree (texk/kpathsea/ and libs/Lib)
+required by these programs.
+
+3. Running `make'
+=================
+
+Running make in the top-level directory will recurse into the directories
+texk/kpathsea/, libs/, utils/, and texk/.
+
+3.1. Running `make' in libs/
+----------------------------
+
+First, for each subdirectory libs/Lib not yet configured, this runs
+`configure' and if required `make all' in that directory. Then this
+recurses into all required subdirectories for the selected make target:
+`default' or `all' to (re-)build, `check' to run tests, `install' etc.
+
+3.2. Running `make' in utils/ and texk/
+---------------------------------------
+
+Quite similarly, for each subdirectory utils/Util and texk/Prog not yet
+configured, this first runs `configure' and if required `make all' in that
+directory. Subsequently, this recurses into all required subdirectories to
+(re-)build, run tests, install, etc.
+
+3.3 Comment
+-----------
+
+The process described above configures all directories, even for libraries
+or programs not to be built. This is necessary for make targets such as
+`dist' or `distcheck' that have to recurse into all subdirectories, whereas
+targets such as `all', `check', or `install' only recurse into the required
+subdirectories.
+