summaryrefslogtreecommitdiff
path: root/Build/source/README.hacking
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2010-04-23 08:44:57 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2010-04-23 08:44:57 +0000
commit6c83b2609bba73ed2fb8bf4e11eee8522ff173bb (patch)
tree42b49d2fd731d024dd723e750d2fe3b5db0d8d17 /Build/source/README.hacking
parent4e413d1cf45e3573d4eff85693ef8d59ea9a2fac (diff)
build system
git-svn-id: svn://tug.org/texlive/trunk@17972 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.hacking')
-rw-r--r--Build/source/README.hacking48
1 files changed, 31 insertions, 17 deletions
diff --git a/Build/source/README.hacking b/Build/source/README.hacking
index fba4e12a413..51e0bfd773b 100644
--- a/Build/source/README.hacking
+++ b/Build/source/README.hacking
@@ -45,17 +45,17 @@ similar places that might need updating (not done automatically by the
----------------------------------
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 and texk/Prog/configure.ac or
+texk/Prog/ (possibly using Kpathsea and Ptexenc) 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 and texk/Prog/configure.ac or
utils/Util/ac/withenable.ac and utils/Util/configure.ac) as, e.g., for
texk/web2c/, texk/xdvik/, and utils/xindy/.
@@ -69,13 +69,13 @@ by default, 'native' if cross compilation is not possible), and a comment
added to the help text for the disable or enable configure option for this
program.
-3.2 Adding a new library directory
-----------------------------------
+3.2 Adding a new generic 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)
+To add a new generic 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 should specify a small program as
test for a system version to be acceptable. Finally you must create a file
@@ -115,6 +115,20 @@ This causes the configure script to compile and link the C program
as sanity check for using an installed PNG library. The analogous macro
KPSE_TRY_LIBXX uses the C++ compiler.
+3.3 Adding a new TeX specific library directory
+-----------------------------------------------
+
+To add a new TeX specific library directory texk/Lib/ proceed as for a
+generic library (described above) with these exceptions:
+
+(*) Add the directory Lib to the M4 list kpse_texlibs_pkgs (also defined in
+m4/kpse-pkgs.m4) instead of kpse_libs_pkgs.
+
+(*) The configure.ac fragment libs/Lib/ac/witheanble.ac must use
+KPSE_WITH_TEXLIB instead of KPSE_WITH_LIB.
+
+(*) The new library must not depend on any generic libraries.
+
4. Using libraries from the TL tree
===================================