diff options
| -rw-r--r-- | Build/source/README.coding | 18 | ||||
| -rw-r--r-- | Build/source/README.config | 26 | ||||
| -rw-r--r-- | Build/source/README.hacking | 4 | ||||
| -rw-r--r-- | Build/source/README.layout | 21 | ||||
| -rw-r--r-- | Build/source/texk/texlive/linked_scripts/ChangeLog | 4 | ||||
| -rw-r--r-- | Build/source/texk/texlive/linked_scripts/Makefile.am | 3 | ||||
| -rw-r--r-- | Build/source/texk/texlive/linked_scripts/Makefile.in | 3 |
7 files changed, 41 insertions, 38 deletions
diff --git a/Build/source/README.coding b/Build/source/README.coding index fe7edbd3209..e2254ef0bed 100644 --- a/Build/source/README.coding +++ b/Build/source/README.coding @@ -8,7 +8,7 @@ Ideally, building all of TL with '--enable-compiler-warnings=max' should produce no (gcc) compiler warnings at all. In spite of considerable efforts into that direction we are still far from that goal and there are reasons that we may never fully reach it. Below are some rules about declarations -(of functions and variables) and the use of const. These rules should be +(of functions and variables) and the use of `const'. These rules should be applied to all parts of the TL tree, except in some of those maintained independently. @@ -19,11 +19,11 @@ independently. ----------------------------------------------- The TL build system no longer supports pre-ANSI C compilers. Thus all functions prototypes and definitions must conform to the ANSI C standard -(including 'void' in the declaration of functions that take no parameters). +(including `void' in the declaration of functions that take no parameters). 1.2. Static ----------- -Functions used in only one file must be declared 'static'; no prototype is +Functions used in only one file must be declared `static'; no prototype is required except as forward declaration. 1.3. Extern @@ -32,7 +32,7 @@ Functions used in several files require (extern) prototypes to be provided by a header files. That header must be included in the file defining the function and in all files using that function -- this is the only way to guarantee consistency between definition and use of functions. No more -'extern's sprinkled throughout the C code (with or without comment where +`extern's sprinkled throughout the C code (with or without comment where that function is defined). 1.4. Variables @@ -47,23 +47,23 @@ exectly one file. 2.1. Function parameters ------------------------ Ideally, a function parameter not modified by the function should be -declared as const. This is important in particiular for strings ('char *') +declared as const. This is important in particiular for strings (`char *') because frequently string literals are used as actual arguments. Note, -however, that a 'char **' value is not assignment compatible with a 'const -char **' variable. Getting all 'const's right often is quite involved but +however, that a `char **' value is not assignment compatible with a `const +char **' variable. Getting all `const's right often is quite involved but usually can be done. There are, however, a few notable exceptions: the X11 headers are full of declarations that ought to use const but do not and the same is true to some extent for zlib. 2.2. What must be avoided ------------------------- -The compiler warnings 'assignment/initialization/passing arg/return discards +The compiler warnings `assignment/initialization/passing arg/return discards qualifiers...' must be avoided under all circumstances, except when caused by X11 headers/macros or third party code. 2.3. What should be avoided --------------------------- -A type cast, e.g., from 'const char *' to 'char *' doesn't solve any +A type cast, e.g., from `const char *' to `char *' doesn't solve any problems, depending on warning options it only may hide them. Therefore such casts should be avoided whenever possible but some such casts may be unavoidable. diff --git a/Build/source/README.config b/Build/source/README.config index f109e03b4ac..22a46bee3c5 100644 --- a/Build/source/README.config +++ b/Build/source/README.config @@ -22,6 +22,9 @@ with TeX Live invokes the top-level configure with a few additional options. Any defaults discussed below are those for the base configure script; thus, invoking configure via ./Build yields different results. +Defaults for most options are set at the top-level and then propagated +explicitly to all subdirectories. + Options specified on the command line will never be modified. @@ -40,8 +43,8 @@ disabled and system versions of most libraries would be used (see below). A related option '--enable-texlive-build' is automatically passed to all subdirectories (and can not be disabled). Programs that could also be built -independent from the TL tree (such as utils/xindy/ or texk/dvipng/) use this -option, e.g., to choose TL specific installation directories. +independently from the TL tree (such as utils/xindy/ or texk/dvipng/) can +use this option, e.g., to choose TL specific installation directories. 1.2. --enable-multiplatform --------------------------- @@ -76,11 +79,11 @@ Do not use the X Window System. 1.8. --enable-compiler-warnings=[no|min|yes|max|all] ---------------------------------------------------- -Enable various degrees of compiler warnings for C and C++. The default is -'yes' in maintainer-mode and 'min' otherwise. This options defines -additional CFLAGS, CXXFLAGS, OBJCFLAGS, and OBJCXXFLAGS but these flags are -not yet used by all library and program packages. Using these compiler -warnings should help to resolve portability problems. +Enable various degrees of compiler warnings for (Objective) C and C++. The +default is 'yes' in maintainer-mode and 'min' otherwise. This option +defines WARNING_[OBJ]C[XX]FLAGS but these flags are not yet used by all +library and program packages. Using them should help to resolve portability +problems. At the moment these warning flags are only defined for the GNU compilers but flags for other compilers could be added when needed. @@ -110,7 +113,7 @@ its requirement for clisp et al.). 2.3.1. --with-tex-banner=STR Specify the version string STR appended to banner lines, replacing the default `Web2C YYYY'; the string STR must contain the current Web2C -version, that is, the YYYY. +version, that is, the YYYY (currently 2009). The Build script for a TL native build currently specifies `--with-tex-banner="TeX Live 2009"', whereas a distro build should alter @@ -179,14 +182,13 @@ Non standard search locations for libgs. 3.1. --with-system-LIB ---------------------- Use an installed (system) version of the library `LIB'; this option exists -for most but not all libraries (not allowed for a TeX Live native build). +for most libraries (not allowed for a TeX Live native build). For many libraries there are in addition '--with-LIB-includes=DIR' and -'--with-LIB-libdir=DIR' to indicate that the library is installed in an -unusual location. +'--with-LIB-libdir=DIR' to indicate non standard search locations. The top-level configure script performs a consistency check for all -required system libraries and bails out early if one these tests fails. +required system libraries and bails out early if some these tests fail. 3.2. Configure options for libfontconfig ---------------------------------------- diff --git a/Build/source/README.hacking b/Build/source/README.hacking index ea13487aaa5..10df8b185c6 100644 --- a/Build/source/README.hacking +++ b/Build/source/README.hacking @@ -94,7 +94,7 @@ LIB_LIBS are constructed from values for the configure options '--with-Lib-includes' and/or '--with-Lib-libdir'; alternatively they may result from running pkg-config, freetype-config, or similar. -As example, the file libs/libpng/kpse/withenable.ac contains +As example, the file libs/libpng/ac/withenable.ac contains KPSE_WITH_LIB([libpng], [zlib]) where KPSE_WITH_LIB, defined in m4/kpse-setup.m4, has one required argument -- the name of the subdirectory -- and two optional arguments: a list of @@ -106,7 +106,7 @@ from the TL can be used). The file libs/libpng/ac/libpng.ac contains png_set_read_fn(png, io, fn);]) where KPSE_TRY_LIB, defined in m4/kpse-setup.m4, has three required arguments -- the name of the subdirectory and two AC_LANG_PROGRAM arguments. -This causes Autoconf to compile and link the program +This causes the configure script to compile and link the C program #include <png.h> int main () { png_structp png; png_voidp io; png_rw_ptr fn; diff --git a/Build/source/README.layout b/Build/source/README.layout index fd859820e7d..62a24fb6833 100644 --- a/Build/source/README.layout +++ b/Build/source/README.layout @@ -37,24 +37,24 @@ and/or integrating new modules into the TL build system. ------------------- texk/kpathsea/*/ the Kpathsea library -libs/*/*/ various other libraries +libs/*/ various other libraries -texk/*/*/ programs (mostly using Kpathsea) -utils/*/*/ utility programs (not using Kpathsea) +texk/*/ programs (mostly using Kpathsea) +utils/*/ utility programs (not using Kpathsea) texk/am/*.am Makefile.am fragments texk/web2c/am/*.am for the Kpathsea library texk/web2c/*/am/*.am and the Web2C programs -libs/Lib/*/ library Lib (zlib, libpng, t1lib, etc.) -texk/Prog/*/ program package Prog (web2c, afm2pl, bibtex8, etc.) -utils/Util/*/ utility program package Util (dialog, pdfopen, ps2eps, etc.) +libs/Lib/ library Lib (zlib, libpng, t1lib, etc.) +texk/Prog/ program package Prog (web2c, afm2pl, bibtex8, etc.) +utils/Util/ utility program package Util (dialog, pdfopen, ps2eps, etc.) auxdir/auxsub/ dummy module used to configure the real modules */*/ac/*.ac various configure.ac fragments (configure options) -build-aux/* auxiliary build scripts (config.guess etc.) +build-aux/ auxiliary build scripts (config.guess etc.) m4/kpse-pkgs.m4 Autoconf macros defining the lists of Lib, Prog, and Util modules and handling loops over these lists @@ -174,14 +174,13 @@ please keep it that way! The process described above configures all directories, even for libraries and programs not to be built. This is necessary for Make targets such as `dist' or `distcheck' that have to recurse into all subdirectories, whereas -thw normal targets `all', `check', or `install' only recurse into the +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., building in utils/Util/ or texk/Prog/ has been disabled, the Makefile in -that directory still contains all the rules to build everything. Thus -running 'make' and 'make install' in that directory will build and install -everything. +that directory still contains all build rules. Thus running 'make' and +'make install' in that directory will build and install everything. Similarly, when, e.g., building e-TeX has been disabled (as by default), you can run 'make etex' (or 'make etex.exe') in the subdirectory texk/web2c/ to diff --git a/Build/source/texk/texlive/linked_scripts/ChangeLog b/Build/source/texk/texlive/linked_scripts/ChangeLog index f63ae74736f..74232f61e5e 100644 --- a/Build/source/texk/texlive/linked_scripts/ChangeLog +++ b/Build/source/texk/texlive/linked_scripts/ChangeLog @@ -1,3 +1,7 @@ +2009-11-26 Peter Breitenlohner <peb@mppmu.mpg.de> + + * Makefile.am (bin_links): Remove getnonfreefonts-sys. + 2009-11-25 Karl Berry <karl@tug.org> * Makefile.am (nobase_dist_scriptx_SCRIPTS): remove getnonfreefonts. diff --git a/Build/source/texk/texlive/linked_scripts/Makefile.am b/Build/source/texk/texlive/linked_scripts/Makefile.am index c5b76005857..d611ec90cb6 100644 --- a/Build/source/texk/texlive/linked_scripts/Makefile.am +++ b/Build/source/texk/texlive/linked_scripts/Makefile.am @@ -93,8 +93,7 @@ nobase_dist_script_SCRIPTS = \ # Symlinks within $(bindir): FILE:LINK indicates LINK->FILE bin_links = \ epstopdf:repstopdf \ - pdfcrop:rpdfcrop \ - getnonfreefonts:getnonfreefonts-sys + pdfcrop:rpdfcrop # The idea is to install the scripts themselves in texmf*/scripts, and # have bin/arch/foo be a symlink to, say, diff --git a/Build/source/texk/texlive/linked_scripts/Makefile.in b/Build/source/texk/texlive/linked_scripts/Makefile.in index 1c7be54bdc7..feb56d2fb38 100644 --- a/Build/source/texk/texlive/linked_scripts/Makefile.in +++ b/Build/source/texk/texlive/linked_scripts/Makefile.in @@ -243,8 +243,7 @@ nobase_dist_script_SCRIPTS = \ # Symlinks within $(bindir): FILE:LINK indicates LINK->FILE bin_links = \ epstopdf:repstopdf \ - pdfcrop:rpdfcrop \ - getnonfreefonts:getnonfreefonts-sys + pdfcrop:rpdfcrop all: all-am |