diff options
author | Karl Berry <karl@freefriends.org> | 2021-02-25 19:22:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-02-25 19:22:25 +0000 |
commit | ad547a6b5986815fda458221149728d9d9ab1d87 (patch) | |
tree | 16296910eb3eca724371474ea9aea3994dc69614 /Build/source/README.1prerequisites | |
parent | 947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff) |
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.1prerequisites')
-rw-r--r-- | Build/source/README.1prerequisites | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/Build/source/README.1prerequisites b/Build/source/README.1prerequisites new file mode 100644 index 00000000000..443a4826ecc --- /dev/null +++ b/Build/source/README.1prerequisites @@ -0,0 +1,65 @@ +(This file was generated by makeinfo and splitinfo.gawk.) +(Released under the old-style GNU documentation license; + see sources or other output files for full text.) + +3 Prerequisites +*************** + +Overall, building the TeX Live programs, when using all libraries from +the TL source tree, requires C and C++11 compilers and GNU 'make'. If +'make' from your 'PATH' is not GNU make, you can set the 'MAKE' +environment variable to whatever is necessary. + + GNU 'make' is required only because of some third-party libraries, +notably FreeType; all the TL-maintained directories (and +Automake/Autoconf output in general) work with any reasonable 'make'. + + A C++11 compiler is similarly required because of the third-party +libraries ICU and Poppler; the program 'dvisvgm' also requires C++11. +It is possible to build everything else with older compilers, but you +have to remove the C++11-dependent sources. *Note Build one package::. + + A few programs in the tree have additional requirements: + +'web2c' + requires 'perl' for some tests run by 'make check'. + +'xdvik' +'xpdfopen' + require X11 headers and libraries, typically in "development" + packages that are not installed by default. + +'xetex' + requires 'fontconfig' (again both headers and library), or, for + MacOSX only, the 'ApplicationServices' and 'Cocoa' frameworks. + +'xindy' + requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally, + to build the rules and/or documentation: 'perl', 'latex', + 'pdflatex'. + +Lacking the required tools, building these programs must avoided, e.g., +'configure --without-x --disable-xetex --disable-xindy' + + Modifying source files induces more requirements, as one might +expect: + + * Modification of any '.y' or '.l' source files requires 'bison' or + 'flex' to update the corresponding C sources. + + * Modification of the sources for '.info' files requires 'makeinfo'. + + * Modification of any part of the build system (M4 macros, + 'configure.ac', 'Makefile.am', or their fragments) requires GNU M4, + GNU Autoconf, GNU Automake, and GNU Libtool to update the generated + files. Furthermore, to reliably reproduce the build files, the + original GNU releases of these tools must be used, not any distro + packaging of them. *Note Build system tools::, for more + discussion. + + If you haven't modified any source files, and infrastructure tools +such as 'autoconf' or 'makeinfo' are still being run, check your +timestamps--notably, 'use-commit-times' must be set to 'yes' in your +Subversion configuration (*note Build system tools::). Barring buggy +commits, no infrastructure tools are needed to do a normal build. + |