summaryrefslogtreecommitdiff
path: root/Build/source/README.layout
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-29 18:58:31 +0000
committerKarl Berry <karl@freefriends.org>2011-08-29 18:58:31 +0000
commitbfbd87a0b6c0a2f58a463749e7502f780aaec362 (patch)
treee8f4361d68def893f1caac0c11535213dca602c8 /Build/source/README.layout
parentea33782ecfe04d2116e2aaae0762c62d9736c211 (diff)
typos, etc.
git-svn-id: svn://tug.org/texlive/trunk@23748 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.layout')
-rw-r--r--Build/source/README.layout38
1 files changed, 19 insertions, 19 deletions
diff --git a/Build/source/README.layout b/Build/source/README.layout
index 96565d10296..f4ae3e1adbf 100644
--- a/Build/source/README.layout
+++ b/Build/source/README.layout
@@ -1,10 +1,10 @@
-Copyright (C) 2009, 2010 Peter Breitenlohner <tex-live@tug.org>
+Copyright (C) 2009-2011 Peter Breitenlohner <tex-live@tug.org>
You may freely use, modify and/or distribute this file.
Design of the TeX Live (TL) build system
========================================
-The TL 2009 build system has been completely redesigned, using Autoconf,
+The TL build system has been completely redesigned, using Autoconf,
Automake, and Libtool. The main components are TeX specific or utility
program modules (directories texk/*/ and utils/*/), and TeX specific or
generic library modules (directories texk/kpathsea/, texk/ptexenc/, and
@@ -21,9 +21,9 @@ configuring any (program or other library) module depending on that library.
This allows to check for properties and features of a library built as part
of the TL tree in much the same way as for a system version of that library.
-Most generic libraries and several programs that are mintained independently
-use the distributed source tree, any modifications of that source tree are
-kept as patches.
+Most generic libraries and several programs that are maintained independently
+use the distributed source tree, with any patches to that source tree
+also kept separately as precise documentation of our changes.
All this should simplify upgrading of modules maintained independently
and/or integrating new modules into the TL build system.
@@ -37,8 +37,8 @@ and/or integrating new modules into the TL build system.
1.1. Overall layout
-------------------
-texk/kpathsea/ the two TeX specific Kpathsea
-texk/ptexenc/ and Ptexenc libraries
+texk/kpathsea/ the two TeX specific libraries, Kpathsea
+texk/ptexenc/ and Ptexenc
libs/Lib/ generic library Lib (zlib, libpng, t1lib, etc.)
texk/Prog/ TeX specific program package Prog (web2c, afm2pl, etc.)
utils/Util/ utility program package Util (dialog, ps2eps, etc.)
@@ -63,8 +63,9 @@ texk/web2c/*/am/*.am and the Web2C programs
libs/Lib/ac/withenable.ac defines libraries required by Lib
libs/Lib/ac/Lib.ac defines basic tests for a system version of Lib
m4/kpse-Lib-flags.m4 defines Autoconf macros for configure options
- as well as KPSE_LIB_FLAGS, to be used in configure.ac
- files and defining Make variables
+ as well as KPSE_LIB_FLAGS, to be used
+ in configure.ac files and defining
+ Make variables
Several libraries use an (almost) unmodified source tree supplemented by a
proxy build system (bypassing that of the source tree), e.g.,
@@ -82,16 +83,16 @@ The same structure is used for the TeX specific libraries.
1.3. A TeX specific program `Prog'
----------------------------------
-texk/Prog/ac/withenable.ac defines libraries required by Prog, provides the
- configure option --disable-Prog
-texk/Prog/ac/Prog.ac optionally defines Prog specific configure option
- that should be seen at the top-level
+texk/Prog/ac/withenable.ac defines libraries required by Prog,
+ provides the configure option --disable-Prog
+texk/Prog/ac/Prog.ac optionally defines Prog specific configure
+ option that should be seen at the top-level
1.4. A utility program `Util'
-----------------------------
-utils/Util/ac/withenable.ac defines libraries required by Util, provides the
- configure option --disable-Util
+utils/Util/ac/withenable.ac defines libraries required by Util, provides
+ the configure option --disable-Util
2. Running `configure'
======================
@@ -140,7 +141,7 @@ up to 50 compilations in parallel.
--------------------------------
Further speed up of a TL build can be achieved by using a configure cache
-file, e.g., running 'configure -C' at the top-level.
+file, e.g., running 'configure -C' at the top level.
3.5 Comments
------------
@@ -164,7 +165,7 @@ fix the problem, and once again run 'make' from the top-level.
3.5.3 Comment 3
---------------
-The build system allows to successfully run 'make dist' and 'make distcheck'
+The TL build system successfully runs 'make dist' and 'make distcheck'
(at least on my {i686,x86_64}-linux-gnu systems), producing tarballs
tex-live-20YY-MM-DD.tar.{gz,xz} from which everything can be (re-)built;
please keep it that way!
@@ -178,7 +179,7 @@ and programs not to be built. This is necessary for Make targets such as
the normal targets `all', `check', or `install' only recurse into the
required subdirectories.
-As a side effect, this allows to build all programs 'on demand'. If, e.g.,
+As a side effect, this allows building all programs `on demand'. If, e.g.,
building in utils/Util/ or texk/Prog/ has been disabled, the Makefile in
that directory still contains all build rules. Thus running 'make' and
'make install' in that directory will build and install everything.
@@ -193,4 +194,3 @@ i.e., no programs and consequently no libraries are to be built. Running
nothing; similarly 'make install' will install nothing. Nevertheless next
running, e.g., 'make tex' in the subdirectory texk/web2c/ will build first
the Kpathsea library, then tangle, and finally tex.
-