$Id$ Public domain. Originally written 2005 by Karl Berry. For a high-level overview of building TeX Live, see http://tug.org/texlive/build.html. In brief: To configure and make the source tree, run ./Build. To build (mostly) without optimization, run ./Build --debug. To make without configuring, run TL_CONFIGURE=true ./Build. (Nearly everything the Build script does can be overridden via environment variables; just take a look to see all the names.) Prerequisites: - GNU make. If your GNU make is invoked by some name other than `make', try setting the envvar TL_MAKE to what is needed. - GNU clisp and GNU libffcall, for xindy. See more details in utils/README. (Alternative: Build --disable-xindy.) - X11 headers and libraries (often a ``development'' package, not installed by default), for pdfopen and xdvi. (Alternative: Build --without-x.) - libfontconfig (again both headers and library), for XeTeX and xdvipdfmx, except on MacOSX. (Alternative: Build --disable-xetex --disable-xdvipdfmx.) - If you modify any .y or .l source files, then Bison and Flex (or maybe equivalents) are needed. The distributed .c and .h files are generated with bison-2.4.3 and flex-2.5.35. The binaries will be left in ./inst/bin/. For TeX Live, ignore the other files and directories that end up in ./inst. The new binaries are not directly usable from that location. Instead, copy them to Master/bin//. That should be it for normal builds. Email tex-live@tug.org if problems. To make a usable TeX installation, you have to have (thousands of) support files as well as the binaries that are built here. The support files are maintained completely independently. The best basis for dealing with them is the TeX Live (plain text) database, Master/tlpkg/texlive.tlpdb, and/or our installer. More information is under Master/tlpkg. See also http://tug.org/texlive/distro.html. If your C++ needs to find the standard library in, say, /usr/local/lib, (i.e., configure fails saying the compiler doesn't work), try: env LD_OPTIONS=-R/usr/local/lib ./Build Many more details about the TL build system, such as adding new programs or libraries, recompiling after fixing problems, etc., are in the other README.* files here. Build information: In general, xe(la)tex and xdvipdfmx depend on fontconfig. We cannot statically link it because it varies on different systems. i386-linux: Debian sarge, gcc 3.3.5, libc 2.3.2, Linux 2.6.9-67.0.4.ELsmp chroot /home/texlive/sarge; Build --with-xindy --with-clisp=... x86_64-linux: gcc 3.4.6, libc 2.3.6, Linux 2.6.28.6 universal-darwin, x86_64-darwin: a menagerie of versions. See Master/source/mactexdoc.tar.xz. i386-solaris, x86_64-solaris: Solaris 11. powerpc-linux (Debian Squeeze) Linux homer 2.6.32-5-powerpc64 #1 SMP Tue Mar 8 02:01:42 UTC 2011 ppc64 Debian GNU/Linux 6.0 (only the kernel is 64bit, the entire userland is 32bit.) sparc-solaris OS: Sun Solaris 8 compiler: Sun Studio 11 bison (GNU Bison) 2.3 flex version 2.5.4 GNU m4 1.4.5 GNU Make 3.81 Because Solaris 8 does not include fontconfig, we used fontconfig package (version 2.3.2) from http://www.blastwave.org/ (together with its dependencies) sparc-linux (utah) kernel: 2.4.28-sparc-r1 /lib/libc-2.3.3.so gcc version 3.3.4 20040623 (Gentoo Linux 3.3.4-r1, ssp-3.3.2-2, pie-8.7.6) make 3.81 powerpc-aix OS: AIX 4.3 compiler: IBM C for AIX Compiler, Version 5 (xlc) bison (GNU Bison) 1.34 flex version 2.5.4 GNU m4 1.4 GNU Make 3.79.1 You can download fontconfig for AIX from http://www-03.ibm.com/servers/aix/products/aixos/linux/download.html ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/fontconfig/ alpha-linux OS: Debian GNU/Linux 4.0 (Etch), kernel 2.6.18 gcc (GCCC) 4.1.2 20061115 (prerelease) (Debian 4.1.1-21) bison (GNU Bison) 2.3 flex 2.5.33 GNU M4 1.4.8 GNU Make 3.81 - you have to set the ulimit high enough before compiling clisp and texlive ulimit -s 16384 did suffice for me - compiling of texk/web2c/pdftexdir/writezip.c is broken and triggers a compiler error with the above gcc. Disabling optimization -O2 using Build --debug ... resolved this problem. - compilation of clisp needs --disable-mmap - asy compilation with --disable-gsl && make