summaryrefslogtreecommitdiff
path: root/Build/source/README
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2009-04-09 09:33:51 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2009-04-09 09:33:51 +0000
commit21d240050faa7df5eab530fa9c2cf27f5f51b14c (patch)
tree12d7460d369a8abc5b90c622c55d46855ba62528 /Build/source/README
parent4263f4f2a148dba13389cfad2fe2af63a1fc4422 (diff)
update build system
git-svn-id: svn://tug.org/texlive/trunk@12677 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README')
-rw-r--r--Build/source/README125
1 files changed, 125 insertions, 0 deletions
diff --git a/Build/source/README b/Build/source/README
new file mode 100644
index 00000000000..1d05986a26a
--- /dev/null
+++ b/Build/source/README
@@ -0,0 +1,125 @@
+$Id$
+Copyright 2004, 2006, 2007, 2008, 2009 TeX Users Group.
+You may freely use, modify and/or distribute this file.
+
+For a high-level overview of building TeX Live, see
+http://tug.org/texlive/build.html.
+
+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, must be present for xindy. See more
+ details in utils/README. (Alternative: Build --without-xindy.)
+
+- libfontconfig (again both headers and library) must be present for
+ XeTeX, except on MacOSX. (Alternative: Build --without-xetex.)
+
+- X11 headers and libraries must be present for pdfopen and xdvi.
+
+- Bison and Flex (or maybe equivalents) are needed for web2c.
+
+The binaries will be left in ./inst/bin/<stdplatform>.
+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/<tlplatformname>/.
+
+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.
+
+For unusual situations:
+
+- 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
+
+- Running ./reautoconf here reruns autoconf as needed. Use --help for more.
+
+
+Build information:
+ amd64-freebsd: built on Freebsd 7.0-RELEASE amd64,
+ --with-fontconfig=/usr/local
+
+ hppa-hpux: built on HP-UX 10.20, gcc 3.3.4
+ --with-fontconfig=/u/tiarno/fc --without-graphite --without-luatex
+
+ i386-darwin: MacOSX 10.4 with support for 10.3, 10.4, and 10.5
+
+ 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=...
+
+ i386-solaris: Solaris 10 11/06 s10x_u3wos_10 X86
+ system gcc (GCC) 3.4.3 (csl-sol210-3_4-branch+sol_rpath)
+
+ powerpc-darwin: like i386-darwin
+
+ powerpc-linux
+OS: gentoo GNU/Linux
+kernel 2.6.23
+gcc (GCC) 4.2.3 (Gentoo 4.2.3 p1.0)))
+bison (GNU Bison) 2.3)
+flex 2.5.35
+m4 (GNU M4) 1.4.11)
+GNU Make 3.81
+
+ 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
+ xe(la)tex and xdvipdfmx depend on fontconfig.
+ Because Solaris 8 does not include fontconfig, we used fontconfig
+ package (version 2.3.2) from http://www.blastwave.org/
+ (together with it's dependencies)
+
+ sparc-linux
+OS: Debian GNU/Linux 3.1 (Sarge), kernel 2.4.27-2-sparc64
+gcc (GCC) 3.3.5 (Debian 1:3.3.5-13)
+bison (GNU Bison) 1.875d
+flex 2.5.31
+GNU m4 1.4.2
+GNU Make 3.80
+
+ 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
+ xe(la)tex and xdvipdfmx depend on fontconfig.
+ 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.4.34.6
+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
+ Remarks:
+ - 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.
+