summaryrefslogtreecommitdiff
path: root/Build/source/README.config
blob: 59447eedb6e6dbf36fa8edb2680fa4b9223aec76 (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
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.

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

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 increasing
performance on little-endian systems).

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. --enable-mf-nowin

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.