Mercurial > hg > xemacs-beta

comparison configure.usage @ 215:1f0dabaa0855 r20-4b6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r20-4b6
author cvs
date Mon, 13 Aug 2007 10:07:35 +0200
parents
children d44af0c54775
comparison
equal deleted inserted replaced
214:c5d88c05e1e9 215:1f0dabaa0855
1 Usage: configure CONFIGURATION [[--OPTION[=VALUE] ...]]
2
3 Set compilation and installation parameters for XEmacs, and report.
4 CONFIGURATION specifies the machine and operating system to build for.
5
6 Note that for most of the following options, you can explicitly enable
7 them using `--OPTION=yes' and explicitly disable them using `--OPTION=no'.
8 This is especially useful for auto-detected options.
9
10 Options marked with a (*) are autodetected.
11
12 Use colons (or quoted spaces) to separate directory names in option
13 values which are PATHs (i.e. lists of directories).
14
15 General options:
16
17 --help Issue this usage message.
18 --verbose Display the results of configure tests.
19 --extra-verbose Display even more information, useful for debugging.
20
21
22 Compilation options:
23
24 --compiler=XXXX Specify compiler. Overrides environment variable CC.
25 --with-gcc (*) Use GCC to compile XEmacs.
26 --with-gcc=no Don't use GCC to compile XEmacs.
27 --with-gnu-make Write the Makefiles to take advantage of
28 special features of GNU Make. (GNU Make
29 works fine on the Makefiles even without this
30 option. This just allows for simultaneous
31 in-place and --srcdir building.)
32 --cflags=FLAGS Compiler flags. Overrides environment variable CFLAGS.
33 --site-includes=PATH List of directories to search first for header files.
34 --site-libraries=PATH List of directories to search first for libraries.
35 --site-prefixes=PATH List of directories to search for include/ and lib/
36 subdirectories, just after 'site-includes' and
37 'site-libraries'.
38 --site-runtime-libraries=PATH
39 List of ALL directories to search for dynamically
40 linked libraries at run time.
41 --dynamic=yes Link dynamically if supported by system.
42 --dynamic=no Force static linking on systems where dynamic
43 linking is the default.
44 --srcdir=DIR Look for the XEmacs source files in DIR.
45 See also --with-gnu-make.
46 --const-is-losing=no Allow the use of const in the source code.
47
48
49 Installation options:
50
51 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
52
53
54 Window-system options:
55
56 --with-x11 (*) Support the X Window System.
57 --with-x11=no Don't support X.
58 --x-includes=DIR Search for X header files in DIR.
59 --x-libraries=DIR Search for X libraries in DIR.
60 --with-toolbars=no Don't compile with any toolbar support.
61 --with-session=no Compile without realized leader window which will
62 keep the WM_COMMAND property. Required for proper
63 session-management.
64 --with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid
65 widgets emulate Motif (mostly) but are faster.
66 *WARNING* The Motif menubar is currently broken.
67 --with-scrollbars=TYPE Use TYPE scrollbars
68 (lucid, motif, athena, athena3d, or no).
69 --with-dialogs=TYPE Use TYPE dialog boxes (motif, athena, athena3d, or no).
70 Lucid menubars and scrollbars are the default.
71 Motif dialog boxes will be used if Motif can be found.
72 --with-cde (*) Compile in support for CDE drag and drop.
73 --with-offix (*) Compile in support for OffiX drag and drop.
74 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu.
75 --external-widget Compile with external widget support.
76 --with-gif Compile with support for GIF image conversion.
77 This support is built-in and defaults to `yes'.
78 --with-xpm (*) Compile with support for XPM files.
79 It is highly recommended that you obtain XPM
80 (version 3.4h or better) if you don't already
81 have it. Get it from the XEmacs FTP site.
82 --with-xface (*) Compile with support for X-Face mail header
83 conversion. Requires the compface library.
84 Get it from the XEmacs FTP site.
85 --with-imagick (*) Compile with support for ImageMagick image conversion.
86 Requires ImageMagick from wizards.dupont.com and
87 libraries for whatever image types you wish to have
88 supported.
89 Get it from the XEmacs FTP site.
90
91
92 TTY options:
93
94 --with-tty=no Don't support TTY-s.
95 --with-ncurses (*) Use the ncurses library for tty support.
96 --with-gpm (*) Compile in support for General Purpose Mouse.
97
98
99 Additional features:
100
101 --with-tooltalk (*) Support the ToolTalk IPC protocol.
102 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
103 development environment.
104 --with-energize Support the Lucid Energize development environment.
105 This doesn't currently work.
106 --with-socks Compile with support for SOCKS (an Internet proxy).
107 --with-term Compile with support for TERM (a way to multiplex
108 serial lines and provide vaguely Internet-like
109 functionality over a simple dialup connection,
110 used on Linux and other systems. NOTE: We can't
111 guarantee that our TERM support coexists well
112 with standard Internet connections).
113 --with-database=type (*) Compile with database support. Valid types are
114 `no' or a comma-separated list of one or more
115 of `dbm', `gnudbm', or `berkdb'.
116 --with-sound=native (*) Compile with native sound support.
117 --with-sound=nas Compile with network sound support.
118 --with-sound=both Compile with native and network sound support.
119 --native-sound-lib=LIB Native sound support library. Needed on Suns
120 with --with-sound=both because both sound libraries
121 are called libaudio.
122 --with-pop support POP for mail retrieval
123 --with-kerberos support Kerberos-authenticated POP
124 --with-hesiod support Hesiod to get the POP server host
125 --with-dnet (*) Compile with support for DECnet.
126 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
127 concurrent updates of mail spool files. Valid types
128 are `lockf', `flock', and `file'.
129 --package-path=PATH Directories to search for packages to dump with xemacs.
130 Defaults to `/usr/local/lib/xemacs/packages:~/.xemacs'.
131 --infodir=dir Directory to install the XEmacs Info manuals and dir in.
132 Defaults to: `'.
133 --infopath=PATH Directories to search for Info documents, info dir
134 and localdir files. This is used to initialize
135 `Info-default-directory-list' at dump time.
136 Directories on this path that do not exist in the
137 filesystem will be dropped by the startup code at
138 runtime, so it is safe to specify directories that do
139 not exist in the compilation environment, or that won't
140 exist in the runtime environment. The "dir"
141 file in the first existing directory in this list will
142 become the (dir)Top node of the Info tree.
143 Defaults to the value of `INFOPATH', or:
144 `/usr/local/info:/usr/info:/usr/local/lib/texmf/doc/info:/usr/lib/texmf/doc/
145 info'.
146
147 Internationalization options:
148
149 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
150 needed to suport non-Latin-1 (including Asian) languages.
151 --with-xim=xlib Compile with support for X input methods,
152 --with-xim=motif (*) Used in conjunction with Mule support.
153 Use either raw Xlib to provide XIM support, or
154 the Motif XmIm* routines (when available).
155 NOTE: On some systems bugs in X11's XIM support
156 will cause XEmacs to crash, so by default,
157 no XIM support is compiled in, unless running
158 on Solaris and the XmIm* routines are detected.
159 --with-canna (*) Compile with support for Canna (a Japanese input method
160 used in conjunction with Mule support).
161 --with-wnn (*) Compile with support for WNN (a multi-language input method
162 used in conjunction with Mule support).
163 This is beta level code.
164 --with-wnn6 (*) Compile with support for WNN version 6
165 This is alpha level code.
166 --with-i18n3 Compile with I18N level 3 (support for message
167 translation). This doesn't currently work.
168 --with-xfs Compile with XFontSet support for bilingual menubar.
169 Can't use this option with --with-xim=motif or xlib.
170 And should have --with-menubars=lucid.
171
172
173 Debugging options:
174
175 --debug Compile with support for debugging XEmacs.
176 (Causes code-size increase and little loss of speed.)
177 --error-checking=TYPE[[,TYPE]]...
178 Compile with internal error-checking added.
179 Causes noticeable loss of speed. Valid types
180 are extents, bufpos, malloc, gc, typecheck.
181 --error-checking=none Disable all internal error-checking (the default).
182 --error-checking=all Enable all internal error-checking.
183 --memory-usage-stats Compile with additional code to allow you to
184 determine what XEmacs's memory is being used
185 for. Causes a small code increase but no loss
186 of speed. Normally enabled when --debug is given.
187 --no-doc-file Don't rebuild the DOC file unless it's explicitly
188 deleted. Only use during development. (It speeds
189 up the compile-run-test cycle.)
190 --use-union-type Enable or disable use of a union, instead of an
191 int, for the fundamental Lisp_Object type; this
192 provides stricter type-checking. Only works with
193 some systems and compilers.
194
195
196 Other options:
197
198 --puresize=VALUE Override default amount of space for pure Lisp code.
199 --rel-alloc Use the relocating allocator (default for this option
200 is system-dependent).
201 --with-clash-detection Use lock files to detect multiple edits of the same file.
202 The default is to not do clash detection.
203 --lockdir=dir The directory to put clash detection files in, such as
204 `/var/lock/emacs'.
205 Defaults to `${statedir}/xemacs/lock'.
206 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
207 --with-debug-malloc Use the debugging malloc package.
208
209 You may also specify any of the `path' variables found in
210 Makefile.in, including --bindir, --libdir, --lispdir, --datadir, and
211 so on. Note that we recommend against explicitly setting any of these
212 variables. See the INSTALL file for a complete list plus the reasons
213 we advise not changing them.
214
215 If successful, configure leaves its status in config.status. If
216 unsuccessful after disturbing the status quo, it removes config.status.
217
218 The configure build process also used the following environment variables:
219 CC C compiler to use (but configure flags take precedence)
220 CPP C preprocessor to use (such as /usr/ccs/lib/cpp or cc -E)
221 CFLAGS C compiler compilation flags (such as -O)
222 CPPFLAGS Additional compilation flags (such as -I/foo) used only by the preprocessor
223 LDFLAGS Additional linker flags (such as -L/foo)
224 LIBS Additional libraries (such as -lfoo)
225
226 INFOPATH Path to search for Info documentation.
227
228 For more details on the install process, consult the INSTALL file.