annotate configure.usage @ 404:2f8bb876ab1d r21-2-32

Import from CVS: tag r21-2-32
author cvs
date Mon, 13 Aug 2007 11:16:07 +0200
parents 74fd4e045ea6
children b8cc9ab3f761
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
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
12 Use colons (or quoted spaces) to separate directory names in option
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
13 values which are PATHs (i.e. lists of directories).
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
14
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
15 General options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
16
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
17 --help Issue this usage message.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
18 --verbose Display the results of configure tests.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
19 --extra-verbose Display even more information, useful for debugging.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
20
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
21
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
22 Compilation options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
23
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
24 --compiler=prog C compiler to use.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
25 --with-gcc (*) Use GCC to compile XEmacs.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
26 --without-gcc Don't use GCC to compile XEmacs.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
27 --cflags=FLAGS Compiler flags (such as -O)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
28 --cpp=prog C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
29 --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
30 --libs=LIBS Additional libraries (e.g. -lfoo)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
31 --ldflags=FLAGS Additional linker flags (e.g. -L/foo)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
32 --site-includes=PATH List of directories to search first for header files.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
33 --site-libraries=PATH List of directories to search first for libraries.
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
34 --site-prefixes=PATH List of directories to search for include/ and lib/
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
35 subdirectories, just after 'site-includes' and
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
36 'site-libraries'.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
37 --site-runtime-libraries=PATH
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
38 List of ALL directories to search for dynamically
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
39 linked libraries at run time.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
40 --dynamic=yes Link dynamically if supported by system.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
41 --dynamic=no Force static linking on systems where dynamic
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
42 linking is the default.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
43 --srcdir=DIR Look for the XEmacs source files in DIR.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
44 Works best when using GNU Make.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
45
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
46
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
47 Installation options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
48
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
49 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
50 --with-prefix Compile the value of --prefix into the executable.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
51 Defaults to `yes'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
52 --without-prefix Don't compile the value of --prefix into the executable.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
53
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
54
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
55 Window-system options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
56
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
57 --with-x11 (*) Support the X Window System.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
58 --without-x11 Don't support X.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
59 --x-includes=DIR Search for X header files in DIR.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
60 --x-libraries=DIR Search for X libraries in DIR.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
61 --without-toolbars Don't compile with any toolbar support.
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
62 --without-wmcommand Compile without realized leader window which will
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
63 keep the WM_COMMAND property.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
64 --with-athena=TYPE Use TYPE Athena widgets
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
65 (xaw, 3d, next, 95, or xpm)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
66 --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
67 widgets emulate Motif (mostly) but are faster.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
68 *WARNING* The Motif menubar is currently broken.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
69 --with-scrollbars=TYPE Use TYPE scrollbars
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
70 (lucid, motif, athena, or no).
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
71 --with-dialogs=TYPE Use TYPE dialog boxes (motif, athena, or no).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
72 Lucid menubars and scrollbars are the default.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
73 Motif dialog boxes will be used if Motif can be found.
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
74 --with-widgets=TYPE Use TYPE widgets (motif, athena, or no).
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
75 Motif widgets will be used if Motif can be found.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
76 Other widget types are currently unsupported.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
77 --with-dragndrop (*) Compile in the generic drag and drop API. This is
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
78 automatically added if one of the drag and drop
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
79 protocols is found (currently CDE, OffiX, MSWindows).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
80 *WARNING* The Drag'n'drop support is under development
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
81 and is considered experimental.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
82 --with-cde (*) Compile in support for CDE drag and drop.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
83 --with-offix (*) Compile in support for OffiX drag and drop.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
84 *WARNING* If you compile in OffiX, you may not be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
85 able to use multiple X displays success-
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
86 fully. If the two servers are from
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
87 different vendors, the results may be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
88 unpredictable.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
89 --without-xmu (*) For those unfortunates whose vendors don't ship Xmu.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
90 --external-widget Compile with external widget support.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
91 --with-xpm (*) Compile with support for XPM files.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
92 It is highly recommended that you obtain XPM
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
93 (version 3.4h or better) if you don't already
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
94 have it. Get it from the XEmacs FTP site.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
95 --with-xface (*) Compile with support for X-Face mail header
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
96 conversion. Requires the compface library.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
97 Get it from the XEmacs FTP site.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
98 --without-gif Compile without the built-in support for GIF image
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
99 conversion.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
100 --with-jpeg (*) Compile with support for JPEG image conversion.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
101 Requires libjpeg from the Independent JPEG Group.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
102 Get it from the XEmacs FTP site.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
103 --with-png (*) Compile with support for PNG image conversion.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
104 Requires libpng. Get it from the XEmacs FTP site.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
105 --with-tiff (*) Compile with support for TIFF image conversion.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
106 Requires Sam Lefflier's libtiff library.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
107 Get if from the XEmacs FTP site.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
108
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
109
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
110 TTY options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
111
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
112 --without-tty Don't support TTY-s.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
113 --with-ncurses (*) Use the ncurses library for tty support.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
114 --with-gpm (*) Compile in support for General Purpose Mouse.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
115
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
116
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
117 Additional features:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
118
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
119 --with-tooltalk (*) Support the ToolTalk IPC protocol.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
120 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
121 development environment.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
122 --with-socks Compile with support for SOCKS (an Internet proxy).
221
6c0ae1f9357f Import from CVS: tag r20-4b9
cvs
parents: 219
diff changeset
123 --with-database=TYPE (*) Compile with database support. Valid types are
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
124 `no' or a comma-separated list of one or more
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
125 of `berkdb' and either `dbm' or `gnudbm'.
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
126 --with-sound=TYPE,[TYPE],... Compile with native sound support.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
127 Valid types are `native', `nas' and `esd'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
128 Prefix a type with 'no' to disable.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
129 The first option can be `none' or `all'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
130 `none' is a synonym for `nonative,nonas,noesd'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
131 `all' is a synonym for native,nas,esd or `all'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
132 The default is to autodetect all sound support.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
133 --native-sound-lib=LIB Native sound support library. Needed on Suns
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
134 with --with-sound=both because both sound libraries
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
135 are called libaudio.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
136 --with-pop support POP for mail retrieval
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
137 --with-kerberos support Kerberos-authenticated POP
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
138 --with-hesiod support Hesiod to get the POP server host
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
139 --with-dnet (*) Compile with support for DECnet.
259
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 257
diff changeset
140 --with-ldap (*) Compile with support for the LDAP protocol (requires
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 257
diff changeset
141 installed LDAP libraries on the system).
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 398
diff changeset
142 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS (requires
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 398
diff changeset
143 installed PostreSQL libraries on the system).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
144 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
145 concurrent updates of mail spool files. Valid types
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
146 are `lockf', `flock', and `dot'.
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
147 --with-modules Compile in experimental support for dynamically
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
148 loaded libraries (Dynamic Shared Objects).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
149 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
150 searched before the installation packages.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
151 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
152 which is searched before the installation modules.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
153 --package-path=PATH Directories to search for packages to dump with xemacs.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
154 PATH splits into three parts separated by double
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
155 colons (::), an early, a late, and a last part,
274
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
156 corresponding to their position in the various
380
8626e4521993 Import from CVS: tag r21-2-5
cvs
parents: 373
diff changeset
157 system paths: The early part is always first,
8626e4521993 Import from CVS: tag r21-2-5
cvs
parents: 373
diff changeset
158 the late part somewhere in the middle, and the
274
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
159 last part at the very back.
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
160 Only the late part gets seen at dump time.
380
8626e4521993 Import from CVS: tag r21-2-5
cvs
parents: 373
diff changeset
161 If PATH has only one component, that component
274
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
162 is late.
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
163 If PATH has two components, the first is
ca9a9ec9c1c1 Import from CVS: tag r21-0b35
cvs
parents: 272
diff changeset
164 early, the second is late.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
165 --infodir=DIR Directory to install XEmacs Info manuals and dir in.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
166 --infopath=PATH Directories to search for Info documents, info dir
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
167 and localdir files in case run-time searching
269
b2472a1930f2 Import from CVS: tag r20-5b33
cvs
parents: 265
diff changeset
168 for them fails.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
169 --moduledir=DIR Directory to install dynamic modules in.
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
170 --pdump New, experimental, non-working, don't-sue-me-if-
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
171 your-house-collapses-and-your-wife-goes-away,
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
172 portable dumper.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
173
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
174 Internationalization options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
175
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
176 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
177 needed to support non-Latin-1 (including Asian)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
178 languages.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
179 --with-xim=xlib Compile with support for X input methods,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
180 --with-xim=motif (*) Used in conjunction with Mule support.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
181 Use either raw Xlib to provide XIM support, or
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
182 the Motif XmIm* routines (when available).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
183 NOTE: On some systems bugs in X11's XIM support
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
184 will cause XEmacs to crash, so by default,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
185 no XIM support is compiled in, unless running
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
186 on Solaris and the XmIm* routines are detected.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
187 --with-canna (*) Compile with support for Canna (a Japanese input method
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
188 used in conjunction with Mule support).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
189 --with-wnn (*) Compile with support for WNN (a multi-language input
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
190 method used in conjunction with Mule support).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
191 --with-wnn6 (*) Compile with support for the comercial package WNN
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
192 version 6
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
193 --with-i18n3 Compile with I18N level 3 (support for message
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
194 translation). This doesn't currently work.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
195 --with-xfs Compile with XFontSet support for bilingual menubar.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
196 Can't use this option with --with-xim=motif or xlib.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
197 And should have --with-menubars=lucid.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
198
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
199
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
200 Debugging options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
201
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
202 --debug Compile with support for debugging XEmacs.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
203 (Causes code-size increase and little loss of speed.)
221
6c0ae1f9357f Import from CVS: tag r20-4b9
cvs
parents: 219
diff changeset
204 --error-checking=TYPE[,TYPE]...
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
205 Compile with internal error-checking added.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
206 Causes noticeable loss of speed. Valid types
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
207 are extents, bufpos, malloc, gc, typecheck.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
208 --error-checking=none Disable all internal error-checking (the default).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
209 --error-checking=all Enable all internal error-checking.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
210 --memory-usage-stats Compile with additional code to allow you to
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
211 determine what XEmacs's memory is being used
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
212 for. Causes a small code increase but no loss
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
213 of speed. Normally enabled when --debug is given.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
214 --no-doc-file Don't rebuild the DOC file unless it's explicitly
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
215 deleted. Only use during development. (It speeds
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
216 up the compile-run-test cycle.)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
217 --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
218 int, for the fundamental Lisp_Object type; this
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
219 provides stricter type-checking. Only works with
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
220 some systems and compilers.
392
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
221 --with-quantify Add support for performance debugging using Quantify.
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
222 --with-purify Add support for memory debugging using Purify.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
223
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
224
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
225 Other options:
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
226
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
227 --rel-alloc Use the relocating allocator (default for this option
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
228 is system-dependent).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
229 --with-dlmalloc Control usage of Doug Lea malloc on systems that have
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
230 it in the standard C library (default is to use it if
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
231 it is available).
392
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
232 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
233 --with-debug-malloc Use the debugging malloc package.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
234 --with-clash-detection Use lock files to detect multiple edits of the same
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
235 file. The default is to not do clash detection.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
236 --lockdir=DIR The directory to put clash detection files in, such as
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
237 `/var/lock/emacs'.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
238 Defaults to `${statedir}/xemacs/lock'.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
239
269
b2472a1930f2 Import from CVS: tag r20-5b33
cvs
parents: 265
diff changeset
240 You may also specify any of the `path' variables found in Makefile.in,
398
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
241 including --bindir, --libdir, --docdir, --lispdir, --sitelispdir,
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
242 --datadir, --infodir, --mandir and so on. Note that we recommend
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
243 against explicitly setting any of these variables. See the INSTALL
74fd4e045ea6 Import from CVS: tag r21-2-29
cvs
parents: 392
diff changeset
244 file for a complete list plus the reasons we advise not changing them.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
245
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
246 If successful, configure leaves its status in config.status. If
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
247 unsuccessful after disturbing the status quo, it removes config.status.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
248
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
249 The configure script also recognizes some environment variables, each
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
250 of which is equivalent to a corresponding configure flag. A specified
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
251 configure flag always overrides the environment variable.
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
252
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
253 envvar configure flag
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
254 ----- --------------
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
255 CC --compiler
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
256 CPP --cpp
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
257 CFLAGS --cflags
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
258 CPPFLAGS --cppflags
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
259 LDFLAGS --ldflags
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
260 LIBS --libs
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
261 LD_RUN_PATH --site-runtime-libraries
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
262
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
263 For more details on the install process, consult the INSTALL file.