sync with experimental
[luatex.git] / source / README.1prerequisites
blobe118df5357589f8cae3e05fd15b190927c764425
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.)
5 3 Prerequisites
6 ***************
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.)
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'.
18    However, a few programs in the tree have additional requirements:
20 'web2c'
21      requires 'perl' for some tests run by 'make check'.
23 'xdvik'
24 'xpdfopen'
25      require X11 headers and libraries, often in "development" packages
26      that are not installed by default.
28 'xetex'
29      requires 'fontconfig' (again both headers and library).
31 'xindy'
32      requires GNU 'clisp' and in addition 'perl', 'latex', and
33      'pdflatex' to build the rules and/or documentation.
35 Lacking the required tools, building these programs must avoided, e.g.,
36 'configure --without-x --disable-xetex --disable-xindy'
38    Modifying source files induces more requirements, as one might
39 expect:
41    * Modification of any '.y' or '.l' source files requires 'bison' or
42      'flex' to updatete the corresponding C sources.
44    * Modification of the sources for '.info' files requires 'makeinfo'.
46    * Modification of any part of the build system (M4 macros,
47      'configure.ac', 'Makefile.am', or their fragments) requires GNU M4,
48      GNU Autoconf, GNU Automake, and GNU Libtool to update the generated
49      files.  *Note Build system tools::.
51    If you haven't modified any source files, and infrastructure tools
52 such as 'autoconf' or 'makeinfo' are still being run, check your
53 timestamps--notably, 'use-commit-times' must be set to 'yes' in your
54 Subversion configuration (*note Build system tools::).  Barring buggy
55 commits, no infrastructure tools are needed to do a normal build.