Mercurial > hg > xemacs-beta

comparison configure.usage @ 1202:6041a741b6d6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2003-01-12 11:03:13 by michaels] 2003-01-12 Mike Sperber <mike@xemacs.org> * configure.in: Check for strupr and strlwr. 2002-12-16 Ben Wing <ben@xemacs.org> * INSTALL (Rationale): * configure.in (XE_COMPUTE_RUNPATH): * configure.usage (Usage): * configure.usage (--xemacs-compiler): * configure.usage (--srcdir): * configure.usage (--with-prefix): * configure.usage (--bindir): New. * configure.usage (--datadir): New. * configure.usage (--statedir): New. * configure.usage (--libdir): New. * configure.usage (--infodir): New. * configure.usage (--mandir): New. * configure.usage (--lispdir): New. * configure.usage (--sitelispdir): New. * configure.usage (--etcdir): New. * configure.usage (--lockdir): New. * configure.usage (--archlibdir): New. * configure.usage (--docdir): New. * configure.usage (--moduledir): New. * configure.usage (--with-site-lisp): New. * configure.usage (--with-site-modules): New. * configure.usage (--package-path): New. * configure.usage (--infopath): New. * configure.usage (--with-xmu): * configure.usage (--with-tty): * configure.usage (--with-gif): * configure.usage (--native-sound-lib): * configure.usage (--with-xim): New. * configure.usage (--with-clash-detection): New. * configure.usage (--with-database): * configure.usage (--mail-locking): * configure.usage (--with-ipv6-cname): Removed. * configure.usage (--error-checking): Redo usage message more logically, fix some problems. In configure, when outputting the compilation options, put in a big ugly warning about using union-type, since it's been known to trigger so many compiler bugs, invariably leading to weird crashes.
author michaels
date Sun, 12 Jan 2003 11:03:16 +0000
parents 184461bc8de4
children f99d3d25df86
comparison
equal deleted inserted replaced
1201:c2569faae8ed 1202:6041a741b6d6
18 The results of configure tests are saved in config.log, which is useful 18 The results of configure tests are saved in config.log, which is useful
19 for diagnosing problems. 19 for diagnosing problems.
20 20
21 21
22 General options: 22 General options:
23 ----------------
23 24
24 --help Issue this usage message. 25 --help Issue this usage message.
25 --verbose Accepted but ignored. 26 --verbose Accepted but ignored.
26 --extra-verbose Display more information, useful for debugging. 27 --extra-verbose Display more information, useful for debugging.
27 28
28 29
29 Compilation options: 30 Compilation options:
31 --------------------
30 32
31 --compiler=PROG C compiler to use 33 --compiler=PROG C compiler to use
32 --xemacs-compiler=PROG compiler to use to compile just the xemacs executable 34 --xemacs-compiler=PROG compiler to use to compile just the xemacs executable.
35 If you want to compile XEmacs as C++, use e.g.
36 `--xemacs-compiler=g++'. This turns on a lot of
37 additional error-checking.
33 --with-gcc (*) Use GCC to compile XEmacs. 38 --with-gcc (*) Use GCC to compile XEmacs.
34 --cflags=FLAGS Compiler flags (such as -O); setting this overrides 39 --cflags=FLAGS Compiler flags (such as -O); setting this overrides
35 all default compiler flags except those that control 40 all default compiler flags except those that control
36 warnings. 41 warnings.
37 --cflags_warning=FLAGS Override compiler flags used to control warnings. 42 --cflags_warning=FLAGS Override compiler flags used to control warnings.
51 linked libraries at run time 56 linked libraries at run time
52 --dynamic=yes Link dynamically if supported by system. 57 --dynamic=yes Link dynamically if supported by system.
53 --dynamic=no Force static linking on systems where dynamic 58 --dynamic=no Force static linking on systems where dynamic
54 linking is the default. 59 linking is the default.
55 --srcdir=DIR Look for the XEmacs source files in DIR. 60 --srcdir=DIR Look for the XEmacs source files in DIR.
56 Works best when using GNU Make. 61 Works best when using GNU Make. Allows you to build
62 XEmacs in various different ways using the same
63 source tree.
57 64
58 65
59 Installation options: 66 Installation options:
67 ---------------------
60 68
61 --prefix=DIR Install files below DIR. Defaults to `/usr/local'. 69 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
62 --with-prefix=no Don't compile the value of --prefix into the 70 --with-prefix=no Don't compile the value of --prefix into the
63 executable. 71 executable.
72 --with-netinstall Compile in support for installation over the internet.
73 Only functional on the MS Windows platforms.
74 --bindir=DIR
75 --datadir=DIR
76 --statedir=DIR
77 --libdir=DIR
78 --infodir=DIR
79 --mandir=DIR
80 --lispdir=DIR
81 --sitelispdir=DIR
82 --etcdir=DIR
83 --lockdir=DIR
84 --archlibdir=DIR
85 --docdir=DIR
86 --moduledir=DIR
87 You may also control individually where various
88 parts of XEmacs are installed. Note that we
89 recommend against explicitly setting any of these
90 variables. See the INSTALL file for a complete list
91 plus the reasons we advise not changing them.
92
93
94 Run-time path-searching options:
95 --------------------------------
96
97 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
98 searched before the installation packages.
99 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
100 which is searched before the installation modules.
101 --package-path=PATH Directories to search for packages to dump with xemacs.
102 PATH splits into three parts separated by double
103 colons (::), an early, a late, and a last part,
104 corresponding to their position in the various
105 system paths: The early part is always first,
106 the late part somewhere in the middle, and the
107 last part at the very back.
108 Only the late part gets seen at dump time.
109 If PATH has only one component, that component
110 is late.
111 If PATH has two components, the first is
112 early, the second is late.
113 --infopath=PATH Directories to search for Info documents, info dir
114 and localdir files in case run-time searching
115 for them fails.
64 116
65 117
66 Window-system options: 118 Window-system options:
119 ----------------------
67 120
68 --with-gtk Support GTK on the X Window System. (EXPERIMENTAL) 121 --with-gtk Support GTK on the X Window System. (EXPERIMENTAL)
69 --with-gnome Support GNOME on the X Window System. (EXPERIMENTAL) 122 --with-gnome Support GNOME on the X Window System. (EXPERIMENTAL)
70 --with-x11 (*) Support the X Window System. 123 --with-x11 (*) Support the X Window System.
71 --x-includes=DIR Search for X header files in DIR. 124 --x-includes=DIR Search for X header files in DIR.
105 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu. 158 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu.
106 --external-widget Compile with external widget support. 159 --external-widget Compile with external widget support.
107 160
108 161
109 TTY (character terminal) options: 162 TTY (character terminal) options:
163 ---------------------------------
110 164
111 --with-tty=no Don't support ttys. 165 --with-tty=no Don't support ttys.
112 --with-ncurses (*) Use the ncurses library for tty support. 166 --with-ncurses (*) Use the ncurses library for tty support.
113 --with-gpm (*) Compile in GPM mouse support for ttys. 167 --with-gpm (*) Compile in GPM mouse support for ttys.
114 168
115 169
116 Image options: 170 Image options:
171 --------------
117 172
118 --with-xpm (*) Compile with support for XPM images. PRACTICALLY 173 --with-xpm (*) Compile with support for XPM images. PRACTICALLY
119 REQUIRED. Although this library is nonstandard and 174 REQUIRED. Although this library is nonstandard and
120 a real hassle to build, many basic things (e.g. 175 a real hassle to build, many basic things (e.g.
121 toolbars) depend on it, and you will run into 176 toolbars) depend on it, and you will run into
133 usefulness. 188 usefulness.
134 --with-gif=no Compile without the (builtin) support for GIF images. 189 --with-gif=no Compile without the (builtin) support for GIF images.
135 190
136 191
137 Sound options: 192 Sound options:
193 --------------
138 194
139 --with-sound=TYPE[,TYPE[,...]] (*) Compile with sound support. 195 --with-sound=TYPE[,TYPE[,...]] (*) Compile with sound support.
140 Valid types are `native', `nas' and `esd'. 196 Valid types are `native', `nas' and `esd'.
141 Prefix a type with 'no' to disable. 197 Prefix a type with 'no' to disable.
142 The first type can be `none' or `all'. `none' means 198 The first type can be `none' or `all'. `none' means
146 --native-sound-lib=LIB Native sound support library. Needed on Suns 202 --native-sound-lib=LIB Native sound support library. Needed on Suns
147 with `--with-sound=native,nas' because both sound 203 with `--with-sound=native,nas' because both sound
148 libraries are called libaudio. 204 libraries are called libaudio.
149 205
150 206
151 Database options:
152
153 --with-database=TYPE (*) Compile with database support. Valid types are
154 `no' or a comma-separated list of one or more
155 of `berkdb' and either `dbm' or `gnudbm'.
156 --with-ldap (*) Compile with support for the LDAP protocol.
157 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
158
159
160 Mail options:
161
162 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
163 concurrent updates of mail spool files. Valid types
164 are `lockf', `flock', `dot', `locking' or `mmdf'.
165 --with-pop Support POP for mail retrieval.
166 --with-kerberos Support Kerberos-authenticated POP.
167 --with-hesiod Support Hesiod to get the POP server host.
168
169
170 Additional features:
171
172 --with-tooltalk (*) Support the ToolTalk IPC protocol.
173 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
174 development environment.
175 --with-socks Compile with support for SOCKS (an Internet proxy).
176 --with-dnet (*) Compile with support for DECnet.
177 --with-modules (*) Compile in experimental support for dynamically
178 loaded libraries (Dynamic Shared Objects).
179 --with-netinstall Compile in support for installation over the internet.
180 Only functional on the MS Windows platforms.
181 --with-ipv6-cname=yes Try IPv6 information first when canonicalizing host
182 names. This option has no effect unless system
183 supports getaddrinfo(3) and getnameinfo(3).
184 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
185 searched before the installation packages.
186 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
187 which is searched before the installation modules.
188 --package-path=PATH Directories to search for packages to dump with xemacs.
189 PATH splits into three parts separated by double
190 colons (::), an early, a late, and a last part,
191 corresponding to their position in the various
192 system paths: The early part is always first,
193 the late part somewhere in the middle, and the
194 last part at the very back.
195 Only the late part gets seen at dump time.
196 If PATH has only one component, that component
197 is late.
198 If PATH has two components, the first is
199 early, the second is late.
200 --infodir=DIR Directory to install XEmacs Info manuals and dir in.
201 --infopath=PATH Directories to search for Info documents, info dir
202 and localdir files in case run-time searching
203 for them fails.
204 --moduledir=DIR Directory to install dynamic modules in.
205 --pdump New, experimental, don't-sue-me-if-your-house-
206 collapses-and-your-wife-leaves-you, portable dumper.
207 (Actually, not as experimental or non-working as
208 Olivier claims. Works quite well, in fact.)
209 --with-default-eol-detection
210 Turns on by default auto-detection of end-of-line type
211 when reading a file. Applies to those platforms where
212 auto-detection is off by default (non-Mule Unix). Has
213 no effect otherwise.
214
215
216 Internationalization options: 207 Internationalization options:
208 -----------------------------
217 209
218 --with-mule Compile with Mule (MUlti-Lingual Emacs) support, 210 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
219 needed to support non-Latin-1 (including Asian) 211 needed to support non-Latin-1 (including Asian)
220 languages. 212 languages.
221 --with-xim=xlib Compile with support for X input methods, 213 --with-xim=xlib Compile with support for X input methods,
236 --with-xfs Compile with XFontSet support for internationalized 228 --with-xfs Compile with XFontSet support for internationalized
237 menubar. Incompatible with `--with-xim=motif'. 229 menubar. Incompatible with `--with-xim=motif'.
238 `--with-menubars=lucid' (the default) is desirable. 230 `--with-menubars=lucid' (the default) is desirable.
239 231
240 232
233 File-related options:
234 ---------------------
235
236 --with-default-eol-detection
237 Turns on by default auto-detection of end-of-line type
238 when reading a file. Applies to those platforms where
239 auto-detection is off by default (non-Mule Unix). Has
240 no effect otherwise.
241 --with-clash-detection=no
242 Disable use of lock files to detect multiple edits
243 of the same file.
244
245
246 Database options:
247 -----------------
248
249 --with-database=TYPE (*) Compile with database support. Valid types are
250 `no' or a comma-separated list of one or more
251 of `berkdb' and either `dbm' or `gnudbm'.
252 --with-ldap (*) Compile with support for the LDAP protocol.
253 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
254
255
256 Mail options:
257 -------------
258
259 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
260 concurrent updates of mail spool files. Valid types
261 are `lockf', `flock', `dot', `locking' or `mmdf'.
262 --with-pop Support POP for mail retrieval.
263 --with-kerberos Support Kerberos-authenticated POP.
264 --with-hesiod Support Hesiod to get the POP server host.
265
266
267 Networking options:
268 -------------------
269
270 --with-tooltalk (*) Support the ToolTalk IPC protocol.
271 --with-socks Compile with support for SOCKS (an Internet proxy).
272 --with-dnet (*) Compile with support for DECnet.
273 --with-ipv6-cname Try IPv6 information first when canonicalizing host
274 names. This option has no effect unless system
275 supports getaddrinfo(3) and getnameinfo(3).
276
277
278 Memory allocation options:
279 --------------------------
280
281 --rel-alloc Use the relocating allocator (default for this option
282 is system-dependent).
283 --with-dlmalloc Control usage of Doug Lea malloc on systems that have
284 it in the standard C library (default is to use it if
285 it is available).
286 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
287 --with-debug-malloc Use the debugging malloc package.
288
289
241 Debugging options: 290 Debugging options:
291 ------------------
242 292
243 --debug Compile with support for debugging XEmacs. 293 --debug Compile with support for debugging XEmacs.
244 (Causes code-size increase and little loss of speed.) 294 (Causes code-size increase and little loss of speed.)
245 --error-checking=TYPE[,TYPE]... 295 --error-checking=TYPE[,TYPE]...
246 Compile with internal error-checking added. 296 Compile with internal error-checking added.
259 each file during dumping, and (2) doesn't 309 each file during dumping, and (2) doesn't
260 automatically rebuild the DOC file. (Remove it by hand 310 automatically rebuild the DOC file. (Remove it by hand
261 to get it rebuilt.) 311 to get it rebuilt.)
262 --use-union-type Enable or disable use of a union, instead of an 312 --use-union-type Enable or disable use of a union, instead of an
263 int, for the fundamental Lisp_Object type; this 313 int, for the fundamental Lisp_Object type; this
264 provides stricter type-checking. Only works with 314 provides stricter type-checking. WARNING: This has
265 some systems and compilers. 315 a tendency to trigger compiler bugs, especially in
266 --use-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL) 316 combination with other features that increase the
317 complexity of expressions, for example `--with-mule'
318 and `--error-checking=all'. Crashes have been
319 observed with union type in combination with the
320 two options just mentioned under various versions of
321 GCC as well as MSVC++ 6.0. Furthermore, many
322 debuggers have problems (i.e. bugs) dealing with
323 unions, and even for those that don't, debugging can
324 be inconvenient because of no syntax for entering a
325 union. We recommend `--use-union-type' *ONLY* for
326 testing purposes, not for production builds. If you
327 are using `-use-union-type' and get some weird
328 crash, try redoing without union type.
267 --with-quantify Add support for performance debugging using Quantify. 329 --with-quantify Add support for performance debugging using Quantify.
268 --with-purify Add support for memory debugging using Purify. 330 --with-purify Add support for memory debugging using Purify.
269 331
270 332
271 Other options: 333 Developer options:
272 334 ------------------
273 --rel-alloc Use the relocating allocator (default for this option 335
274 is system-dependent). 336 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
275 --with-dlmalloc Control usage of Doug Lea malloc on systems that have 337 development environment.
276 it in the standard C library (default is to use it if 338 --pdump New, portable, relocatable dumper. Currently works
277 it is available). 339 quite well, somewhere in beta-to-late-beta, we
278 --with-system-malloc Force use of the system malloc, rather than GNU malloc. 340 might say. (Infamous for being the former
279 --with-debug-malloc Use the debugging malloc package. 341 "experimental, don't-sue-me-if-your-house-collapses-
280 --with-clash-detection Use lock files to detect multiple edits of the same 342 and-your-wife-leaves-you" portable dumper.)
281 file. The default is to do clash detection. 343 --use-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL)
282 344 --with-modules (*) Compile in experimental support for dynamically
283 You may also specify any of the `path' variables found in Makefile.in.in, 345 loaded libraries (Dynamic Shared Objects).
284 including --bindir, --libdir, --docdir, --lispdir, --sitelispdir, 346
285 --datadir, --infodir, --mandir and so on. Note that we recommend
286 against explicitly setting any of these variables. See the INSTALL
287 file for a complete list plus the reasons we advise not changing them.
288 347
289 If successful, configure leaves its status in config.status. If 348 If successful, configure leaves its status in config.status. If
290 unsuccessful after disturbing the status quo, it removes config.status. 349 unsuccessful after disturbing the status quo, it removes config.status.
291 350
292 The configure script also recognizes some environment variables, each 351 The configure script also recognizes some environment variables, each