Mercurial > hg > xemacs-beta

comparison configure.usage @ 442:abe6d1db359e r21-2-36

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