source/m4/README

   1 Copyright (C) 2009-2012 Peter Breitenlohner <tex-live@tug.org>
   2 You may freely use, modify and/or distribute this file.
   3
   4 This directory is the central repository for Autoconf macros needed to build
   5 the TeX Live (TL) tree.
   6
   7 (1) Public macros such as libtool.m4 used to build the libraries and
   8 programs in the TL subdirectories libs/*/, utils/*/, and texk/*/ that are
   9 owned by the TL tree, i.e., either not maintained independently or with a
  10 proxy Makefile.am using an (almost) unmodified source tree and bypassing the
  11 original build system.
  12
  13 Note: the files libtool.m4 and ../build-aux/ltmain.sh must match.
  14
  15 (2) `Public' macros for the TL build system and for the TL libraries in the
  16 subdirectories libs/*/, texk/kpathsea/, and texk/ptexenc/, used to configure
  17 programs and other libraries requiring these TL libraries.  The macros are
  18 designed with the aim that programs maintained independently can be built as
  19 part of the TL tree or without TL (using installed versions of the required
  20 libraries), ideally using the same unmodified sources.
  21
  22 (3) `Private' macros for the TL infrastructure, only used in directories
  23 owned by the TL tree.
  24
  25 kpse-pkgs.m4: defines lists of subdirectories libs/Lib/, utils/Util/, and
  26         tex/Prog/ with libraries and programs that can be built as part of
  27         the TL tree.
  28 kpse-setup.m4: macros that walk through these lists to provide configure
  29         options.  They depend on configure fragments */*/ac/withenable.ac
  30         defining the dependencies between these libraries and programs.
  31