summaryrefslogtreecommitdiff
path: root/Build/source/README.1prerequisites
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-04-21 22:45:37 +0000
committerKarl Berry <karl@freefriends.org>2014-04-21 22:45:37 +0000
commitea58320b10f549a61236be100fc97925aea6b489 (patch)
tree595b52817d7543a14e0e38883508a27b7534120c /Build/source/README.1prerequisites
parentd67cd9824523dc725b1cdf9229c38dfa69812e65 (diff)
rename and update README* files, now generated from tlbuild.texi
git-svn-id: svn://tug.org/texlive/trunk@33605 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.1prerequisites')
-rw-r--r--Build/source/README.1prerequisites56
1 files changed, 56 insertions, 0 deletions
diff --git a/Build/source/README.1prerequisites b/Build/source/README.1prerequisites
new file mode 100644
index 00000000000..d82f64f7700
--- /dev/null
+++ b/Build/source/README.1prerequisites
@@ -0,0 +1,56 @@
+(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 only C and C++ compilers and GNU 'make'.
+(If 'make' from your 'PATH' is not GNU make, you can set 'MAKE' in the
+environment to whatever is necessary.)
+
+ Indeed, GNU 'make' is required only because of some third-party
+libraries, notably FreeType; all the TL-maintained directories (and
+Automake/Autoconf output in general) should work with any reasonable
+'make'.
+
+ However, a few programs in the tree have additional requirements:
+
+'biber'
+ requires 'perl' for autodetection of the TL platform name.
+
+'xdvik'
+'xpdfopen'
+ require X11 headers and libraries, often in "development" packages
+ that are not installed by default.
+
+'xetex'
+ requires 'fontconfig' (again both headers and library).
+
+'xindy'
+ requires GNU 'clisp' and 'libffcall', and in addition 'perl',
+ 'latex', and 'pdflatex' to build the rules and/or documentation.
+
+Lacking the required tools, building these programs must avoided, e.g.,
+'configure --disable-biber --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 updatete 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. *Note Build system tools::.
+
+ 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.
+