diff options
author | Peter Breitenlohner <peb@mppmu.mpg.de> | 2009-08-07 09:41:57 +0000 |
---|---|---|
committer | Peter Breitenlohner <peb@mppmu.mpg.de> | 2009-08-07 09:41:57 +0000 |
commit | 2637b1cad34ea6c102f43a466c3124443a6f20d1 (patch) | |
tree | 13321e48fd4f504696629c3d061bb8abcedc684a /Build/source/README.layout | |
parent | 24640f3fa48e8a501713e983b7366d94ab568e39 (diff) |
build system: minor update
git-svn-id: svn://tug.org/texlive/trunk@14571 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.layout')
-rw-r--r-- | Build/source/README.layout | 65 |
1 files changed, 0 insertions, 65 deletions
diff --git a/Build/source/README.layout b/Build/source/README.layout index 590911f48dc..586c46e9eb8 100644 --- a/Build/source/README.layout +++ b/Build/source/README.layout @@ -174,68 +174,3 @@ 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 build e-TeX (although there is no simple way to have e-TeX installed). -4. Extending the TL build system -================================ - -4.1 Adding a new program directory ----------------------------------- - -To add a new program directory utils/Util/ (not using Kpathsea) or -texk/Prog/ (possibly using Kpathsea) you must add the directory Util to the -M4 list kpse_utils_pkgs or Prog to the M4 list kpse_texk_pkgs defined in -m4/kpse-pkgs.m4. In addition you must create a configure.ac fragment -utils/Util/ac/witheanble.ac or texk/Prog/ac/witheanble.ac defining any -required libraries from the TL tree and whether this new program is to be -built by default (in the absence of the corresponding '--enable-Util/Prog' -or '--disable-Util/Prog' configure options). If a program in texk/Prog/ or -utils/Util/ requires specific configure options to be seen at the top-level, -they should be defined in an additional configure.ac fragment -texk/Prog/ac/Prog.ac or utils/Util/ac/Util.ac (included from -texk/Prog/ac/withenable.ac or utils/Util/ac/withenable.ac and -texk/Prog/configure.ac (as, e.g., for texk/web2c/, texk/xdvik/, and -utils/xindy/). - -4.2 Adding a new library directory ----------------------------------- - -To add a new library directory libs/Lib/ you must add the directory Lib to -the M4 list kpse_libs_pkgs defined in m4/kpse-pkgs.m4. In addition you must -create a configure.ac fragment libs/Lib/ac/witheanble.ac defining any -required libraries from the TL tree and whether an installed (system) -version of this library can be used. If that is the case, another -configure.ac fragment libs/Lib/ac/Lib.ac must define (AC_CHECK_FUNCS and -AC_CHECK_HEADERS) tests for a system version to be acceptable. Finally you -must create a file m4/kpse-Lib-flags.m4 defining the M4 macro KPSE_LIB_FLAGS -(where 'LIB' is a sanitized uppercase version of 'Lib') setting up the Make -variables LIB_INCLUDES, LIB_LIBS, and LIB_DEPEND with the required values -for CPPFLAGS, LDADD, and dependencies, as well as LIB_RULE with a -(multiline) Make rule to rebuild that library when necessary. - -If a system version of the library can be used, another M4 macro -KPSE_LIB_SYSTEM_FLAGS in m4/kpse-Lib-flags.m4 must define values for -LIB_INCLUDES and LIB_LIBS, usually depending on values for the configure -options '--with-Lib-includes' and/or '--with-Lib-libdir', and you must add -the line 'AC_REQUIRE([KPSE_LIB_SYSTEM_FLAGS])' to the definition of the M4 -macro KPSE_ALL_SYSTEM_FLAGS in m4/kpse-pkgs.m4. - -5. Updating the TL build system -=============================== - -When anything in the TL build system (configure.ac and Makefile.am files -with their fragments or M4 macros in m4/) has been modified you have to -rebuild the coresponding configure, Makefile.in, and config.h or c-auto,h -files. - -This is most easily done automatically using maintainer-mode. The files in -the SVN repository are all up to date, but some of them may be rebuilt in -maintainer-mode due to their relative timestamps. This will eventually be -fixed, once everything has stabilized. - -Alternatively, you can run the 'reautoconf' script from the top-level. - -The 'config.guess', 'config.sub', etc. files for most packages are kept -centrally in build-aux/. There are, however, independent copies in, e.g., -libs/freetype/freetype-1.5/, libs/freetype2/freetype-2.3.8/builds/unix/, and -similar places that might need updating (not done automatically by the -'reautoconf' script). - |