annotate configure.usage @ 2913:29b9f946c6d9

[xemacs-hg @ 2005-08-30 21:51:28 by viteno] Update xemacs_extra_name.
author viteno
date Tue, 30 Aug 2005 21:51:28 +0000
parents 6fa9919a9a0b
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
1 Usage: configure [--OPTION[=VALUE] ...] [CONFIGURATION]
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
2
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
3 Set compilation and installation parameters for XEmacs, and report.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
4
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
5 Note that for most of the following options, you can explicitly enable
380
8626e4521993 Import from CVS: tag r21-2-5
cvs
parents: 373
diff changeset
6 them using `--OPTION=yes' and explicitly disable them using `--OPTION=no'.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
7 This is especially useful for auto-detected options.
276
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 274
diff changeset
8 The option `--without-FEATURE' is a synonym for `--with-FEATURE=no'.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
9
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
10 Options marked with a (*) are auto-detected.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
11
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
12 Many features require external packages to be installed first.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
13 Get them from ftp://ftp.xemacs.org/pub/xemacs/aux.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
14
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
15 Use colons (or quoted spaces) to separate directory names in option
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
16 values which are PATHs (i.e. lists of directories).
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
17
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
18 The results of configure tests are saved in config.log, which is useful
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
19 for diagnosing problems.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
20
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
21
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
22 General options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
23 ----------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
24
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
25 --help Issue this usage message.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
26 --verbose Accepted but ignored.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
27 --extra-verbose Display more information, useful for debugging.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
28
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
29
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
30 Compilation options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
31 --------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
32
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
33 --compiler=PROG C compiler to use
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
34 --xemacs-compiler=PROG compiler to use to compile just the xemacs executable.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
35 If you want to compile XEmacs as C++, use e.g.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
36 `--xemacs-compiler=g++'. This turns on a lot of
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
37 additional error-checking.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
38 --with-gcc (*) Use GCC to compile XEmacs.
1111
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
39 --cflags=FLAGS Compiler flags (such as -O); setting this overrides
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
40 all default compiler flags except those that control
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
41 warnings.
1546
204e0afae501 [xemacs-hg @ 2003-06-30 09:10:26 by stephent]
stephent
parents: 1462
diff changeset
42 --cflags-warning=FLAGS Override compiler flags used to control warnings.
1111
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
43 Normally, don't set this, as XEmacs already turns on
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
44 the maximum safe warning level.
2512
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
45 --with-optimization Control whether compilation is optimized.
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
46 By default, optimization is on in release versions
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
47 and off in beta versions, since it can interfere
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
48 with proper stack backtraces.
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
49 --cflags-optimization=FLAGS
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
50 Override compiler flags used to control optimization.
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
51 Only has an effect when optimization is enabled.
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
52 Normally, don't set this, as XEmacs will already set
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
53 the maximum safe optimization flags appropriate for
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
54 the compiler being invoked.
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
55 --cflags-debugging=FLAGS
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
56 Override compiler flags used to add debugging
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
57 information to the executable. Normally, debugging
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
58 information is added whenever possible (i.e. unless
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
59 optimization is turned on and the compiler does not
38caebdefb55 [xemacs-hg @ 2005-01-26 10:02:12 by ben]
ben
parents: 2416
diff changeset
60 permit debugging and optimization simultaneously).
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
61 --cpp=PROG C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
62 --cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
63 --libs=LIBS Additional libraries (e.g. -lfoo)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
64 --ldflags=FLAGS Additional linker flags (e.g. -L/foo)
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
65 --site-includes=PATH List of directories to search first for header files
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
66 --site-libraries=PATH List of directories to search first for libraries
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
67 --site-prefixes=PATH List of directories to search for include/ and lib/
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
68 subdirectories, just after 'site-includes' and
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
69 'site-libraries'
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
70 --site-runtime-libraries=PATH
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
71 List of ALL directories to search for dynamically
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
72 linked libraries at run time
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
73 --dynamic=yes Link dynamically if supported by system.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
74 --dynamic=no Force static linking on systems where dynamic
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
75 linking is the default.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
76 --srcdir=DIR Look for the XEmacs source files in DIR.
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
77 Works best when using GNU Make. Allows you to build
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
78 XEmacs in various different ways using the same
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
79 source tree.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
80
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
81
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
82 Installation options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
83 ---------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
84
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
85 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
86 --with-prefix=no Don't compile the value of --prefix into the
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
87 executable.
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
88 --with-netinstall Compile in support for installation over the internet.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
89 Only functional on the MS Windows platforms.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
90 --bindir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
91 --datadir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
92 --statedir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
93 --libdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
94 --infodir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
95 --mandir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
96 --lispdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
97 --sitelispdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
98 --etcdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
99 --lockdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
100 --archlibdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
101 --docdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
102 --moduledir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
103 You may also control individually where various
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
104 parts of XEmacs are installed. Note that we
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
105 recommend against explicitly setting any of these
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
106 variables. See the INSTALL file for a complete list
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
107 plus the reasons we advise not changing them.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
108
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
109
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
110 Run-time path-searching options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
111 --------------------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
112
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
113 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
114 searched before the installation packages.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
115 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
116 which is searched before the installation modules.
2416
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
117 --package-prefix=PATH Specify a directory under which packages will
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
118 be searched. The directories `xemacs-packages' and
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
119 (if MULE support exists) `mule-packages' (along with,
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
120 optionally, `site-packages') should exist under this
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
121 directory. This is preferred to specifying
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
122 `--package-path' directly and is equivalent to
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
123 --package-path="~/.xemacs::${package-prefix}/\
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
124 site-packages:${package_prefix}/xemacs-packages:\
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
125 ${package_prefix}/mule-packages"
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
126 (or the same without `.../mule-packages' if no
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
127 MULE support exists)
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
128 --package-path=PATH Directories to search for packages to dump with xemacs.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
129 PATH splits into three parts separated by double
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
130 colons (::), an early, a late, and a last part,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
131 corresponding to their position in the various
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
132 system paths: The early part is always first,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
133 the late part somewhere in the middle, and the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
134 last part at the very back.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
135 Only the late part gets seen at dump time.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
136 If PATH has only one component, that component
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
137 is late.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
138 If PATH has two components, the first is
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
139 early, the second is late.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
140 --infopath=PATH Directories to search for Info documents, info dir
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
141 and localdir files in case run-time searching
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
142 for them fails.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
143
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
144
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
145 Window-system options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
146 ----------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
147
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 442
diff changeset
148 --with-gtk Support GTK on the X Window System. (EXPERIMENTAL)
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 442
diff changeset
149 --with-gnome Support GNOME on the X Window System. (EXPERIMENTAL)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
150 --with-x11 (*) Support the X Window System.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
151 --x-includes=DIR Search for X header files in DIR.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
152 --x-libraries=DIR Search for X libraries in DIR.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
153 --with-msw (*) Support MS Windows as a window system (only under
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
154 Cygwin and MinGW). `--with-msw=no' may be needed on
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
155 *nix systems with Wine installed.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
156 --with-toolbars=no Don't compile with any toolbar support.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
157 --with-wmcommand=no Compile without realized leader window which will
414
da8ed4261e83 Import from CVS: tag r21-2-15
cvs
parents: 412
diff changeset
158 keep the WM_COMMAND property.
1617
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
159 --with-athena=TYPE Use TYPE Athena widgets (xaw, 3d, next, 95, or xpm).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
160 --with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
161 widgets emulate Motif (mostly) but are faster.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
162 *WARNING* The Motif menubar is currently broken.
1617
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
163 Lucid menubars are the default.
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
164 --with-scrollbars=TYPE Use TYPE scrollbars (lucid, motif, athena, or no).
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
165 Lucid scrollbars are the default.
642
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
166 --with-dialogs=TYPE Use TYPE dialog boxes (lucid, motif, athena, or no).
1617
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
167 There are no true Lucid dialogs; Motif dialogs will be
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
168 used if Motif can be found, else Athena is used.
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
169 --with-widgets=TYPE Use TYPE native widgets (lucid, motif, athena, or no).
974
fce478afd5b4 [xemacs-hg @ 2002-08-24 10:23:48 by scop]
scop
parents: 925
diff changeset
170 Other widget types are currently unsupported.
1617
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
171 There are no true Lucid widgets; Motif widgets will be
000fb15e7f54 [xemacs-hg @ 2003-08-12 06:36:38 by stephent]
stephent
parents: 1546
diff changeset
172 used if Motif can be found, else Athena is used.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
173 --with-dragndrop Compile in the generic drag and drop API. This is
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
174 automatically added if one of the drag and drop
642
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
175 protocols is found (currently CDE, OffiX, MSWindows,
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
176 and GTK).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
177 *WARNING* The Drag'n'drop support is under development
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
178 and is considered experimental.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
179 --with-cde Compile in support for CDE drag and drop.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
180 --with-offix Compile in support for OffiX drag and drop.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
181 *WARNING* If you compile in OffiX, you may not be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
182 able to use multiple X displays success-
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
183 fully. If the two servers are from
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
184 different vendors, the results may be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
185 unpredictable.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
186 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
187 --external-widget Compile with external widget support.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
188
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
189
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
190 TTY (character terminal) options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
191 ---------------------------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
192
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
193 --with-tty=no Don't support ttys.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
194 --with-ncurses (*) Use the ncurses library for tty support.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
195 --with-gpm (*) Compile in GPM mouse support for ttys.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
196
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
197
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
198 Image options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
199 --------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
200
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
201 --with-xpm (*) Compile with support for XPM images. PRACTICALLY
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
202 REQUIRED. Although this library is nonstandard and
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
203 a real hassle to build, many basic things (e.g.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
204 toolbars) depend on it, and you will run into
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
205 many problems without it.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
206 --with-png (*) Compile with support for PNG images. Recommended
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
207 because the images on the About page are not viewable
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
208 without it.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
209 --with-jpeg (*) Compile with support for JPEG images. Useful if
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
210 you are using a mail, news reader, or web browser
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
211 in XEmacs, so that JPEG images can be displayed.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
212 --with-tiff (*) Compile with support for TIFF images. Possibly
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
213 useful, for the same reason as JPEG images.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
214 --with-xface (*) Compile with support for X-Face mail headers.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
215 Requires the compface package. Of doubtful
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
216 usefulness.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
217 --with-gif=no Compile without the (builtin) support for GIF images.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
218
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
219
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
220 Sound options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
221 --------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
222
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
223 --with-sound=TYPE[,TYPE[,...]] (*) Compile with sound support.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
224 Valid types are `native', `nas' and `esd'.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
225 Prefix a type with 'no' to disable.
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
226 The first type can be `none' or `all'. `none' means
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
227 `nonative,nonas,noesd'. `all' means `native,nas,esd'.
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
228 Later options override earlier ones for the same TYPE.
1462
c5da5c66fea7 [xemacs-hg @ 2003-05-07 08:34:08 by youngs]
youngs
parents: 1303
diff changeset
229 The default is to autodetect all sound support except
c5da5c66fea7 [xemacs-hg @ 2003-05-07 08:34:08 by youngs]
youngs
parents: 1303
diff changeset
230 for ESD which defaults to off.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
231 --native-sound-lib=LIB Native sound support library. Needed on Suns
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
232 with `--with-sound=native,nas' because both sound
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
233 libraries are called libaudio.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
234
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
235
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
236 Internationalization options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
237 -----------------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
238
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
239 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
240 needed to support non-Latin-1 (including Asian)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
241 languages.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
242 --with-xim=xlib Compile with support for X input methods,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
243 --with-xim=motif (*) Used in conjunction with Mule support.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
244 Use either raw Xlib to provide XIM support, or
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
245 the Motif XmIm* routines (when available).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
246 NOTE: On some systems bugs in X11's XIM support
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
247 will cause XEmacs to crash, so by default,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
248 no XIM support is compiled in, unless running
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
249 on Solaris and the XmIm* routines are detected.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
250 --with-canna (*) Compile with support for Canna (a Japanese input method
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
251 used in conjunction with Mule support).
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
252 --with-wnn (*) Compile with support for Wnn (a multi-language input
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
253 method used in conjunction with Mule support).
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
254 --with-wnn6 (*) Compile with support for the commercial package Wnn6.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
255 --with-i18n3 Compile with I18N level 3 (support for message
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
256 translation). This doesn't currently work.
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
257 --with-xfs Compile with XFontSet support for internationalized
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
258 menubar. Incompatible with `--with-xim=motif'.
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
259 `--with-menubars=lucid' (the default) is desirable.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
260
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
261
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
262 File-related options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
263 ---------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
264
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
265 --with-default-eol-detection
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
266 Turns on by default auto-detection of end-of-line type
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
267 when reading a file. Applies to those platforms where
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
268 auto-detection is off by default (non-Mule Unix). Has
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
269 no effect otherwise.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
270 --with-clash-detection=no
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
271 Disable use of lock files to detect multiple edits
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
272 of the same file.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
273
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
274
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
275 Database options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
276 -----------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
277
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
278 --with-database=TYPE (*) Compile with database support. Valid types are
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
279 `no' or a comma-separated list of one or more
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
280 of `berkdb' and either `dbm' or `gnudbm'.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
281 --with-ldap (*) Compile with support for the LDAP protocol.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
282 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
283
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
284
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
285 Mail options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
286 -------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
287
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
288 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
2416
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
289 concurrent updates of mail spool files. Valid types
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
290 are `lockf', `flock', `file', `dot' (same as `file'),
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
291 `locking', `mmdf' and `pop' (equivalent to
515786aa760a [xemacs-hg @ 2004-12-05 08:06:41 by ben]
ben
parents: 1985
diff changeset
292 `--with-pop=yes').
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
293 --with-pop Support POP for mail retrieval.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
294 --with-kerberos Support Kerberos-authenticated POP.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
295 --with-hesiod Support Hesiod to get the POP server host.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
296
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
297
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
298 Networking options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
299 -------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
300
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
301 --with-tooltalk (*) Support the ToolTalk IPC protocol.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
302 --with-socks Compile with support for SOCKS (an Internet proxy).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
303 --with-dnet (*) Compile with support for DECnet.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
304 --with-ipv6-cname Try IPv6 information first when canonicalizing host
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
305 names. This option has no effect unless system
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
306 supports getaddrinfo(3) and getnameinfo(3).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
307
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
308
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
309 Memory allocation options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
310 --------------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
311
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
312 --rel-alloc Use the relocating allocator (default for this option
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
313 is system-dependent).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
314 --with-dlmalloc Control usage of Doug Lea malloc on systems that have
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
315 it in the standard C library (default is to use it if
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
316 it is available).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
317 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
318 --with-debug-malloc Use the debugging malloc package.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
319
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
320
1984
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
321 Emacs Lisp options:
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
322 -------------------
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
323
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
324 --use-number-lib=TYPE Compile in support for bignums, ratios, or bigfloats
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
325 using library support. TYPE must be one of "gmp"
1985
a8b463c4984a [xemacs-hg @ 2004-04-06 12:13:54 by stephent]
stephent
parents: 1984
diff changeset
326 (for GNU MP), "mp" (for BSD MP), or "no" (disabled).
1984
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
327
36760cdcb631 [xemacs-hg @ 2004-04-05 22:50:44 by james]
james
parents: 1617
diff changeset
328
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
329 Debugging options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
330 ------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
331
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
332 --debug Compile with support for debugging XEmacs.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
333 (Causes code-size increase and little loss of speed.)
221
6c0ae1f9357f Import from CVS: tag r20-4b9
cvs
parents: 219
diff changeset
334 --error-checking=TYPE[,TYPE]...
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
335 Compile with internal error-checking added.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
336 Causes noticeable loss of speed. Valid types
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
337 are extents, bufpos, malloc, gc, typecheck.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
338 --error-checking=none Disable all internal error-checking (the default).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
339 --error-checking=all Enable all internal error-checking.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
340 --memory-usage-stats Compile with additional code to allow you to
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
341 determine what XEmacs's memory is being used
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
342 for. Causes a small code increase but no loss
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
343 of speed. Normally enabled when --debug is given.
771
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
344 --quick-build Speed up the build cycle by leaving out steps where
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
345 XEmacs will still work (more or less) without them.
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
346 Potentially dangerous if you don't know what you're
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
347 doing. This (1) doesn't garbage-collect after loading
1303
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
348 each file during dumping, (2) doesn't
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
349 automatically rebuild the DOC file (remove it by hand
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
350 to get it rebuilt), (3) Removes config.h, lisp.h and
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
351 associated files from the dependency lists, so changes
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
352 to these files don't automatically cause all .c files
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
353 to be rebuilt.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
354 --use-union-type Enable or disable use of a union, instead of an
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
355 int, for the fundamental Lisp_Object type; this
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
356 provides stricter type-checking. WARNING: This has
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
357 a tendency to trigger compiler bugs, especially in
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
358 combination with other features that increase the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
359 complexity of expressions, for example `--with-mule'
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
360 and `--error-checking=all'. Crashes have been
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
361 observed with union type in combination with the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
362 two options just mentioned under various versions of
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
363 GCC as well as MSVC++ 6.0. Furthermore, many
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
364 debuggers have problems (i.e. bugs) dealing with
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
365 unions, and even for those that don't, debugging can
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
366 be inconvenient because of no syntax for entering a
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
367 union. We recommend `--use-union-type' *ONLY* for
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
368 testing purposes, not for production builds. If you
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
369 are using `-use-union-type' and get some weird
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
370 crash, try redoing without union type.
392
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
371 --with-quantify Add support for performance debugging using Quantify.
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
372 --with-purify Add support for memory debugging using Purify.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
373
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
374
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
375 Developer options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
376 ------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
377
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
378 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
379 development environment.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
380 --pdump New, portable, relocatable dumper. Currently works
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
381 quite well, somewhere in beta-to-late-beta, we
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
382 might say. (Infamous for being the former
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
383 "experimental, don't-sue-me-if-your-house-collapses-
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
384 and-your-wife-leaves-you" portable dumper.)
2720
6fa9919a9a0b [xemacs-hg @ 2005-04-08 23:10:01 by crestani]
crestani
parents: 2512
diff changeset
385 --dump-in-exec Put the dump image into the executable (enabled by
6fa9919a9a0b [xemacs-hg @ 2005-04-08 23:10:01 by crestani]
crestani
parents: 2512
diff changeset
386 default for `pdump', not enabled by default in
6fa9919a9a0b [xemacs-hg @ 2005-04-08 23:10:01 by crestani]
crestani
parents: 2512
diff changeset
387 combination with `mc-alloc'.
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
388 --use-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL)
2720
6fa9919a9a0b [xemacs-hg @ 2005-04-08 23:10:01 by crestani]
crestani
parents: 2512
diff changeset
389 --mc-alloc Enable the new allocator. (EXPERIMENTAL)
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
390 --with-modules (*) Compile in experimental support for dynamically
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
391 loaded libraries (Dynamic Shared Objects).
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
392
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
393
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
394 If successful, configure leaves its status in config.status. If
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
395 unsuccessful after disturbing the status quo, it removes config.status.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
396
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
397 The configure script also recognizes some environment variables, each
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
398 of which is equivalent to a corresponding configure flag. Configure
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
399 flags take precedence over environment variables, if both are specified.
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
400
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
401 environment corresponding
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
402 variable configure flag
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
403 ----------- --------------
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
404 CC --compiler
594
fd49b88b9f06 [xemacs-hg @ 2001-05-31 12:47:21 by ben]
ben
parents: 464
diff changeset
405 XEMACS_CC --xemacs-compiler
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
406 CPP --cpp
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
407 CFLAGS --cflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
408 CPPFLAGS --cppflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
409 LDFLAGS --ldflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
410 LIBS --libs
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
411 LD_RUN_PATH --site-runtime-libraries
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
412
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
413 For more details on the install process, consult the INSTALL file.