From bfbd87a0b6c0a2f58a463749e7502f780aaec362 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 29 Aug 2011 18:58:31 +0000 Subject: typos, etc. git-svn-id: svn://tug.org/texlive/trunk@23748 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/README.layout | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) (limited to 'Build/source/README.layout') 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 +Copyright (C) 2009-2011 Peter Breitenlohner 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. - -- cgit v1.2.3