source/README

   1 $Id: README 39724 2016-02-15 19:00:21Z karl $
   2 Public domain.  Originally written 2005 by Karl Berry.
   3
   4 For a high-level overview of building TeX Live, see
   5 http://tug.org/texlive/build.html.  In brief:
   6
   7 To configure and make the source tree, run ./Build.
   8 To build (mostly) without optimization, run ./Build --debug.
   9 To make without configuring, run TL_CONFIGURE=true ./Build.
  10 Email tlbuild@tug.org if problems.
  11
  12 (Nearly everything the Build script does can be overridden via
  13 environment variables; just take a look to see the names.)
  14
  15 Many more details about the TL build system, such as configuring to work
  16 on a single program, adding new programs or libraries, recompiling after
  17 fixing problems, etc., are in the doc/tlbuild* document and the sibling
  18 README* files here (which are generated from that document).
  19
  20 \f
  21 Build information for some of the platforms.
  22
  23 i386-linux: gcc 4.9.2, Linux 2.6.18-* (CentOS 5.10, tug.org:~karl/bin/mybuild)
  24   Except for dvisvgm, where we must use the system compiler (gcc 4.1.2,
  25   Red Hat 4.1.2-54) or libgs.so crashes trying to use gcc 4.8.2's
  26   libstdc++.  On the other hand, the system compiler has an optimization
  27   bug that causes lcdf-typetools's tfm.test to fail, so it can't be used
  28   for everything.  Sigh.
  29
  30 x86_64-linux: gcc 4.8.2, libc 2.3.6, Linux 2.6.28.6
  31
  32 amd64-netbsd:
  33   gcc version 4.5.3 (NetBSD nb2 20110806)
  34   NetBSD/amd64 6.1.3
  35   TL_MAKE=gmake LDFLAGS='-L/usr/X11R7/lib -Wl,-rpath,/usr/X11R7/lib' ./Build
  36
  37 *-kfreebsd:  the builder says ...
  38   I do not have any native kfreebsd systems. The best way to build is
  39   to run a clean kfreebsd "userland" within a jail.  I am running Debian
  40   "stable" kfreebsd userland under a freebsd 10.0 real system. Thus, I
  41   produced 32bit i386-kfreebsd binaries above ("./Build").
  42
  43   I also tried, but am planning on dropping, running Debian "stable"
  44   kfreebsd installed on a virtual machine via VirtualBox. Thus, I
  45   produced 64bit amd64-kfreebsd binaries above.
  46
  47   I tested that the freebsd binaries will *not* run on a kfreebsd
  48   "userland" and the kfreebsd binaries will *not* run on a freebsd
  49   "userland". Whereas I would have thought them to be somewhat
  50   interchangeable, they are linked to libraries (ELF interpreter ld.so.1)
  51   and maybe others) that are to be found in different locations on the
  52   different systems.
  53
  54 i386-solaris, x86_64-solaris: Solaris 10.  See doc/README.solaris.
  55
  56 i386-cygwin, x86_64-cygwin: gcc-4.8.2, cygwin-1.7.29.
  57   ./Build (with --enable-xindy for i386).
  58
  59 powerpc-linux (Debian Squeeze)
  60   Linux homer 2.6.32-5-powerpc64 #1 SMP Tue Mar 8 02:01:42 UTC 2011
  61   ppc64 Debian GNU/Linux 6.0
  62   (only the kernel is 64bit, the entire userland is 32bit)
  63
  64 sparc-solaris: Solaris 10, gcc.  See doc/README.solaris.
  65
  66 universal-darwin, x86_64-darwin: a menagerie of versions.
  67   See Master/source/mactexdoc.tar.xz.