comparison INSTALL @ 272:c5d627a313b1 r21-0b34

Import from CVS: tag r21-0b34
author cvs
date Mon, 13 Aug 2007 10:28:48 +0200
parents b2472a1930f2
children ca9a9ec9c1c1
comparison
equal deleted inserted replaced
271:c7b7086b0a39 272:c5d627a313b1
25 a program whose pure code is 900k bytes and whose data area is at 25 a program whose pure code is 900k bytes and whose data area is at
26 least 400k and can reach 8Mb or more. If the swapping space is 26 least 400k and can reach 8Mb or more. If the swapping space is
27 insufficient, you will get an error in the command `temacs -batch 27 insufficient, you will get an error in the command `temacs -batch
28 -l loadup dump', found in `./src/Makefile.in.in', or possibly when 28 -l loadup dump', found in `./src/Makefile.in.in', or possibly when
29 running the final dumped XEmacs. 29 running the final dumped XEmacs.
30 30
31 Building XEmacs requires about 41 Mb of disk space (including the 31 Building XEmacs requires about 41 Mb of disk space (including the
32 XEmacs sources). Once installed, XEmacs occupies about 16 Mb in the 32 XEmacs sources). Once installed, XEmacs occupies about 16 Mb in the
33 file system where it is installed; this includes the executable files, 33 file system where it is installed; this includes the executable files,
34 Lisp libraries, miscellaneous data files, and on-line documentation. 34 Lisp libraries, miscellaneous data files, and on-line documentation.
35 The amount of storage of the Lisp directories may be reduced by 35 The amount of storage of the Lisp directories may be reduced by
36 compressing the .el files. If the building and installation take place 36 compressing the .el files. If the building and installation take place
37 in different directories, then the installation procedure temporarily 37 in different directories, then the installation procedure temporarily
38 requires 41+16 Mb. Adjust this value upwards depending upon what 38 requires 41+16 Mb. Adjust this value upwards depending upon what
39 additional Lisp support is installed. 39 additional Lisp support is installed.
49 package enables native sound support. There are also a number of free 49 package enables native sound support. There are also a number of free
50 software packages that XEmacs can use. If these are not yet available 50 software packages that XEmacs can use. If these are not yet available
51 on your system, obtain, build and install those external packages 51 on your system, obtain, build and install those external packages
52 before building XEmacs. The packages XEmacs can use are: 52 before building XEmacs. The packages XEmacs can use are:
53 53
54 Xaw3d, XPM, JPEG, compface, PNG, zlib, OffiX, GNU DBM, Berkeley DB, 54 Xaw3d, XPM, JPEG, compface, PNG, zlib, GNU DBM, Berkeley DB, socks,
55 socks, term, NAS, Canna, Kinput2, SJ3, Wnn. 55 term, NAS, Canna, Kinput2, SJ3, Wnn.
56 56
57 You can get (most of) them from the XEmacs ftp site at 57 You can get (most of) them from the XEmacs ftp site at
58 ftp://ftp.xemacs.org/pub/xemacs/aux 58 ftp://ftp.xemacs.org/pub/xemacs/aux
59 59
60 If you want users on other systems to be able to use the XEmacs you 60 If you want users on other systems to be able to use the XEmacs you
61 have built, try to build those packages so that the generated 61 have built, try to build those packages so that the generated
62 libraries are statically linked. 62 libraries are statically linked.
63 63
64 Use the --site-includes and --site-libraries options when building 64 Use the --site-includes and --site-libraries options when building
65 XEmacs to allow configure to find the external software packages. 65 XEmacs to allow configure to find the external software packages.
66 If you link with dynamic (``.so'') external package libraries, which 66 If you link with dynamic (``.so'') external package libraries, which
67 is not recommended, you will also need to add the library directories 67 is not recommended, you will also need to add the library directories
68 to the --site-runtime-libraries option. 68 to the --site-runtime-libraries option.
69 69
70 70
99 99
100 See config.guess and configure.in for valid values for MACHINE, 100 See config.guess and configure.in for valid values for MACHINE,
101 VENDOR, and OPSYS. Also check `./etc/MACHINES' for advice on building 101 VENDOR, and OPSYS. Also check `./etc/MACHINES' for advice on building
102 on particular machines. 102 on particular machines.
103 103
104 If you don't want X support, specify `--with-x=no'. If you omit this 104 If you don't want X support, specify `--without-x'. If you omit this
105 option, `configure' will try to autodetect whether your system has X, 105 option, `configure' will try to autodetect whether your system has X,
106 and arrange to use it if present. 106 and arrange to use it if present.
107 107
108 The `--x-includes=DIR' and `--x-libraries=DIR' options tell the build 108 The `--x-includes=DIR' and `--x-libraries=DIR' options tell the build
109 process where the compiler should look for the include files and 109 process where the compiler should look for the include files and
113 113
114 The `--site-includes=DIR' and `--site-libraries=DIR' options allow you 114 The `--site-includes=DIR' and `--site-libraries=DIR' options allow you
115 to specify additional places the compiler should look for include 115 to specify additional places the compiler should look for include
116 files and object libraries. You may specify multiple DIR's by 116 files and object libraries. You may specify multiple DIR's by
117 enclosing the list in quotes. All the external packages you want to 117 enclosing the list in quotes. All the external packages you want to
118 use with XEmacs (e.g. xpm, wnn, ...) described later should have their 118 use with XEmacs (e.g. xpm, wnn, ...) described later should have their
119 include and library directories defined using these options. 119 include and library directories defined using these options.
120 120
121 The `--site-runtime-libraries=DIR' option specifies directories to 121 The `--site-runtime-libraries=DIR' option specifies directories to
122 search for shared libraries at run time. This may be necessary if you 122 search for shared libraries at run time. This may be necessary if you
123 link with dynamic libraries that are installed in non-standard 123 link with dynamic libraries that are installed in non-standard
164 164
165 The `--dynamic' option specifies that configure should try to link 165 The `--dynamic' option specifies that configure should try to link
166 emacs dynamically rather than statically. 166 emacs dynamically rather than statically.
167 167
168 The `--const-is-losing' option is for use if you have trouble 168 The `--const-is-losing' option is for use if you have trouble
169 compiling due to the `const' storage class in C. This is defined by 169 compiling due to the `const' storage class in C. This is defined by
170 default. Most users should have no need to change this. 170 default. Most users should have no need to change this.
171 171
172 You can build XEmacs for several different machine types from a single 172 You can build XEmacs for several different machine types from a single
173 source directory. To do this, you must use a version of `make' that 173 source directory. To do this, you must use a version of `make' that
174 supports the `VPATH' variable, such as GNU `make'. Make separate 174 supports the `VPATH' variable, such as GNU `make'. Make separate
251 installed prior to building XEmacs. 251 installed prior to building XEmacs.
252 252
253 The `--with-sparcworks' option specifies that XEmacs should be built 253 The `--with-sparcworks' option specifies that XEmacs should be built
254 with support for Sun Sparcworks 3.0.1 and up (including Sun WorkShop). 254 with support for Sun Sparcworks 3.0.1 and up (including Sun WorkShop).
255 This functionality is only of use on SunOS 4.1.x and Solaris 2.x 255 This functionality is only of use on SunOS 4.1.x and Solaris 2.x
256 systems. If you use this option, you should have the Sun package (see 256 systems. If you use this option, you should have the Sun package (see
257 etc/PACKAGES) installed prior to building XEmacs. 257 etc/PACKAGES) installed prior to building XEmacs.
258 258
259 The `--with-cde' option allows you to enable or disable CDE drag and 259 The `--with-cde' option allows you to enable or disable CDE drag and
260 drop support. `configure' will attempt to detect this option and 260 drop support. `configure' will attempt to detect this option and
261 define `--with-cde' for you. 261 define `--with-cde' for you.
262 262
263 The `--with-offix' option allows you to enable or disable OffiX drag and 263 The `--with-offix' option allows you to enable or disable OffiX drag
264 drop support. `configure' will attempt to detect this option and 264 and drop support. This requires no external library support, so if
265 define `--with-offix' for you. 265 X11 support is available, then this option defaults to `yes'. OffiX
266 support can be explicitly disabled via the `--without-offix' option.
266 267
267 The `--external-widget' option specifies that XEmacs should be built 268 The `--external-widget' option specifies that XEmacs should be built
268 with support for being used as a widget by other X11 applications. 269 with support for being used as a widget by other X11 applications.
269 This functionality should be considered beta. 270 This functionality should be considered beta.
270 271
271 The `--with-xmu=no' option can be used if your vendor doesn't ship 272 The `--without-xmu' option can be used if your vendor doesn't ship
272 the Xmu library. 273 the Xmu library.
273 274
274 The `--puresize' option can be used to change the amount of purespace 275 The `--puresize' option can be used to change the amount of purespace
275 allocated for the dumped XEmacs. As of XEmacs 20.1 usage of this 276 allocated for the dumped XEmacs. As of XEmacs 20.1 usage of this
276 parameter is deprecated and will be ignored. 277 parameter is deprecated and will be ignored.
340 support in Lesstif (a Free Motif replacement) does not work as of 341 support in Lesstif (a Free Motif replacement) does not work as of
341 v0.82. If you enable this option, you will probably wish to install 342 v0.82. If you enable this option, you will probably wish to install
342 the `locale' package which contains localized Splash screens and 343 the `locale' package which contains localized Splash screens and
343 Menubars. 344 Menubars.
344 345
345 The `--with-xfs' option enables use of a multilingual Menubar. At the 346 The `--with-xfs' option enables use of a multilingual Menubar. At the
346 present time, only Japanese and French locales are supported. In 347 present time, only Japanese and French locales are supported. In
347 order to use a multilingual Menubar you must have the `locale' package 348 order to use a multilingual Menubar you must have the `locale' package
348 installed. The `locale' package does not have to be installed when 349 installed. The `locale' package does not have to be installed when
349 building XEmacs. 350 building XEmacs.
350 351
351 The `--with-canna' option enables the use of the Canna Japanese input 352 The `--with-canna' option enables the use of the Canna Japanese input
352 method. This is stable code and fairly well tested. In order to use 353 method. This is stable code and fairly well tested. In order to use
354 Canna versions 3.2pl2 and 3.5b2 are known to work. Version 3.2pl2 is 355 Canna versions 3.2pl2 and 3.5b2 are known to work. Version 3.2pl2 is
355 considered most stable than version 3.5b2. If Canna is already 356 considered most stable than version 3.5b2. If Canna is already
356 installed, configure will autodetect it, so you never need to 357 installed, configure will autodetect it, so you never need to
357 explicitly use this option unless your Canna libraries are somewhere 358 explicitly use this option unless your Canna libraries are somewhere
358 strange. Canna run time support is currently bundled with the 359 strange. Canna run time support is currently bundled with the
359 `mule-base' package so there is nothing additional to install in order 360 `mule-base' package so there is nothing additional to install in order
360 to use it. 361 to use it.
361 362
362 The `--with-wnn' and `--with-wnn6' options are for compiling with the Wnn 363 The `--with-wnn' and `--with-wnn6' options are for compiling with the Wnn
363 multi-language input method. `--with-wnn' is for compiling with Wnn-4.2, 364 multi-language input method. `--with-wnn' is for compiling with Wnn-4.2,
364 the Free version of WNN. `--with-wnn6' is for compiling against WNN6, 365 the Free version of WNN. `--with-wnn6' is for compiling against WNN6,