Mercurial > hg > xemacs-beta

comparison configure.usage @ 410:de805c49cfc1 r21-2-35

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-2-35
author cvs
date Mon, 13 Aug 2007 11:19:21 +0200
parents b8cc9ab3f761
children 697ef44129c6
comparison
equal deleted inserted replaced
409:301b9ebbdf3b 410:de805c49cfc1
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 97
92 98
93 TTY options: 99 TTY (character terminal) options:
94 100
95 --without-tty Don't support TTY-s. 101 --with-tty=no Don't support ttys.
96 --with-ncurses (*) Use the ncurses library for tty support. 102 --with-ncurses (*) Use the ncurses library for tty support.
97 --with-gpm (*) Compile in support for General Purpose Mouse. 103 --with-gpm (*) Compile in GPM mouse support for ttys.
98 104
99 105
100 Image options: 106 Image options:
101 107
102 --with-xpm (*) Compile with support for XPM files. 108 --with-xpm (*) Compile with support for XPM images. PRACTICALLY
103 It is highly recommended that you obtain XPM 109 REQUIRED. Although this library is nonstandard and
104 (version 3.4h or better) if you don't already 110 a real hassle to build, many basic things (e.g.
105 have it. Get it from the XEmacs FTP site. 111 toolbars) depend on it, and you will run into
106 --with-xface (*) Compile with support for X-Face mail header 112 many problems without it.
107 conversion. Requires the compface library. 113 --with-png (*) Compile with support for PNG images. Recommended
108 Get it from the XEmacs FTP site. 114 because the images on the About page are not viewable
109 --without-gif Compile without the built-in support for GIF image 115 without it.
110 conversion. 116 --with-jpeg (*) Compile with support for JPEG images. Useful if
111 --with-jpeg (*) Compile with support for JPEG image conversion. 117 you are using a mail, news reader, or web browser
112 Requires libjpeg from the Independent JPEG Group. 118 in XEmacs, so that JPEG images can be displayed.
113 Get it from the XEmacs FTP site. 119 --with-tiff (*) Compile with support for TIFF images. Possibly
114 --with-png (*) Compile with support for PNG image conversion. 120 useful, for the same reason as JPEG images.
115 Requires libpng. Get it from the XEmacs FTP site. 121 --with-xface (*) Compile with support for X-Face mail headers.
116 --with-tiff (*) Compile with support for TIFF image conversion. 122 Requires the compface package. Of doubtful
117 Requires Sam Lefflier's libtiff library. 123 usefulness.
118 Get if from the XEmacs FTP site. 124 --with-gif=no Compile without the (builtin) support for GIF images.
119 125
120 126
121 Sound options: 127 Sound options:
122 128
123 --with-sound=TYPE,[TYPE],... Compile with native sound support. 129 --with-sound=TYPE,[TYPE],... Compile with native sound support.
124 Valid types are `native', `nas' and `esd'. 130 Valid types are `native', `nas' and `esd'.
125 Prefix a type with 'no' to disable. 131 Prefix a type with 'no' to disable.
126 The first option can be `none' or `all'. 132 The first option can be `none' or `all'.
127 `none' is a synonym for `nonative,nonas,noesd'. 133 `none' is a synonym for `nonative,nonas,noesd'.
128 `all' is a synonym for native,nas,esd or `all'. 134 `all' is a synonym for native,nas,esd or `all'.
129 The default is to autodetect all sound support. 135 The default is to autodetect all sound support.
130 --native-sound-lib=LIB Native sound support library. Needed on Suns 136 --native-sound-lib=LIB Native sound support library. Needed on Suns
131 with --with-sound=both because both sound libraries 137 with --with-sound=both because both sound libraries
132 are called libaudio. 138 are called libaudio.
133 139
134 140
135 Database options: 141 Database options:
136 142
137 --with-database=TYPE (*) Compile with database support. Valid types are 143 --with-database=TYPE (*) Compile with database support. Valid types are
138 `no' or a comma-separated list of one or more 144 `no' or a comma-separated list of one or more
139 of `berkdb' and either `dbm' or `gnudbm'. 145 of `berkdb' and either `dbm' or `gnudbm'.
140 --with-ldap (*) Compile with support for the LDAP protocol (requires 146 --with-ldap (*) Compile with support for the LDAP protocol.
141 installed LDAP libraries on the system). 147 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
142 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS (requires
143 installed PostreSQL libraries on the system).
144 148
145 149
146 Mail options: 150 Mail options:
147 151
148 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent 152 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
149 concurrent updates of mail spool files. Valid types 153 concurrent updates of mail spool files. Valid types
150 are `lockf', `flock', and `dot'. 154 are `lockf', `flock', and `dot'.
151 --with-pop support POP for mail retrieval 155 --with-pop Support POP for mail retrieval.
152 --with-kerberos support Kerberos-authenticated POP 156 --with-kerberos Support Kerberos-authenticated POP.
153 --with-hesiod support Hesiod to get the POP server host 157 --with-hesiod Support Hesiod to get the POP server host.
154 158
155 159
156 Additional features: 160 Additional features:
157 161
158 --with-tooltalk (*) Support the ToolTalk IPC protocol. 162 --with-tooltalk (*) Support the ToolTalk IPC protocol.
159 --with-workshop Support the Sun WorkShop (formerly Sparcworks) 163 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
160 development environment. 164 development environment.
161 --with-socks Compile with support for SOCKS (an Internet proxy). 165 --with-socks Compile with support for SOCKS (an Internet proxy).
162 --with-dnet (*) Compile with support for DECnet. 166 --with-dnet (*) Compile with support for DECnet.
163 --with-modules Compile in experimental support for dynamically 167 --with-modules Compile in experimental support for dynamically
164 loaded libraries (Dynamic Shared Objects). 168 loaded libraries (Dynamic Shared Objects).
165 --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
166 searched before the installation packages. 170 searched before the installation packages.
167 --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,
168 which is searched before the installation modules. 172 which is searched before the installation modules.
169 --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.
181 --infodir=DIR Directory to install XEmacs Info manuals and dir in. 185 --infodir=DIR Directory to install XEmacs Info manuals and dir in.
182 --infopath=PATH Directories to search for Info documents, info dir 186 --infopath=PATH Directories to search for Info documents, info dir
183 and localdir files in case run-time searching 187 and localdir files in case run-time searching
184 for them fails. 188 for them fails.
185 --moduledir=DIR Directory to install dynamic modules in. 189 --moduledir=DIR Directory to install dynamic modules in.
186 --pdump New, experimental, non-working, don't-sue-me-if- 190 --pdump New, experimental, non-working, don't-sue-me-if-
187 your-house-collapses-and-your-wife-goes-away, 191 your-house-collapses-and-your-wife-leaves-you,
188 portable dumper. 192 portable dumper.
189 193
190 Internationalization options: 194 Internationalization options:
191 195
192 --with-mule Compile with Mule (MUlti-Lingual Emacs) support, 196 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
193 needed to support non-Latin-1 (including Asian) 197 needed to support non-Latin-1 (including Asian)
202 on Solaris and the XmIm* routines are detected. 206 on Solaris and the XmIm* routines are detected.
203 --with-canna (*) Compile with support for Canna (a Japanese input method 207 --with-canna (*) Compile with support for Canna (a Japanese input method
204 used in conjunction with Mule support). 208 used in conjunction with Mule support).
205 --with-wnn (*) Compile with support for WNN (a multi-language input 209 --with-wnn (*) Compile with support for WNN (a multi-language input
206 method used in conjunction with Mule support). 210 method used in conjunction with Mule support).
207 --with-wnn6 (*) Compile with support for the comercial package WNN 211 --with-wnn6 (*) Compile with support for the commercial package WNN6.
208 version 6
209 --with-i18n3 Compile with I18N level 3 (support for message 212 --with-i18n3 Compile with I18N level 3 (support for message
210 translation). This doesn't currently work. 213 translation). This doesn't currently work.
211 --with-xfs Compile with XFontSet support for bilingual menubar. 214 --with-xfs Compile with XFontSet support for bilingual menubar.
212 Can't use this option with --with-xim=motif or xlib. 215 Can't use this option with --with-xim=motif or xlib.
213 And should have --with-menubars=lucid. 216 And should have --with-menubars=lucid.
261 264
262 If successful, configure leaves its status in config.status. If 265 If successful, configure leaves its status in config.status. If
263 unsuccessful after disturbing the status quo, it removes config.status. 266 unsuccessful after disturbing the status quo, it removes config.status.
264 267
265 The configure script also recognizes some environment variables, each 268 The configure script also recognizes some environment variables, each
266 of which is equivalent to a corresponding configure flag. A specified 269 of which is equivalent to a corresponding configure flag. Configure
267 configure flag always overrides the environment variable. 270 flags take precedence over environment variables, if both are specified.
268 271
269 envvar configure flag 272 environment corresponding
270 ----- -------------- 273 variable configure flag
271 CC --compiler 274 ----------- --------------
272 CPP --cpp 275 CC --compiler
273 CFLAGS --cflags 276 CPP --cpp
274 CPPFLAGS --cppflags 277 CFLAGS --cflags
275 LDFLAGS --ldflags 278 CPPFLAGS --cppflags
276 LIBS --libs 279 LDFLAGS --ldflags
277 LD_RUN_PATH --site-runtime-libraries 280 LIBS --libs
281 LD_RUN_PATH --site-runtime-libraries
278 282
279 For more details on the install process, consult the INSTALL file. 283 For more details on the install process, consult the INSTALL file.