source/README.1prerequisites

   1 (This file was generated by makeinfo and splitinfo.gawk.)
   2 (Released under the old-style GNU documentation license;
   3  see sources or other output files for full text.)
   4
   5 3 Prerequisites
   6 ***************
   7
   8 Overall, building the TeX Live programs, when using all libraries from
   9 the TL source tree, requires only C and C++ compilers and GNU 'make'.
  10 (If 'make' from your 'PATH' is not GNU make, you can set 'MAKE' in the
  11 environment to whatever is necessary.)
  12
  13    Indeed, GNU 'make' is required only because of some third-party
  14 libraries, notably FreeType; all the TL-maintained directories (and
  15 Automake/Autoconf output in general) should work with any reasonable
  16 'make'.
  17
  18    However, a few programs in the tree have additional requirements:
  19
  20 'web2c'
  21      requires 'perl' for some tests run by 'make check'.
  22
  23 'xdvik'
  24 'xpdfopen'
  25      require X11 headers and libraries, often in "development" packages
  26      that are not installed by default.
  27
  28 'xetex'
  29      requires 'fontconfig' (again both headers and library), or, for
  30      MacOSX only, the 'ApplicationServices' and 'Cocoa' frameworks.
  31
  32 'xindy'
  33      requires GNU 'clisp' and in addition 'perl', 'latex', and
  34      'pdflatex' to build the rules and/or documentation.
  35
  36 Lacking the required tools, building these programs must avoided, e.g.,
  37 'configure --without-x --disable-xetex --disable-xindy'
  38
  39    Modifying source files induces more requirements, as one might
  40 expect:
  41
  42    * Modification of any '.y' or '.l' source files requires 'bison' or
  43      'flex' to updatete the corresponding C sources.
  44
  45    * Modification of the sources for '.info' files requires 'makeinfo'.
  46
  47    * Modification of any part of the build system (M4 macros,
  48      'configure.ac', 'Makefile.am', or their fragments) requires GNU M4,
  49      GNU Autoconf, GNU Automake, and GNU Libtool to update the generated
  50      files.  *Note Build system tools::.
  51
  52    If you haven't modified any source files, and infrastructure tools
  53 such as 'autoconf' or 'makeinfo' are still being run, check your
  54 timestamps--notably, 'use-commit-times' must be set to 'yes' in your
  55 Subversion configuration (*note Build system tools::).  Barring buggy
  56 commits, no infrastructure tools are needed to do a normal build.
  57
  58    As an example, on Debian systems the necessary build dependencies can
  59 be installed via:
  60
  61      apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
  62