$Id$
Copyright 2004, 2006, 2007, 2008 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.)

- A terminal library such as ncurses (both headers and library, e.g, a
  "development" package) must be present for Texinfo.
  (Alternative: Build --without-texinfo.)

- 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 HPux10.20, gcc 3.3.4, 
    --with-fontconfig=/u/tiarno/fc
  
  i386-linux: Debian sarge, gcc 3.3.5, libc 2.3.2, Linux 2.6.9-67.0.4.ELsmp
    chroot /home/texlive/sarge && cd /tmp/source && Build
    
  i386-darwin: MacOSX 10.4 with support for 10.3, 10.4, and 10.5

  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
  
  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.