Mercurial > hg > xemacs-beta
annotate INSTALL @ 4782:1523f1d28be1
Remove more obsolete files. See xemacs-patches message with ID
<870180fe0912180909u1016b0c6ka10ea5b1564124a0@mail.gmail.com>.
| author | Jerry James <james@xemacs.org> |
|---|---|
| date | Fri, 18 Dec 2009 10:09:54 -0700 |
| parents | 5460287a3327 |
| children | d6cfba1cc388 |
| rev | line source |
|---|---|
| 0 | 1 XEmacs Installation Guide |
| 1338 | 2 |
| 0 | 3 Copyright (c) 1994, 1995, 1996 Board of Trustees, University of Illinois |
|
4508
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
4 Copyright (c) 1994-1999, 2003, 2008 Free Software Foundation, Inc. |
| 412 | 5 |
| 0 | 6 Permission is granted to anyone to make or distribute verbatim copies |
| 7 of this document as received, in any medium, provided that the | |
| 8 copyright notice and permission notice are preserved, | |
| 9 and that the distributor grants the recipient permission | |
| 10 for further redistribution as permitted by this notice. | |
| 11 | |
| 12 Permission is granted to distribute modified versions | |
| 13 of this document, or of portions of it, | |
| 14 under the above conditions, provided also that they | |
| 15 carry prominent notices stating who last changed them, | |
| 16 and that any new or changed statements about the activities | |
| 17 of the Free Software Foundation are approved by the Foundation. | |
| 18 | |
| 442 | 19 BUILDING AND INSTALLATION FOR UNIX AND CYGWIN |
| 20 | |
| 21 (for Microsoft Windows, see nt/README also.) | |
| 22 | |
| 23 PREREQUISITES | |
| 24 ============= | |
| 404 | 25 |
| 442 | 26 Make sure your system has enough swapping space allocated to handle a |
| 27 program whose pure code is 900k bytes and whose data area is at least | |
| 1338 | 28 400k and can reach 8Mb or more. Note that a typical XEmacs process |
| 29 can get much bigger: the instance this sentence was written with is | |
| 30 over 100MB! If the swapping space is insufficient, you will get an | |
| 442 | 31 error in the command `temacs -batch -l loadup dump', found in |
| 32 `./src/Makefile.in.in', or possibly when running the final dumped | |
| 33 XEmacs. | |
| 0 | 34 |
| 442 | 35 Verify that your users have a high enough stack limit. On some systems |
| 1036 | 36 such as OpenBSD and OSF/Tru64 the default is 2MB which is too low. On |
| 2648 | 37 MacOS/X (Darwin) before 10.3, it's 512kB. See 'PROBLEMS' for details. |
| 424 | 38 |
| 39 Building XEmacs requires about 100 Mb of disk space (including the | |
| 1338 | 40 XEmacs sources). Once installed, XEmacs occupies between 20 and 100 |
| 41 MB in the file system where it is installed; this includes the | |
| 42 executable files, Lisp libraries, miscellaneous data files, and | |
| 43 on-line documentation. The exact amount depends greatly on the number | |
| 44 of extra Lisp packages that are installed. | |
| 149 | 45 |
| 2427 | 46 XEmacs requires an ANSI C compiler, such as GCC. If you wish to build the |
| 47 documentation yourself, you will need at least version 1.68 of makeinfo (GNU | |
| 48 texinfo-3.11). GNU Texinfo 4.2 is recommended; it is necessary for building | |
| 49 Lisp packages, and we may move to it for the core. | |
| 149 | 50 |
| 1338 | 51 A note on terminology: unfortunately the terms "library" and "package" |
| 52 are heavily overloaded. In the following, "library" refers to an | |
| 53 external body of executable code which may be linked with XEmacs at | |
| 54 build time to provide support for system features, such as images, | |
| 55 audio, stream compression, databases, and input methods. A "Lisp | |
| 56 library" is a file of Lisp code which may be loaded into XEmacs at | |
| 57 run-time to provide editor features. A "package" is a specially | |
| 58 prepared Lisp library or set of Lisp libraries, providing for easy | |
| 59 installation, upgrade, and removal of applications written in Lisp. | |
| 398 | 60 |
| 442 | 61 PACKAGE SYSTEM |
| 62 ============== | |
| 424 | 63 |
|
4508
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
64 The FAQ sections 1.7 and 2.1 contain information vital to have a fully |
| 1338 | 65 working XEmacs. It includes a description of available packages, and |
| 66 how to bootstrap XEmacs from a minimal or a complete set of packages. | |
| 67 This information was not included in this file only because it is too | |
|
4508
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
68 large for this terse INSTALL. The FAQ is available in Texinfo format |
|
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
69 in man/xemacs-faq.texi, as an Info file once you build XEmacs, and |
|
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
70 online at http://www.xemacs.org/Documentation/21.5/html/xemacs-faq_1.html. |
| 1338 | 71 |
| 72 ADD-ON LIBRARIES | |
| 73 ================ | |
| 74 | |
| 75 Decide which libraries you would like to use with XEmacs, but are not | |
| 1375 | 76 yet available on your system. On some systems, X11, Motif and CDE are |
| 3018 | 77 optional additions. On MacOS/X systems prior to 10.2, you may download |
| 78 X11R6 for Mac OS X from http://www.apple.com/macosx/x11/download/. In | |
| 79 later releases X11 is available as an optional package on the | |
| 80 installation CDs. In either case you need both the runtime libraries | |
| 81 and the SDK (in a sidebar of that page at the time of writing). There | |
| 82 is also a 3rd-party implementation of X11R6 for the Mac at | |
| 83 http://www.xdarwin.org/. On Solaris, the SUNWaudmo package enables | |
| 84 native sound support. There are also a number of free software | |
| 85 applications that XEmacs can use. If these are not yet available on | |
| 86 your system, obtain, build and install those external libraries before | |
| 87 building XEmacs. The libraries XEmacs can use are: | |
| 1338 | 88 |
| 89 Xaw3d, XPM, JPEG, compface, PNG, zlib, GNU DBM, Berkeley DB, socks, | |
| 90 term, NAS, Canna, Kinput2, SJ3, Wnn, PostgreSQL, LDAP. | |
| 91 | |
| 92 You can get (most of) them from the XEmacs FTP archive at | |
| 93 <ftp://ftp.xemacs.org/pub/xemacs/aux>. Information about what | |
| 94 each library does is available in the file | |
| 95 <ftp://ftp.xemacs.org/pub/xemacs/aux/00README.txt>. | |
| 96 | |
| 2648 | 97 Use the `--with-site-includes' and `--with-site-libraries' options when |
| 98 building XEmacs to allow configure to find the external software | |
| 99 packages. For your convenience these can be set together by using the | |
| 100 `--with-site-prefixes' option. This will set these variables as needed | |
| 1338 | 101 assuming your libraries are organised as a typical /usr tree. |
| 102 | |
| 103 If you link dynamically with external libraries, usually denoted by | |
| 2648 | 104 ".so" (Unix), ".dll" (Windows), or ".dylib" (MacOS) file extensions, on |
| 105 some systems you may also need to add the library directories to the | |
| 106 `--with-site-runtime-libraries' option. It is typically necessary only | |
| 1338 | 107 if you link with dynamic libraries that are installed in non-standard |
| 2648 | 108 directories, or if you expect some of the libraries used to build XEmacs |
| 109 to be in a different directory at run time than at build time. | |
| 1338 | 110 |
| 111 NOTE: This option has unusual semantics. ONLY libraries found in the | |
| 112 directories specified in this option will be used at runtime. This | |
| 113 means you must specify ALL directories you want searched at runtime in | |
| 114 this option (perhaps excluding a very small number of standard system | |
| 115 library paths). | |
| 116 | |
| 2648 | 117 Directories specified with `--with-site-libraries' are NOT automatically |
| 118 added. The rationale is that most users will not need this option, and | |
| 119 this allows the builder to specify exactly the needed directories. | |
| 120 Specifying unnecessary directories leads to obscure problems (typically | |
| 121 startup delays) if those directories are mounted over a network, and the | |
| 122 automounter configuration changes. Not all systems need this option; | |
| 123 it's best to avoid using it if you can. | |
| 1338 | 124 |
| 125 Dynamic linking has pros and cons. Dynamically linking 3rd party | |
| 126 libraries to XEmacs decreases the size of the binary, and means you | |
| 127 don't need to rebuild XEmacs to take advantage of improvements in the | |
| 128 libraries. On the other hand, XEmacs can fail subtly if the semantics | |
| 129 of a library changes, other users may not be able to use your | |
| 130 "private" copies of the libraries, and you may have to relink XEmacs, | |
| 131 or even omit the feature, if the ABI changes when the libraries are | |
| 132 upgraded. | |
| 424 | 133 |
| 442 | 134 CONFIGURATION OPTIONS |
| 135 ===================== | |
| 269 | 136 |
| 442 | 137 In the top level directory of the XEmacs distribution, run the |
| 138 program `configure' as follows: | |
| 0 | 139 |
| 149 | 140 ./configure [CONFIGURATION-NAME] [--OPTION[=VALUE]] ... |
| 0 | 141 |
| 3018 | 142 Options are generally of the form `--with-FEATURE' or |
| 143 `--enable-FEATURE' to use a feature or `--without-FEATURE' or | |
| 144 `--disable-FEATURE' to not use a feature. Unlike the `configure' | |
| 145 program used in other applications, either `--with-FEATURE' or | |
| 146 `--enable-FEATURE' can be used to use the same feature. | |
| 147 | |
| 3050 | 148 If you haven't built XEmacs 21.5 recently, the change from the |
| 149 configure script based on Autoconf 2.13 can be a shock. Appendix: | |
| 150 Correspondence to Old Configure Options (at the end of this document) | |
| 151 contains a list of old options and their new equivalents. | |
| 152 | |
| 1338 | 153 Controlling the Host Type |
| 154 ------------------------- | |
| 155 | |
| 243 | 156 Almost always, you should let `configure' (actually the shell script |
| 157 `config.guess') guess your host type, by omitting the | |
| 149 | 158 CONFIGURATION-NAME argument. If you like to experiment, specify a |
| 159 configuration name in the form MACHINE-VENDOR-OPSYS, for example: | |
| 160 | |
| 161 sparc-sun-solaris2.6 | |
| 162 | |
| 163 See config.guess and configure.in for valid values for MACHINE, | |
| 164 VENDOR, and OPSYS. Also check `./etc/MACHINES' for advice on building | |
| 165 on particular machines. | |
| 0 | 166 |
| 1338 | 167 Specifying Location of Headers and Libraries |
| 168 -------------------------------------------- | |
| 169 | |
| 2648 | 170 The `--with-site-includes=DIR' and `--with-site-libraries=DIR' options |
| 171 allow you to specify additional places the compiler should look for | |
| 172 include files and object libraries. You may specify multiple DIR's by | |
| 1338 | 173 enclosing the list in quotes. All the external libraries you want to |
| 174 use with XEmacs (e.g. xpm, wnn, ...) described later should have their | |
| 175 include and library directories defined using these options. | |
| 176 | |
| 2648 | 177 The `--with-site-runtime-libraries=DIR' option specifies directories to |
| 1338 | 178 search for shared libraries at run time. If you use this option, you |
| 179 must specify ALL of the directories containing shared libraries at run | |
| 180 time, including system directories. Please read the information about | |
| 181 "ADD-ON LIBRARIES" above very carefully. | |
| 0 | 182 |
| 183 The `--x-includes=DIR' and `--x-libraries=DIR' options tell the build | |
| 184 process where the compiler should look for the include files and | |
| 185 object libraries used with the X Window System. Normally, `configure' | |
| 186 is able to find them; these options are necessary if you have your X | |
| 187 Window System files installed in unusual places. | |
| 188 | |
| 1338 | 189 Configuring the Build Process |
| 190 ----------------------------- | |
| 149 | 191 |
| 2648 | 192 The `--with-gcc=PROGRAM' option specifies that the build process should |
| 193 compile XEmacs using GCC. The `--with-compiler' option allows you to | |
| 194 specify some other compiler to be used to compile XEmacs. If neither | |
| 195 option is specified, the environment variable CC is used instead. | |
| 196 Otherwise the compiler will then default to 'cc'. | |
| 201 | 197 |
| 2648 | 198 The `--with-xemacs-compiler=PROGRAM' option specifies the compiler |
| 199 control program for the xemacs binary only. Other C code will be | |
| 200 compiled according to the `--with-gcc' and `--with-compiler' options | |
| 201 above. This is useful if you wish to compile XEmacs with a C++ | |
| 202 compiler, because the utilities in ./lib-src cannot be compiled as C++. | |
| 203 This option is primarily intended for use by the maintainers. | |
| 0 | 204 |
| 2648 | 205 The `--with-cflags=FLAGS' option specifies all of the CFLAGS the build |
| 206 process should use when compiling XEmacs, except for flags controlling | |
| 207 warning generation. Otherwise the value of the environment variable | |
| 208 CFLAGS is consulted. If that is also undefined, CFLAGS defaults to "-g | |
| 209 -O" for gcc and "-g" for all other compilers. | |
| 0 | 210 |
| 2648 | 211 The `--with-cflags-warning=FLAGS' option specifies the warnings to be |
| 1338 | 212 generated. There is normally no reason to use this flag, as XEmacs |
| 3050 | 213 turns on as many warnings as possible, and is still intended to build |
| 214 with no warnings. If you get any undocumented warnings, please report | |
| 215 them as bugs---they very often are, or at least indicate possible | |
| 216 bitrot. | |
| 594 | 217 |
| 2648 | 218 The `--with-cflags-optimization=FLAGS' option specifies the |
| 3050 | 219 optimizations to be used. There is normally no reason to use this |
| 220 flag, as XEmacs will already set the maximum safe optimization flags | |
| 221 appropriate for the compiler being invoked. | |
| 2648 | 222 |
| 223 The `--with-cflags-debugging=FLAGS' option specifies debugging | |
| 3050 | 224 information to be generated. You should avoid using this flag, as it |
| 225 makes most severe or fatal bugs hard-to-impossible to diagnose and | |
| 226 fix. Debugging information does not slow down XEmacs at runtime, and | |
| 227 it doesn't make the binary very much bigger. | |
| 2648 | 228 |
| 3050 | 229 The `--with-dynamic' option specifies that configure should try to |
| 230 link XEmacs dynamically rather than statically. `--with-static' | |
| 231 specifies the reverse. XEmacs's configure script detects whether | |
| 232 dynamic linking can be done on all platforms we know of; these options | |
| 233 are normally unnecessary. | |
| 234 | |
| 235 The `--with-modules' option specifies that XEmacs be built with | |
| 236 support for runtime loadable modules. NOTE TO OEMS: XEmacs can be | |
| 237 distributed configured to support several options based on external | |
| 238 APIs (currently LDAP, PostgreSQL, and Canna) as loadable modules. You | |
| 239 can distribute an XEmacs binary package with these options enabled | |
| 240 without depending on the external package. XEmacs will fail | |
| 241 gracefully at runtime, issuing an error message indicating that the | |
| 242 required support was not found on the system. | |
| 0 | 243 |
| 244 You can build XEmacs for several different machine types from a single | |
| 245 source directory. To do this, you must use a version of `make' that | |
| 442 | 246 supports the `VPATH' variable, such as GNU `make'. Create separate |
| 0 | 247 build directories for the different configuration types, and in each |
| 248 one, run the XEmacs `configure' script. `configure' looks for the | |
| 1338 | 249 Emacs source code in the directory that `configure' is in. The |
| 250 `--srcdir' option may not work correctly (traditionally it was | |
| 251 overridden by the directory containing `configure'). | |
| 252 | |
| 253 Configuring the Installation Layout | |
| 254 ----------------------------------- | |
| 0 | 255 |
| 256 The `--prefix=PREFIXDIR' option specifies where the installation process | |
| 257 should put XEmacs and its data files. This defaults to `/usr/local'. | |
| 258 - XEmacs (and the other utilities users run) go in PREFIXDIR/bin | |
| 259 (unless the `--exec-prefix' option says otherwise). | |
| 260 - The architecture-independent files go in PREFIXDIR/lib/xemacs-VERSION | |
| 276 | 261 (where VERSION is the version number of XEmacs, like `21.0'). |
| 0 | 262 - The architecture-dependent files go in |
| 243 | 263 PREFIXDIR/lib/xemacs-VERSION/CONFIGURATION-NAME |
| 264 (where CONFIGURATION-NAME is the host type, like mips-dec-ultrix4.2), | |
| 0 | 265 unless the `--exec-prefix' option says otherwise. |
| 266 | |
| 267 The `--exec-prefix=EXECDIR' option allows you to specify a separate | |
| 268 portion of the directory tree for installing architecture-specific | |
| 269 files, like executables and utility programs. If specified, | |
| 270 - XEmacs (and the other utilities users run) go in EXECDIR/bin, and | |
| 271 - The architecture-dependent files go in | |
| 243 | 272 EXECDIR/lib/xemacs-VERSION/CONFIGURATION-NAME. |
| 0 | 273 EXECDIR/bin should be a directory that is normally in users' PATHs. |
| 274 | |
| 442 | 275 If you specify --prefix (or any of the other installation directory |
| 276 options), they will get compiled into the xemacs executable so it will | |
| 1338 | 277 be able to find its various associated files. However, XEmacs has |
| 442 | 278 quite elaborate logic to find out the locations of these directories |
| 279 dynamically. Sometimes, it is desirable *not* to compile these | |
| 280 directories into the executable so you can move the XEmacs | |
| 281 installation around (as whole) at will. This is true for binary kits, | |
| 282 for instance. Therefore, you can specify --without-prefix on the | |
| 283 configure command line to prevent the installation prefix to become | |
| 284 part of the generated executable; everything else will continue to | |
| 285 work as usual. | |
| 0 | 286 |
| 1338 | 287 Configuring Feature Support |
| 288 --------------------------- | |
| 289 | |
| 290 If you don't want X Window System support, specify `--without-x'. If | |
| 291 you omit this option, `configure' will try to autodetect whether your | |
| 292 system has X Window System support, and arrange to use it if present. | |
| 293 | |
| 3050 | 294 The `--with-menubars=TYPE' option allows you to specify which X |
| 0 | 295 toolkit you wish to use for the menubar. The valid options are |
| 149 | 296 `lucid', `motif' and `no'. The default is `lucid' which is a |
| 0 | 297 Motif-lookalike menubar. We highly recommend its usage over the real |
| 298 Motif menubar. (In fact, the Motif menubar is currently broken.) If | |
| 149 | 299 `no' is specified then support for menubars will not be compiled in. |
| 0 | 300 |
| 3050 | 301 The `--with-scrollbars=TYPE' option allows you to specify which X |
| 0 | 302 toolkit you wish to use for the scrollbars. The valid options are |
| 149 | 303 `lucid', `motif', `athena', `athena3d', and `no'. The default is |
| 2648 | 304 `lucid' which is a Motif-lookalike scrollbar. If `no' is specified then |
| 305 support for scrollbars will not be compiled in. | |
| 0 | 306 |
| 3050 | 307 The `--with-dialogs=TYPE' option allows you to specify which X toolkit |
| 219 | 308 you wish to use for the dialog boxes. The valid options are `athena', |
| 243 | 309 `athena3d', `motif, and `no. The `lucid' option is accepted and will |
| 310 result in the `athena' toolkit being used. If the Motif toolkit can be | |
| 311 found the default is `motif'. Otherwise, the default is `athena'. If | |
| 2648 | 312 `no' is specified then support for dialog boxes will not be compiled in. |
| 0 | 313 |
| 3050 | 314 The `--with-toolbars' option allows you to enable or disable toolbar |
| 1338 | 315 support. The default is `yes' if support for a windowing system is |
| 316 included. | |
| 0 | 317 |
| 149 | 318 The `--with-xpm' option specifies that XEmacs should support X11 |
| 0 | 319 Pixmaps. `configure' will attempt to detect if you have the Xpm |
| 320 libraries and define `--with-xpm' for you. | |
| 321 | |
| 322 The `--with-xface' option specifies that XEmacs should support | |
| 323 X-Faces. `configure' will attempt to detect if you have the compface | |
| 324 library and define `--with-xface' for you. | |
| 325 | |
| 3050 | 326 The `--with-database' option specifies that XEmacs should be built |
| 1338 | 327 with simple database support. The valid options are `no' or a |
| 0 | 328 comma-separated list of one or more of `dbm', `gnudbm' or `berkdb'. |
| 329 `configure' will attempt to detect the necessary libraries and header | |
| 3050 | 330 files and define `--with-database' for you. |
| 0 | 331 |
| 1338 | 332 The `--with-postgresql' option specifies that XEmacs should be built |
| 333 with PostgreSQL support, linking with libpq. `configure' will attempt | |
| 334 to detect whether PostgreSQL support is available, and automatically | |
| 3050 | 335 define `--with-postgresql' for you. NOTE TO OEMS: If modules are |
| 336 supported and enabled, the libpq API support will be build as a | |
| 337 module. | |
| 1338 | 338 |
| 339 The `--with-ldap' option specifies that XEmacs should be build with | |
| 340 LDAP support, using the OpenLDAP libraries. `configure' will attempt | |
| 341 to detect whether LDAP support is available, and automatically define | |
| 3050 | 342 `--with-ldap' for you. NOTE TO OEMS: If modules are supported and |
| 343 enabled, the OpenLDAP API support will be build as a module. | |
| 1338 | 344 |
| 0 | 345 The `--with-socks' option specifies that XEmacs should be built with |
| 149 | 346 SOCKS support. This requires the libsocks library. |
| 0 | 347 |
| 3050 | 348 The `--with-external-widget' option specifies that XEmacs should be |
| 2648 | 349 built with support for being used as a widget by other X11 applications. |
| 1338 | 350 This functionality should be considered beta. |
| 351 | |
| 3050 | 352 The `--with-sound=TYPE' option specifies that XEmacs should be built |
| 353 with sound support. Native (`--with-sound=native') sound support is | |
| 1338 | 354 currently available only on Sun SparcStations, SGI's, HP9000s, and |
| 355 systems (such as Linux) with soundcard.h. Network Audio Support (NAS) | |
| 3050 | 356 (`--with-sound=nas') is an extension to X that you may or may not have |
| 2648 | 357 for your system. For NAS, you will probably need to provide the paths |
| 358 to the nas include and library directories to configure. If | |
| 3050 | 359 `--with-sound' is not specified, `configure' will attempt to determine |
| 360 if your configuration supports native sound and define --with-sound | |
| 2648 | 361 for you. If your native sound library is not in a standard location you |
| 362 can specify it with the `--with-native-sound-lib=LIB' flag. For Linux, | |
| 363 `/dev/audio' is required for SunAudio files and `/dev/dsp' is required | |
| 364 for raw data and WAVE format files. | |
| 1338 | 365 |
| 0 | 366 The `--with-tooltalk' option specifies that XEmacs should be built |
| 367 with ToolTalk support for interconnecting with other applications. | |
| 243 | 368 ToolTalk is not yet supported on all architectures. If you use this |
| 369 option, you should have the tooltalk package (see etc/PACKAGES) | |
| 370 installed prior to building XEmacs. | |
| 0 | 371 |
| 372 The `--with-sparcworks' option specifies that XEmacs should be built | |
| 149 | 373 with support for Sun Sparcworks 3.0.1 and up (including Sun WorkShop). |
| 374 This functionality is only of use on SunOS 4.1.x and Solaris 2.x | |
| 272 | 375 systems. If you use this option, you should have the Sun package (see |
| 243 | 376 etc/PACKAGES) installed prior to building XEmacs. |
| 0 | 377 |
| 149 | 378 The `--with-cde' option allows you to enable or disable CDE drag and |
| 0 | 379 drop support. `configure' will attempt to detect this option and |
| 380 define `--with-cde' for you. | |
| 381 | |
| 272 | 382 The `--with-offix' option allows you to enable or disable OffiX drag |
| 383 and drop support. This requires no external library support, so if | |
| 384 X11 support is available, then this option defaults to `yes'. OffiX | |
| 274 | 385 support can be explicitly disabled via the `--with-offix=no' option. |
| 2 | 386 |
| 1338 | 387 Internationalization Options |
| 388 ---------------------------- | |
| 0 | 389 |
| 3050 | 390 The `--with-mule' option enables MUlti-Lingual Emacs (Mule) support, |
| 1338 | 391 needed to support non-Latin-1 (including Asian) languages. Mule |
| 392 support is required for Asian language and Unicode (multibyte and wide | |
| 393 character) support. With the advent of the Euro and European | |
| 394 Community expansion, Mule support is also recommended for Western | |
| 395 Europeans. Enabling Mule support requires the mule-base package | |
| 396 installed prior to building XEmacs. The `--with-xim', --with-xfs', | |
| 397 `--with-canna', `--with-wnn' and `--with-wnn6' options require | |
| 398 Mule support. | |
| 149 | 399 |
| 400 The `--with-xim' option enables use of the X11 XIM mechanism to allow | |
| 401 an input method to input text into XEmacs. The input method is shared | |
| 402 among all the X applications sharing an X display and using the same | |
| 151 | 403 language. The XIM support comes in two flavors: `motif' and `xlib'. |
| 404 The Motif support (the XmIm* functions) is preferred when available. | |
| 243 | 405 The xlib XIM support works reasonably well so long as the X11 libraries |
| 406 are recent enough. It has been fairly well tested on Linux with glibc | |
| 407 2.0.5 and 2.0.6 and Kinput2 as an XIM server. In this configuration | |
| 408 X11 must be recompiled with X_LOCALE defined because glibc is lacking | |
| 409 localization for Japanese. The XIM support defaults to `no' except | |
| 410 when Motif is detected where it is stable with OSF libraries. The XIM | |
| 411 support in Lesstif (a Free Motif replacement) does not work as of | |
| 412 v0.82. If you enable this option, you will probably wish to install | |
| 413 the `locale' package which contains localized Splash screens and | |
| 414 Menubars. | |
| 415 | |
| 272 | 416 The `--with-xfs' option enables use of a multilingual Menubar. At the |
| 243 | 417 present time, only Japanese and French locales are supported. In |
| 272 | 418 order to use a multilingual Menubar you must have the `locale' package |
| 243 | 419 installed. The `locale' package does not have to be installed when |
| 420 building XEmacs. | |
| 149 | 421 |
| 422 The `--with-canna' option enables the use of the Canna Japanese input | |
| 243 | 423 method. This is stable code and fairly well tested. In order to use |
| 2283 | 424 it, you will have to have the Canna server installed and running. Canna |
| 425 versions 3.2pl2, 3.5b2, and 3.7p3 are known to work. Version 3.2pl2 is | |
| 426 considered more stable than version 3.5b2; the stability of 3.7p3 is | |
| 427 still unknown. If Canna is already installed, configure will autodetect | |
| 428 it, so you never need to explicitly use this option unless your Canna | |
| 429 libraries are somewhere strange. Canna run time support is currently | |
| 430 bundled with the `mule-base' package so there is nothing additional to | |
| 3050 | 431 install in order to use it. NOTE TO OEMS: If modules are supported |
| 432 and enabled, the libcanna API support will be build as a module. | |
| 0 | 433 |
| 243 | 434 The `--with-wnn' and `--with-wnn6' options are for compiling with the Wnn |
| 435 multi-language input method. `--with-wnn' is for compiling with Wnn-4.2, | |
| 436 the Free version of WNN. `--with-wnn6' is for compiling against WNN6, | |
| 437 the commercial version of WNN available from OMRON Corporation. This is | |
| 438 stable code and fairly well tested. In order to build with this | |
| 439 option, you will need to have the `egg-its' lisp package already | |
| 440 installed. | |
| 441 | |
| 442 Please note that it is safe to build with as many of the options | |
| 443 `--with-xim', `--with-canna' and `--with-wnn' as your system | |
| 444 supports. | |
| 104 | 445 |
| 1338 | 446 Options for Developers and Special Requirements |
| 447 ----------------------------------------------- | |
| 448 | |
| 2648 | 449 The `--with-rel-alloc' option can be used to either enable or disable |
| 450 use of the relocating allocator. Turning on --with-rel-alloc will allow | |
| 451 XEmacs to return unused memory to the operating system, thereby reducing | |
| 452 its memory footprint. However, it may make XEmacs runs more slowly, | |
| 1338 | 453 especially if your system's `mmap' implementation is missing or |
| 2648 | 454 inefficient. Generally, it's best to go with the default configuration |
| 455 for your system. You can tweak this based on how you use XEmacs, and | |
| 456 the memory and cpu resources available on your system. | |
| 1338 | 457 |
| 458 The `--with-system-malloc' option can be used to either enable or | |
| 459 disable use of the system malloc. Generally, it's best to go with the | |
| 460 default configuration for your system. Note that on many systems | |
| 461 using the system malloc disables the use of the relocating allocator. | |
| 462 | |
| 463 The `--with-debug-malloc' option can be used to link a special | |
| 464 debugging version of malloc. Debug Malloc is not included with XEmacs | |
| 465 and is intended for use only by the developers. It may be obtained | |
| 466 from <URL:http://www.letters.com/dmalloc/>. | |
| 467 | |
| 2648 | 468 The `--enable-debug' and `--enable-error-checking' options are primarily |
| 469 useful to the developers. `--enable-debug' incorporates code for | |
| 470 performing various tests, but does not impose a speed penalty. | |
| 471 `--enable-error-checking' adds additional tests to many of the commonly | |
| 472 used macros, and imposes a speed penalty. Using either or both of these | |
| 473 options can make bug reports more useful to the developers. | |
| 1338 | 474 |
| 2648 | 475 The `--verbose' option is useful only to the developers. It displays |
| 476 additional information, useful for debugging `configure'. | |
| 1338 | 477 |
| 442 | 478 MAIL LOCKING |
| 479 ============ | |
| 480 | |
| 845 | 481 For most platforms, configure or the src/s file have the preferred |
| 482 method for locking mail spool files preconfigured. Otherwise you must | |
| 483 find out for youself. Do not choose a locking protocol "on the | |
| 484 objective merits." XEmacs must use the same method as other mail | |
| 1338 | 485 utilities on your system, or you WILL lose mail. |
| 845 | 486 |
| 487 Presently, XEmacs supports lockf, flock, and dot locking. Specify the | |
| 2648 | 488 locking method via the --with-mail-locking=METHOD option to configure. |
| 489 Valid values for METHOD are --with-mail-locking are `lockf', `flock', | |
| 490 and `dot'. | |
| 442 | 491 |
| 492 RUNNING CONFIGURE | |
| 493 ================= | |
| 494 | |
| 149 | 495 `configure' doesn't do any compilation or installation itself. It |
| 496 just creates the files that influence those things: `./src/config.h', | |
| 1338 | 497 and all the Makefiles in the build tree. |
| 104 | 498 |
| 0 | 499 When it is done, `configure' prints a description of what it did and |
| 500 creates a shell script `config.status' which, when run, recreates the | |
| 501 same configuration. If `configure' exits with an error after | |
| 1338 | 502 disturbing the status quo, it removes `config.status'. If `configure' |
| 503 doesn't work as expected, the file `config.log' contains details of | |
| 504 the tests run and their results. | |
| 0 | 505 |
| 442 | 506 AUXILIARY PATHS |
| 507 =============== | |
| 508 | |
| 509 Look at `./lisp/paths.el'; if some of those values are not right for | |
| 510 your system, set up the file `./lisp/site-init.el' with XEmacs Lisp | |
| 511 code to override them; it is not a good idea to edit paths.el itself. | |
| 512 YOU MUST USE THE LISP FUNCTION `setq' TO ASSIGN VALUES, rather than | |
| 513 `defvar', as used by `./lisp/paths.el'. For example, | |
| 0 | 514 |
| 515 (setq news-inews-program "/usr/bin/inews") | |
| 516 | |
| 517 is how you would override the default value of the variable | |
| 518 news-inews-program (which is "/usr/local/inews"). | |
| 519 | |
| 520 Before you override a variable this way, *look at the value* that the | |
| 521 variable gets by default! Make sure you know what kind of value the | |
| 522 variable should have. If you don't pay attention to what you are | |
| 523 doing, you'll make a mistake. | |
| 524 | |
| 392 | 525 Things may malfunction if the variable `directory-abbrev-alist' is not |
| 526 set up to translate "temporary" automounter mount points into the | |
| 527 canonical form. XEmacs tries to detect how your automounter is | |
| 528 configured. If you have an unusual automounter configuration that | |
| 529 XEmacs cannot detect, you may need to change the value of | |
| 530 `directory-abbrev-alist'. | |
| 371 | 531 |
| 442 | 532 SITE-SPECIFIC STARTUP CODE |
| 533 ========================== | |
| 534 | |
| 535 Put into `./lisp/site-init.el' or `./lisp/site-load.el' any Emacs Lisp | |
| 536 code you want XEmacs to load before it is dumped out. Use | |
| 0 | 537 site-load.el for additional libraries if you arrange for their |
| 538 documentation strings to be in the lib-src/DOC file (see | |
| 539 src/Makefile.in.in if you wish to figure out how to do that). For all | |
| 540 else, use site-init.el. | |
| 541 | |
| 542 Note that, on some systems, the code you place in site-init.el must | |
| 543 not use expand-file-name or any other function which may look | |
| 544 something up in the system's password and user information database. | |
| 545 See `./PROBLEMS' for more details on which systems this affects. | |
| 546 | |
| 547 The `site-*.el' files are nonexistent in the distribution. You do not | |
| 548 need to create them if you have nothing to put in them. | |
| 549 | |
| 442 | 550 TERMCAP CONFIGURATION |
| 551 ===================== | |
| 552 | |
| 553 Refer to the file `./etc/TERMS' for information on fields you may | |
| 0 | 554 wish to add to various termcap entries. The files `./etc/termcap.ucb' |
| 555 and `./etc/termcap.dat' may already contain appropriately-modified | |
| 556 entries. | |
| 557 | |
| 442 | 558 RUNNING MAKE |
| 559 ============ | |
| 560 | |
| 561 Run `make' in the top directory of the XEmacs distribution to finish | |
| 0 | 562 building XEmacs in the standard way. The final executable file is |
| 1338 | 563 named `src/xemacs'. You can execute this file in place without |
| 0 | 564 copying it, if you wish; then it automatically uses the sibling |
| 565 directories ../lisp, ../lib-src, ../info. | |
| 566 | |
| 1338 | 567 Or you can install the executable and the other XEmacs into their |
| 568 permanent locations, with `make install'. By default, XEmacs's files | |
| 0 | 569 are installed in the following directories: |
| 570 | |
| 571 `/usr/local/bin' holds the executable programs users normally run - | |
| 388 | 572 `xemacs', `etags', `ctags', `b2m', `emacsclient', `ellcc', |
|
4782
1523f1d28be1
Remove more obsolete files. See xemacs-patches message with ID
Jerry James <james@xemacs.org>
parents:
4769
diff
changeset
|
573 `gnuclient', `gnudoit', and `gnuattach'. |
| 0 | 574 |
| 575 `/usr/local/lib/xemacs-VERSION/lisp' holds the Emacs Lisp libraries; | |
| 576 `VERSION' stands for the number of the XEmacs version | |
| 577 you are installing, like `18.59' or `19.14'. Since | |
| 578 the lisp libraries change from one version of XEmacs to | |
| 579 another, including the version number in the path | |
| 580 allows you to have several versions of XEmacs installed | |
| 581 at the same time; this means that you don't have to | |
| 582 make XEmacs unavailable while installing a new version. | |
| 583 | |
| 584 XEmacs searches for its lisp files in these | |
| 585 directories, and then in | |
| 586 `/usr/local/lib/xemacs/site-lisp/*'. | |
| 587 | |
| 588 `/usr/local/lib/xemacs-VERSION/etc' holds the XEmacs tutorial, the | |
| 589 `yow' database, and other architecture-independent | |
| 590 files XEmacs might need while running. VERSION is as | |
| 591 specified for `.../lisp'. | |
| 592 | |
| 593 `/usr/local/lib/xemacs/lock' contains files indicating who is | |
| 594 editing what, so XEmacs can detect editing clashes | |
| 595 between users. | |
| 596 | |
| 597 `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME' contains executable | |
| 598 programs used by XEmacs that users are not expected to | |
| 599 run themselves, and the DOC file. `VERSION' is the | |
| 600 number of the XEmacs version you are installing, and | |
| 243 | 601 `CONFIGURATION-NAME' is the host type of your system. |
| 602 Since these files are specific to the version of | |
| 603 XEmacs, operating system, and architecture in use, | |
| 604 including the configuration name in the path allows | |
| 605 you to have several versions of XEmacs for any mix of | |
| 606 machines and operating systems installed at the same | |
| 607 time; this is useful for sites at which different | |
| 608 kinds of machines share the file system XEmacs is | |
| 609 installed on. | |
| 0 | 610 |
| 388 | 611 `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME/modules' holds the Emacs |
| 612 dynamically loadable modules. These are special programs | |
| 613 typically written in C that can be loaded in much the same | |
| 614 way that Lisp packages are. Not all systems support | |
| 615 dynamic modules, so do not be alarmed if this directory | |
| 616 does not exist or is empty. | |
| 617 | |
| 618 XEmacs searches for modules in this directory, or any | |
| 619 sub-directory of it, and then in | |
| 620 `/usr/local/lib/xemacs/site-modules/*'. | |
| 621 | |
| 0 | 622 `/usr/local/lib/xemacs-VERSION/info' holds the on-line documentation |
| 623 for XEmacs, known as "info files". | |
| 624 | |
| 625 `/usr/local/man/man1' holds the man pages for the programs installed | |
| 626 in `/usr/local/bin'. | |
| 627 | |
| 628 If these directories are not what you want, you can specify where to | |
| 629 install XEmacs's libraries and data files or where XEmacs should search | |
| 630 for its lisp files by giving values for `make' variables as part of | |
| 442 | 631 the command. |
| 0 | 632 |
| 633 You can change where the build process installs XEmacs and its data | |
| 634 files by specifying values for `make' variables as part of the `make' | |
| 635 command line. For example, if you type | |
| 636 | |
| 637 make install bindir=/usr/local/gnubin | |
| 638 | |
| 639 the `bindir=/usr/local/gnubin' argument indicates that the XEmacs | |
| 640 executable files should go in `/usr/local/gnubin', not | |
| 641 `/usr/local/bin'. | |
| 642 | |
| 643 Here is a complete list of the variables you may want to set. | |
| 644 | |
| 645 `bindir' indicates where to put executable programs that users can | |
| 646 run. This defaults to /usr/local/bin. | |
| 647 | |
| 648 `datadir' indicates where to put the architecture-independent | |
| 649 read-only data files that XEmacs refers to while it runs; it | |
| 650 defaults to /usr/local/lib. We create the following | |
| 651 subdirectories under `datadir': | |
| 652 - `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and | |
| 653 | |
| 654 - `xemacs-VERSION/etc', containing the XEmacs tutorial and the | |
| 655 `yow' database. | |
| 656 `VERSION' is the number of the XEmacs version you are installing, | |
| 657 like `18.59' or `19.14'. Since these files vary from one version | |
| 658 of XEmacs to another, including the version number in the path | |
| 659 allows you to have several versions of XEmacs installed at the | |
| 660 same time; this means that you don't have to make XEmacs | |
| 661 unavailable while installing a new version. | |
| 662 | |
| 663 `statedir' indicates where to put architecture-independent data files | |
| 664 that XEmacs modifies while it runs; it defaults to | |
| 665 /usr/local/lib as well. We create the following | |
| 666 subdirectories under `statedir': | |
| 667 - `xemacs/lock', containing files indicating who is editing | |
| 668 what, so XEmacs can detect editing clashes between | |
| 669 users. | |
| 670 | |
| 671 `libdir' indicates where to put architecture-specific data files that | |
| 672 XEmacs refers to as it runs; it too defaults to `/usr/local/lib'. | |
| 673 We create the following subdirectories under `libdir': | |
| 674 - `xemacs-VERSION/CONFIGURATION-NAME', containing executable | |
| 675 programs used by XEmacs that users are not expected to run | |
| 1338 | 676 themselves, and the DOC file. |
| 0 | 677 `VERSION' is the number of the XEmacs version you are installing, |
| 243 | 678 and `CONFIGURATION-NAME' is the host type of your system. |
| 679 Since these files are specific to the version of XEmacs, | |
| 680 operating system, and architecture in use, including the | |
| 681 configuration name in the path allows you to have several | |
| 682 versions of XEmacs for any mix of machines and operating | |
| 683 systems installed at the same time; this is useful for sites | |
| 684 at which different kinds of machines share the file system | |
| 685 XEmacs is installed on. | |
| 0 | 686 |
| 687 `infodir' indicates where to put the info files distributed with | |
| 688 XEmacs; it defaults to `/usr/local/lib/xemacs-VERSION/info'. | |
| 689 | |
| 690 `mandir' indicates where to put the man pages for XEmacs and its | |
| 691 utilities (like `etags'); it defaults to | |
| 692 `/usr/local/man/man1'. | |
| 693 | |
| 694 `prefix' doesn't give a path for any specific part of XEmacs; instead, | |
| 695 its value is used to determine the defaults for all the | |
| 696 architecture-independent path variables - `datadir', | |
| 697 `statedir', `infodir', and `mandir'. Its default value is | |
| 698 `/usr/local'; the other variables add on `lib' or `man' to it | |
| 699 by default. | |
| 700 | |
| 701 For example, suppose your site generally places GNU software | |
| 702 under `/usr/users/software/gnusoft' instead of `/usr/local'. | |
| 703 By including | |
| 704 `prefix=/usr/users/software/gnusoft' | |
| 705 in the arguments to `make', you can instruct the build process | |
| 706 to place all of the XEmacs data files in the appropriate | |
| 707 directories under that path. | |
| 708 | |
| 709 `exec_prefix' serves the same purpose as `prefix', but instead | |
| 710 determines the default values for the architecture-dependent | |
| 711 path variables - `bindir' and `libdir'. | |
| 712 | |
| 713 The above variables serve analogous purposes in the makefiles for all | |
| 714 GNU software; here are some variables specific to XEmacs. | |
| 715 | |
| 716 `lispdir' indicates where XEmacs installs and expects its lisp | |
| 717 libraries. Its default value, based on `datadir' (see above), | |
| 718 is `/usr/local/lib/xemacs-VERSION/lisp' (where `VERSION' is as | |
| 719 described above). | |
| 720 | |
| 721 `sitelispdir' indicates where XEmacs should search for lisp libraries | |
| 722 specific to your site. XEmacs checks them in order before | |
| 723 checking `lispdir'. Its default value, based on `datadir' | |
| 724 (see above), is `/usr/local/lib/xemacs/site-lisp'. | |
| 725 | |
| 726 `etcdir' indicates where XEmacs should install and expect the rest of | |
| 727 its architecture-independent data, like the tutorial and yow | |
| 728 database. Its default value, based on `datadir' | |
| 729 (see above), is `/usr/local/lib/xemacs-VERSION/etc' (where | |
| 730 `VERSION' is as described above). | |
| 731 | |
| 732 `lockdir' indicates the directory where XEmacs keeps track of its | |
| 733 locking information. Its default value, based on `statedir' | |
| 734 (see above), is `/usr/local/lib/xemacs/lock'. | |
| 735 | |
| 736 `archlibdir' indicates where XEmacs installs and expects the | |
| 737 executable files and other architecture-dependent data it uses | |
| 738 while running. Its default value, based on `libdir' (see | |
| 739 above), is `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME' | |
| 740 (where VERSION and CONFIGURATION-NAME are as described above). | |
| 741 | |
| 420 | 742 `docdir' indicates where to put Lisp documentation strings that XEmacs |
| 442 | 743 refers to as it runs. It defaults to the value of `archlibdir' |
| 420 | 744 (see above). |
| 745 | |
| 388 | 746 `moduledir' indicates where XEmacs installs and expects to find |
| 747 any dynamic modules. Its default value, based on | |
| 748 `archlibdir' (see above) is | |
| 749 `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME/modules' | |
| 750 (where VERSION and CONFIGURATION-NAME are as described above). | |
| 751 By their very nature, dynamic loadable modules are architecture- | |
| 442 | 752 dependent, and care should be taken not to set this directory |
| 753 to a system- or architecture-independent directory. | |
| 388 | 754 |
| 0 | 755 Remember that you must specify any variable values you need each time |
| 756 you run `make' in the top directory. If you run `make' once to build | |
| 757 xemacs, test it, and then run `make' again to install the files, you | |
| 758 must provide the same variable settings each time. To make the | |
| 759 settings persist, you can edit them into the `Makefile' in the top | |
| 760 directory, but be aware that running the `configure' program erases | |
| 761 `Makefile' and rebuilds it from `Makefile.in'. | |
| 762 | |
| 763 The top-level Makefile stores the variable settings it used in the | |
| 764 Makefiles for the subdirectories, so you don't have to specify them | |
| 765 when running make in the subdirectories. | |
| 766 | |
| 442 | 767 Using GNU Make allows for simultaneous builds with and without the |
| 768 --srcdir option. | |
| 0 | 769 |
| 1283 | 770 STRIPPING BINARIES |
| 771 ================== | |
| 772 | |
| 773 This saves nothing but a small (by modern standards) amount of disk | |
| 774 space; the symbol table is not loaded into memory at execution time. | |
| 775 If you do encounter a crash or other serious bug, the first thing the | |
| 776 developers will do is ask you to build an XEmacs with a full symbol | |
| 777 table, anyway. Don't strip the XEmacs binary. | |
| 778 | |
| 442 | 779 MAIL-LOCKING POST-INSTALLATION |
| 780 ============================== | |
| 0 | 781 |
| 442 | 782 If your system uses dot-locking to interlock access to mailer inbox |
| 783 files, then you might need to make the movemail program setuid or | |
| 784 setgid to enable it to write the lock files. We believe this is safe. | |
| 785 The setuid/setgid bits need not be set on any other XEmacs-related | |
| 786 executables. | |
| 0 | 787 |
| 442 | 788 CLEANING UP |
| 789 ========== | |
| 0 | 790 |
| 442 | 791 You are done with the hard part! You can remove executables and |
| 792 object files from the build directory by typing `make clean'. To also | |
| 793 remove the files that `configure' created (so you can compile XEmacs | |
| 794 for a different configuration), type `make distclean'. | |
| 0 | 795 |
|
4508
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
796 READ THE FAQ |
|
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
797 ============ |
| 0 | 798 |
| 442 | 799 Do it! |
| 0 | 800 |
| 801 PROBLEMS | |
| 442 | 802 ======== |
| 398 | 803 |
| 1338 | 804 The most common problem is that you forgot to read and follow the |
|
4508
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
805 directions for installing bootstrap packages in the FAQ. You can not |
|
742a23369b74
Improve package documentation.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
3179
diff
changeset
|
806 have a normal XEmacs without downloading some additional packages. |
| 424 | 807 |
| 1036 | 808 See the file PROBLEMS in this directory for a list of various problems |
| 809 sometimes encountered, and what to do about them. PROBLEMS is also | |
| 810 the place where platform-specific build notes can be found. | |
| 3050 | 811 |
| 812 APPENDIX: CORRESPONDENCE TO OLD CONFIGURE OPTIONS | |
| 813 ================================================= | |
| 814 | |
| 815 Here is a full translation of command line arguments. Note that any | |
| 816 option starting with "--with" may also be specified with "--enable". | |
| 817 This list may not be up-to-date. | |
| 818 | |
| 819 Old | New | |
| 820 ------------------------------------------ | |
| 821 General options: | |
| 822 ---------------- | |
| 823 | |
| 824 --help Unchanged | |
| 825 --usage Removed | |
| 826 --verbose Unchanged | |
| 827 --extra-verbose Removed | |
| 828 | |
| 829 Compilation options: | |
| 830 -------------------- | |
| 831 | |
| 832 --compiler --with-compiler | |
| 833 --xemacs-compiler --with-xemacs-compiler | |
| 834 --with-gcc Unchanged | |
| 835 --cflags --with-cflags | |
| 836 --cflags-warning --with-cflags-warning | |
| 837 --debug --with-debug | |
| 838 New --with-cflags-debug | |
| 839 New --with-optimization | |
| 840 New --with-cflags-optimization | |
| 841 --cpp --with-cpp | |
| 842 --cppflags --with-cppflags | |
| 843 --libs --with-libs | |
| 844 --ldflags --with-ldflags | |
| 845 --site-includes --with-site-includes | |
| 846 --site-libraries --with-site-libraries | |
| 847 --site-prefixes --with-site-prefixes | |
| 848 --site-runtime-libraries --with-site-runtime-libraries | |
| 849 --dynamic --with-dynamic | |
| 850 --srcdir Unchanged | |
| 851 | |
| 852 Installation options: | |
| 853 --------------------- | |
| 854 | |
| 855 --prefix Unchanged | |
| 856 --with-prefix Unchanged | |
| 857 --with-netinstall Unchanged | |
| 858 --bindir Unchanged | |
| 859 --datadir Unchanged | |
| 860 --statedir Unchanged | |
| 861 --libdir Unchanged | |
| 862 --infodir Unchanged | |
| 863 --mandir Unchanged | |
| 864 --lispdir --with-lispdir | |
| 865 --sitelispdir Removed | |
| 866 --etcdir --with-etcdir | |
| 867 --lockdir Removed | |
| 868 --archlibdir --with-archlibdir | |
| 869 --docdir --with-docdir | |
| 870 --moduledir --with-moduledir | |
| 871 | |
| 872 Run-time path-searching options: | |
| 873 -------------------------------- | |
| 874 | |
| 875 --with-site-lisp Unchanged | |
| 876 --with-site-modules Unchanged | |
| 877 --package-path --with-package-path | |
| 878 --infopath --with-infopath | |
| 879 | |
| 880 Window-system options: | |
| 881 ---------------------- | |
| 882 | |
| 883 --with-gtk Unchanged | |
| 884 --with-gnome Unchanged | |
| 885 --with-x11 Unchanged | |
| 886 --x-includes Unchanged | |
| 887 --x-libraries Unchanged | |
| 888 --with-msw Unchanged | |
| 889 --with-toolbars Unchanged | |
| 890 --with-wmcommand Unchanged | |
| 891 --with-athena Unchanged | |
| 892 --with-menubars Unchanged | |
| 893 --with-scrollbars Unchanged | |
| 894 --with-dialogs Unchanged | |
| 895 --with-widgets Unchanged | |
| 896 --with-dragndrop Unchanged | |
| 897 --with-cde Unchanged | |
| 898 --with-offix Unchanged | |
| 899 --with-xmu Unchanged | |
| 900 --external-widget --with-external-widget | |
| 901 | |
| 902 TTY (character terminal) options: | |
| 903 --------------------------------- | |
| 904 | |
| 905 --with-tty Unchanged | |
| 906 --with-ncurses Unchanged | |
| 907 --with-gpm Unchanged | |
| 908 | |
| 909 Image options: | |
| 910 -------------- | |
| 911 | |
| 912 --with-xpm Unchanged | |
| 913 --with-png Unchanged | |
| 914 --with-jpeg Unchanged | |
| 915 --with-tiff Unchanged | |
| 916 --with-xface Unchanged | |
| 917 --with-gif Unchanged | |
| 918 | |
| 919 Sound options: | |
| 920 -------------- | |
| 921 | |
| 922 --with-sound Unchanged | |
| 923 --native-sound-lib=LIB --with-native-sound-lib | |
| 924 | |
| 925 Internationalization options: | |
| 926 ----------------------------- | |
| 927 | |
| 928 --with-mule Unchanged | |
| 929 --with-xim Unchanged | |
| 930 --with-canna Unchanged | |
| 931 --with-wnn Unchanged | |
| 932 --with-wnn6 Unchanged | |
| 933 --with-xfs Unchanged | |
| 934 | |
| 935 File-related options: | |
| 936 --------------------- | |
| 937 | |
| 938 --with-default-eol-detection Unchanged | |
| 939 --with-clash-detection Unchanged | |
| 940 | |
| 941 Database options: | |
| 942 ----------------- | |
| 943 | |
| 944 --with-database Unchanged | |
| 945 --with-ldap Unchanged | |
| 946 --with-postgresql Unchanged | |
| 947 | |
| 948 Mail options: | |
| 949 ------------- | |
| 950 | |
| 951 --mail-locking=TYPE --with-mail-locking | |
| 952 --with-pop Unchanged | |
| 953 --with-kerberos Unchanged | |
| 954 --with-hesiod Unchanged | |
| 955 | |
| 956 Networking options: | |
| 957 ------------------- | |
| 958 | |
| 959 --with-tooltalk Unchanged | |
| 960 --with-socks Unchanged | |
| 961 --with-dnet Unchanged | |
| 962 --with-ipv6-cname Unchanged | |
| 963 | |
| 964 Memory allocation options: | |
| 965 -------------------------- | |
| 966 | |
| 967 --rel-alloc --with-rel-alloc | |
| 968 --with-dlmalloc Unchanged | |
| 969 --with-system-malloc Unchanged | |
| 970 --with-debug-malloc Unchanged | |
| 971 | |
| 972 Emacs Lisp options: | |
| 973 ------------------- | |
| 974 | |
| 975 --use-number-lib --with-bignum | |
| 976 | |
| 977 Debugging options: | |
| 978 ------------------ | |
| 979 | |
| 980 --debug --with-debug | |
| 981 --error-checking --with-error-checking | |
| 982 --memory-usage-stats --with-memory-usage-stats | |
| 983 --quick-build --with-quick-build | |
| 984 --use-union-type --with-union-type | |
| 985 --with-quantify Unchanged | |
| 986 --with-purify Unchanged | |
| 987 | |
| 988 Developer options: | |
| 989 ------------------ | |
| 990 | |
| 991 --with-workshop Unchanged | |
| 992 --pdump --with-pdump | |
| 993 --use-kkcc --with-kkcc | |
| 994 --with-modules Unchanged | |
| 995 | |
| 996 The output files produced by this new configure should be almost | |
| 997 identical to those produced by the old. This can be tested with the | |
| 998 provided regression test script. This script runs the two versions of | |
| 999 configure with the supplied list of command line arguments and reports | |
| 1000 any differences. Please add your favorite configuration command lines | |
| 1001 to the list before running the test. The script is run as: | |
| 1002 | |
| 1003 $ tests/autoconf/regressiontest.pl /absolute/path/to/2.13/configure \ | |
| 1004 /absolute/path/to/2.59/configure >diffs.txt | |
| 1005 | |
| 1006 The only differences should be: | |
| 1007 - those related to changes in the command line arguments | |
| 1008 - the change of SYS_SIGLIST_DECLARED to HAVE_DECL_SYS_SIGLIST (because the old | |
| 1009 form has been removed), and | |
| 1010 - The removal of trailing comments in src/config.h. | |
| 1011 |