summaryrefslogtreecommitdiff
path: root/Build/source/README
blob: 6ff0ce9622776f50de07c6338f3d8a7805fd32fb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
$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.

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


More details and random notes:

Running ./reautoconf here reruns autoconf as needed.  Use --help for more.

Automadness:
should be oldest > newest in this order (often used alternate names
in parentheses):
    Makefile.am  >  configure.ac (configure.in)
    Makefile.in  >  config.h.in (config.hin)      > configure
        
To rerun dvipdfmx:
  until integration, insert our configure.in, data/Makefile.am,
    src/Makefile.am changes, copy compile script.
  aclocal; autoheader; automake; autoconf
  touch config.h.in; sleep 1; touch Makefile.in  # shouldn't be needed, but ...


Build information:
  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: i686-apple-darwin8.1.0 built by Gerben Wierda, from
    http://bloch.ling.yale.edu/i-packages/experimental/tex.ii2/tex.30.tar.bz2

  powerpc-darwin: powerpc-apple-darwin6.8 built by Gerben Wierda, from
    http://bloch.ling.yale.edu/i-packages/experimental/tex.ii2/tex.26.tar.bz2

  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.