summaryrefslogtreecommitdiff
path: root/Build/source/README.config
blob: 8411f138304308df244bda3a82d04e8fd32d30f5 (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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
Copyright (C) 2009 Peter Breitenlohner <tex-live@tug.org>
You may freely use, modify and/or distribute this file.

	Configure options for the  TeX Live (TL) build system
	=====================================================

The TL 2009 build system contains a collection of program packages, i.e.,
subdirectories texk/Prog/ (where `Prog' is web2c, afm2pl, bibtex8, etc.) and
utils/Util/ (where `Util' is dialog, pdfopen, etc.) as well as library
packages, i.e., subdirectories texk/kpathsea/ and libs/Lib/ (where `Lib' is
zlib, libpng, t1lib, etc.) for most of the libraries required by the program
packages.  Correspondingly there are plenty of configure options, most of
them described below.  See 'configure --help' (at the top-level) for an
exhaustive list of all global options and a few important package specific
ones or run, e.g., 'texk/lcdf-typetools/configure --help' to also see
lcdf-typetools specific options not shown at the top-level.

Note, however, that the ./Build script invokes the top-level configure with
a few additional options.  Any defaults discussed below are those for the
configure script, invoking configure from ./Build yields different results. 
Options explicitly specified on the command will never be modified.

1. Global configure options
===========================

1.1. --disable-native-texlive-build
-----------------------------------

If enabled (by default) build for a TeX Live binary distribution such as
the TL2009 DVD-Rom; this implies '--enable-multiplatform' and
'--enable-cxx-runtime-hack' unless they are explicitly disabled.

Building TL for a Linux or other distribution, this would be disabled and
system versions of most libraries would be used (see below).

1.2. --enable-multiplatform
---------------------------

If enabled, install executables and libraries in platform dependent
subdirectories of EPREFIX/bin and EPREFIX/lib (unless '--bindir=DIR' or
'--libdir=DIR' is specified).  This option automatically propagates the
values for bindir and libdir to all subdirectories to be configured, and
thus need not be used explicitly in any program or library package.

1.3. --enable-cxx-runtime-hack
------------------------------

If enabled and when using gcc, try to statically link with libstc++,
somewhat improving portability.

1.4. --disable-largefile
------------------------

Omit support for large files (>=2GB).

1.5. --without-x
----------------

Do not use the X Window System.

2. Configure options for program packages
=========================================

2.1. --disable-Prog and --disable-Util
--------------------------------------

Do not build and install the program(s) of the package `Prog' or `Util'.

2.2. --disable-all-pkgs
-----------------------

Do not build any program packages, except those explicitly enabled.  Without
this options all packages are built except those explicitly disabled (except
for utils/xindy/ which is disabled by default due to its requirement for
clisp and others).

2.3. Configure options for texk/web2c/
--------------------------------------

2.3.1. --enable-auto-core

This option causes TeX & MF to produce a core dump when a particular
filename is encountered.

2.3.2. --disable-dump-share

Make the fmt/base/mem dump files architecture dependend (somewhat faster
on little-endian architectures).

2.3.3. --enable-ipc

If enabled (by default) allow TeX's '--ipc' option.

2.3.4. --disable-tex, --enable-etex, --disable-aleph, --disable-pdftex,
       --disable-luatex, --disable-xetex, --disable-mf, --disable-mp

Do or do not build the various TeX, METAFONT, and MetaPost engines.

2.3.5. --with-mf-x-toolkit

Use the X toolkit (libXt) for METAFONT (default is yes).

2.3.6. --enable-*win

Include various types of window support for METAFONT.

2.3.7. --disable-mf-nowin

Do not build a separate non-windows-capable METAFONT.

2.3.8. --disable-web-progs

Do not build the WEB programs bibtex ... weave, e.g., when you just have to
rebuid some engines.

2.4. Configure options for texk/xdvik/
--------------------------------------

2.4.1. --with-gs=PATH

Hardwire the location of GhostScript (gs).

2.4.2. --with-xdvi-x-toolkit=KIT

Use toolkit KIT (motif/xaw/xaw3d/neXtaw) for xdvi, default: Motif if
available, else Xaw.

3. Configure options for libraries
==================================

3.1. --with-system-Lib
----------------------

Use an installed (system) version of the library `Lib'; this option exists
for most but not all libraries.

For many libraries there are in addition '--with-Lib-includes=DIR' and
'--with-Lib-libdir=DIR' to indicate that the library is installed in an
unusual location.

When a system version of a required library is chosen, the top-level configure script
performs a consistency check and bails out early if this fails.

4. Some important VAR=value configure arguments
===============================================

Used instead of searching for programs in PATH.

4.1. FT2_CONFIG=/path/to/freetype-config
----------------------------------------

For system freetype2 library.

4.2. PKG_CONFIG=/path/to/pkg-config
-----------------------------------

For fontconfig and system xpdf (poppler) libraries.

4.3. CLISP=/path/to/clisp
-------------------------

For xindy.

4.4. latex=/path/to/latex
-------------------------

To build xindy make-rules.

4.5. pdflatex=/path/to/pdflatex
-------------------------------

To build xindy docs.