Mercurial > hg > xemacs-beta

comparison configure.usage @ 412:697ef44129c6 r21-2-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-2-14
author cvs
date Mon, 13 Aug 2007 11:20:41 +0200
parents de805c49cfc1
children da8ed4261e83
comparison
equal deleted inserted replaced
411:12e008d41344 412:697ef44129c6
7 This is especially useful for auto-detected options. 7 This is especially useful for auto-detected options.
8 The option `--without-FEATURE' is a synonym for `--with-FEATURE=no'. 8 The option `--without-FEATURE' is a synonym for `--with-FEATURE=no'.
9 9
10 Options marked with a (*) are auto-detected. 10 Options marked with a (*) are auto-detected.
11 11
12 Many features require external packages to be installed first.
13 Get them from ftp://ftp.xemacs.org/pub/xemacs/aux.
14
15 Use colons (or quoted spaces) to separate directory names in option 12 Use colons (or quoted spaces) to separate directory names in option
16 values which are PATHs (i.e. lists of directories). 13 values which are PATHs (i.e. lists of directories).
17 14
18 The results of configure tests are saved in config.log, which is useful
19 for diagnosing problems.
20
21
22 General options: 15 General options:
23 16
24 --help Issue this usage message. 17 --help Issue this usage message.
25 --verbose Accepted but ignored. 18 --verbose Display the results of configure tests.
26 --extra-verbose Display more information, useful for debugging. 19 --extra-verbose Display even more information, useful for debugging.
27 20
28 21
29 Compilation options: 22 Compilation options:
30 23
31 --compiler=PROG C compiler to use 24 --compiler=prog C compiler to use.
32 --with-gcc (*) Use GCC to compile XEmacs. 25 --with-gcc (*) Use GCC to compile XEmacs.
26 --without-gcc Don't use GCC to compile XEmacs.
33 --cflags=FLAGS Compiler flags (such as -O) 27 --cflags=FLAGS Compiler flags (such as -O)
34 --cpp=PROG C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E) 28 --cpp=prog C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
35 --cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar) 29 --cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
36 --libs=LIBS Additional libraries (e.g. -lfoo) 30 --libs=LIBS Additional libraries (e.g. -lfoo)
37 --ldflags=FLAGS Additional linker flags (e.g. -L/foo) 31 --ldflags=FLAGS Additional linker flags (e.g. -L/foo)
38 --site-includes=PATH List of directories to search first for header files 32 --site-includes=PATH List of directories to search first for header files.
39 --site-libraries=PATH List of directories to search first for libraries 33 --site-libraries=PATH List of directories to search first for libraries.
40 --site-prefixes=PATH List of directories to search for include/ and lib/ 34 --site-prefixes=PATH List of directories to search for include/ and lib/
41 subdirectories, just after 'site-includes' and 35 subdirectories, just after 'site-includes' and
42 'site-libraries' 36 'site-libraries'.
43 --site-runtime-libraries=PATH 37 --site-runtime-libraries=PATH
44 List of ALL directories to search for dynamically 38 List of ALL directories to search for dynamically
45 linked libraries at run time 39 linked libraries at run time.
46 --dynamic=yes Link dynamically if supported by system. 40 --dynamic=yes Link dynamically if supported by system.
47 --dynamic=no Force static linking on systems where dynamic 41 --dynamic=no Force static linking on systems where dynamic
48 linking is the default. 42 linking is the default.
49 --srcdir=DIR Look for the XEmacs source files in DIR. 43 --srcdir=DIR Look for the XEmacs source files in DIR.
50 Works best when using GNU Make. 44 Works best when using GNU Make.
51 45
52 46
53 Installation options: 47 Installation options:
54 48
55 --prefix=DIR Install files below DIR. Defaults to `/usr/local'. 49 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
56 --with-prefix=no Don't compile the value of --prefix into the
57 executable.
58 50
59 51
60 Window-system options: 52 Window-system options:
61 53
62 --with-x11 (*) Support the X Window System. 54 --with-x11 (*) Support the X Window System.
55 --without-x11 Don't support X.
63 --x-includes=DIR Search for X header files in DIR. 56 --x-includes=DIR Search for X header files in DIR.
64 --x-libraries=DIR Search for X libraries in DIR. 57 --x-libraries=DIR Search for X libraries in DIR.
65 --with-msw (*) Support MS Windows as a window system (only under 58 --without-toolbars Don't compile with any toolbar support.
66 Cygwin and MinGW). 59 --without-session Compile without realized leader window which will
67 --with-toolbars=no Don't compile with any toolbar support. 60 keep the WM_COMMAND property. Required for proper
68 --with-wmcommand=no Compile without realized leader window which will 61 session-management.
69 keep the WM_COMMAND property.
70 --with-athena=TYPE Use TYPE Athena widgets
71 (xaw, 3d, next, 95, or xpm)
72 --with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid 62 --with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid
73 widgets emulate Motif (mostly) but are faster. 63 widgets emulate Motif (mostly) but are faster.
74 *WARNING* The Motif menubar is currently broken. 64 *WARNING* The Motif menubar is currently broken.
75 --with-scrollbars=TYPE Use TYPE scrollbars 65 --with-scrollbars=TYPE Use TYPE scrollbars
76 (lucid, motif, athena, or no). 66 (lucid, motif, athena, athena3d, or no).
77 --with-dialogs=TYPE Use TYPE dialog boxes (motif, athena, or no). 67 --with-dialogs=TYPE Use TYPE dialog boxes (motif, athena, athena3d, or no).
78 Lucid menubars and scrollbars are the default. 68 Lucid menubars and scrollbars are the default.
79 Motif dialog boxes will be used if Motif can be found. 69 Motif dialog boxes will be used if Motif can be found.
80 --with-widgets=TYPE Use TYPE widgets (motif, athena, or no). 70 --with-dragndrop (*) Compile in the generic drag and drop API. This is
81 Motif widgets will be used if Motif can be found.
82 Other widget types are currently unsupported.
83 --with-dragndrop Compile in the generic drag and drop API. This is
84 automatically added if one of the drag and drop 71 automatically added if one of the drag and drop
85 protocols is found (currently CDE, OffiX, MSWindows). 72 protocols is found (currently CDE, OffiX, MSWindows).
86 *WARNING* The Drag'n'drop support is under development 73 *WARNING* The Drag'n'drop support is under development
87 and is considered experimental. 74 and is considered experimental.
88 --with-cde Compile in support for CDE drag and drop. 75 --with-cde (*) Compile in support for CDE drag and drop.
89 --with-offix Compile in support for OffiX drag and drop. 76 --with-offix (*) Compile in support for OffiX drag and drop.
90 *WARNING* If you compile in OffiX, you may not be 77 *WARNING* If you compile in OffiX, you may not be
91 able to use multiple X displays success- 78 able to use multiple X displays success-
92 fully. If the two servers are from 79 fully. If the two servers are from
93 different vendors, the results may be 80 different vendors, the results may be
94 unpredictable. 81 unpredictable.
95 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu. 82 --without-xmu (*) For those unfortunates whose vendors don't ship Xmu.
96 --external-widget Compile with external widget support. 83 --external-widget Compile with external widget support.
97 84 --with-xpm (*) Compile with support for XPM files.
98 85 It is highly recommended that you obtain XPM
99 TTY (character terminal) options: 86 (version 3.4h or better) if you don't already
100 87 have it. Get it from the XEmacs FTP site.
101 --with-tty=no Don't support ttys. 88 --with-xface (*) Compile with support for X-Face mail header
89 conversion. Requires the compface library.
90 Get it from the XEmacs FTP site.
91 --without-gif Compile without the built-in support for GIF image
92 conversion.
93 --with-jpeg (*) Compile with support for JPEG image conversion.
94 Requires libjpeg from the Independent JPEG Group.
95 Get it from the XEmacs FTP site.
96 --with-png (*) Compile with support for PNG image conversion.
97 Requires libpng. Get it from the XEmacs FTP site.
98 --with-tiff (*) Compile with support for TIFF image conversion.
99 Requires Sam Lefflier's libtiff library.
100 Get if from the XEmacs FTP site.
101
102
103 TTY options:
104
105 --without-tty Don't support TTY-s.
102 --with-ncurses (*) Use the ncurses library for tty support. 106 --with-ncurses (*) Use the ncurses library for tty support.
103 --with-gpm (*) Compile in GPM mouse support for ttys. 107 --with-gpm (*) Compile in support for General Purpose Mouse.
104
105
106 Image options:
107
108 --with-xpm (*) Compile with support for XPM images. PRACTICALLY
109 REQUIRED. Although this library is nonstandard and
110 a real hassle to build, many basic things (e.g.
111 toolbars) depend on it, and you will run into
112 many problems without it.
113 --with-png (*) Compile with support for PNG images. Recommended
114 because the images on the About page are not viewable
115 without it.
116 --with-jpeg (*) Compile with support for JPEG images. Useful if
117 you are using a mail, news reader, or web browser
118 in XEmacs, so that JPEG images can be displayed.
119 --with-tiff (*) Compile with support for TIFF images. Possibly
120 useful, for the same reason as JPEG images.
121 --with-xface (*) Compile with support for X-Face mail headers.
122 Requires the compface package. Of doubtful
123 usefulness.
124 --with-gif=no Compile without the (builtin) support for GIF images.
125
126
127 Sound options:
128
129 --with-sound=TYPE,[TYPE],... Compile with native sound support.
130 Valid types are `native', `nas' and `esd'.
131 Prefix a type with 'no' to disable.
132 The first option can be `none' or `all'.
133 `none' is a synonym for `nonative,nonas,noesd'.
134 `all' is a synonym for native,nas,esd or `all'.
135 The default is to autodetect all sound support.
136 --native-sound-lib=LIB Native sound support library. Needed on Suns
137 with --with-sound=both because both sound libraries
138 are called libaudio.
139
140
141 Database options:
142
143 --with-database=TYPE (*) Compile with database support. Valid types are
144 `no' or a comma-separated list of one or more
145 of `berkdb' and either `dbm' or `gnudbm'.
146 --with-ldap (*) Compile with support for the LDAP protocol.
147 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
148
149
150 Mail options:
151
152 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
153 concurrent updates of mail spool files. Valid types
154 are `lockf', `flock', and `dot'.
155 --with-pop Support POP for mail retrieval.
156 --with-kerberos Support Kerberos-authenticated POP.
157 --with-hesiod Support Hesiod to get the POP server host.
158 108
159 109
160 Additional features: 110 Additional features:
161 111
162 --with-tooltalk (*) Support the ToolTalk IPC protocol. 112 --with-tooltalk (*) Support the ToolTalk IPC protocol.
163 --with-workshop Support the Sun WorkShop (formerly Sparcworks) 113 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
164 development environment. 114 development environment.
165 --with-socks Compile with support for SOCKS (an Internet proxy). 115 --with-socks Compile with support for SOCKS (an Internet proxy).
116 --with-database=TYPE (*) Compile with database support. Valid types are
117 `no' or a comma-separated list of one or more
118 of `berkdb' and either `dbm' or `gnudbm'.
119 --with-sound=native (*) Compile with native sound support.
120 --with-sound=nas Compile with network sound support.
121 --with-sound=both Compile with native and network sound support.
122 --native-sound-lib=LIB Native sound support library. Needed on Suns
123 with --with-sound=both because both sound libraries
124 are called libaudio.
125 --with-pop support POP for mail retrieval
126 --with-kerberos support Kerberos-authenticated POP
127 --with-hesiod support Hesiod to get the POP server host
166 --with-dnet (*) Compile with support for DECnet. 128 --with-dnet (*) Compile with support for DECnet.
167 --with-modules Compile in experimental support for dynamically 129 --with-ldap (*) Compile with support for the LDAP protocol (requires
168 loaded libraries (Dynamic Shared Objects). 130 installed LDAP libraries on the system).
131 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
132 concurrent updates of mail spool files. Valid types
133 are `lockf', `flock', and `file'.
169 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy 134 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
170 searched before the installation packages. 135 searched before the installation packages.
171 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy, 136 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
172 which is searched before the installation modules. 137 which is searched before the installation modules.
173 --package-path=PATH Directories to search for packages to dump with xemacs. 138 --package-path=PATH Directories to search for packages to dump with xemacs.
185 --infodir=DIR Directory to install XEmacs Info manuals and dir in. 150 --infodir=DIR Directory to install XEmacs Info manuals and dir in.
186 --infopath=PATH Directories to search for Info documents, info dir 151 --infopath=PATH Directories to search for Info documents, info dir
187 and localdir files in case run-time searching 152 and localdir files in case run-time searching
188 for them fails. 153 for them fails.
189 --moduledir=DIR Directory to install dynamic modules in. 154 --moduledir=DIR Directory to install dynamic modules in.
190 --pdump New, experimental, non-working, don't-sue-me-if-
191 your-house-collapses-and-your-wife-leaves-you,
192 portable dumper.
193 155
194 Internationalization options: 156 Internationalization options:
195 157
196 --with-mule Compile with Mule (MUlti-Lingual Emacs) support, 158 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
197 needed to support non-Latin-1 (including Asian) 159 needed to support non-Latin-1 (including Asian)
206 on Solaris and the XmIm* routines are detected. 168 on Solaris and the XmIm* routines are detected.
207 --with-canna (*) Compile with support for Canna (a Japanese input method 169 --with-canna (*) Compile with support for Canna (a Japanese input method
208 used in conjunction with Mule support). 170 used in conjunction with Mule support).
209 --with-wnn (*) Compile with support for WNN (a multi-language input 171 --with-wnn (*) Compile with support for WNN (a multi-language input
210 method used in conjunction with Mule support). 172 method used in conjunction with Mule support).
211 --with-wnn6 (*) Compile with support for the commercial package WNN6. 173 --with-wnn6 (*) Compile with support for the comercial package WNN
174 version 6
212 --with-i18n3 Compile with I18N level 3 (support for message 175 --with-i18n3 Compile with I18N level 3 (support for message
213 translation). This doesn't currently work. 176 translation). This doesn't currently work.
214 --with-xfs Compile with XFontSet support for bilingual menubar. 177 --with-xfs Compile with XFontSet support for bilingual menubar.
215 Can't use this option with --with-xim=motif or xlib. 178 Can't use this option with --with-xim=motif or xlib.
216 And should have --with-menubars=lucid. 179 And should have --with-menubars=lucid.
249 it in the standard C library (default is to use it if 212 it in the standard C library (default is to use it if
250 it is available). 213 it is available).
251 --with-system-malloc Force use of the system malloc, rather than GNU malloc. 214 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
252 --with-debug-malloc Use the debugging malloc package. 215 --with-debug-malloc Use the debugging malloc package.
253 --with-clash-detection Use lock files to detect multiple edits of the same 216 --with-clash-detection Use lock files to detect multiple edits of the same
254 file. The default is to do clash detection. 217 file. The default is to not do clash detection.
255 --lockdir=DIR The directory to put clash detection files in, such as 218 --lockdir=DIR The directory to put clash detection files in, such as
256 `/var/lock/emacs'. 219 `/var/lock/emacs'.
257 Defaults to `${statedir}/xemacs/lock'. 220 Defaults to `${statedir}/xemacs/lock'.
258 221
259 You may also specify any of the `path' variables found in Makefile.in, 222 You may also specify any of the `path' variables found in Makefile.in,
260 including --bindir, --libdir, --docdir, --lispdir, --sitelispdir, 223 including --bindir, --libdir, --lispdir, --sitelispdir, --datadir,
261 --datadir, --infodir, --mandir and so on. Note that we recommend 224 --infodir, --mandir and so on. Note that we recommend against
262 against explicitly setting any of these variables. See the INSTALL 225 explicitly setting any of these variables. See the INSTALL file for a
263 file for a complete list plus the reasons we advise not changing them. 226 complete list plus the reasons we advise not changing them.
264 227
265 If successful, configure leaves its status in config.status. If 228 If successful, configure leaves its status in config.status. If
266 unsuccessful after disturbing the status quo, it removes config.status. 229 unsuccessful after disturbing the status quo, it removes config.status.
267 230
268 The configure script also recognizes some environment variables, each 231 The configure script also recognizes some environment variables, each
269 of which is equivalent to a corresponding configure flag. Configure 232 of which is equivalent to a corresponding configure flag. A specified
270 flags take precedence over environment variables, if both are specified. 233 configure flag always overrides the environment variable.
271 234
272 environment corresponding 235 envvar configure flag
273 variable configure flag 236 ----- --------------
274 ----------- -------------- 237 CC --compiler
275 CC --compiler 238 CPP --cpp
276 CPP --cpp 239 CFLAGS --cflags
277 CFLAGS --cflags 240 CPPFLAGS --cppflags
278 CPPFLAGS --cppflags 241 LDFLAGS --ldflags
279 LDFLAGS --ldflags 242 LIBS --libs
280 LIBS --libs 243 LD_RUN_PATH --site-runtime-libraries
281 LD_RUN_PATH --site-runtime-libraries
282 244
283 For more details on the install process, consult the INSTALL file. 245 For more details on the install process, consult the INSTALL file.