Mercurial > hg > xemacs-beta

comparison INSTALL @ 5704:37b107e878b8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
More corrections to INSTALL by Robert Royer.
author Stephen J. Turnbull <stephen@xemacs.org>
date Fri, 28 Dec 2012 12:35:44 +0900
parents a95c89dc9695
children 9c17f7be0b92
comparison
equal deleted inserted replaced
5703:6b027725e340 5704:37b107e878b8
26 PREREQUISITES 26 PREREQUISITES
27 ============= 27 =============
28 28
29 Modern systems generally have more than enough RAM and virtual memory to run 29 Modern systems generally have more than enough RAM and virtual memory to run
30 XEmacs well. If you run into an "insufficient memory" error when building 30 XEmacs well. If you run into an "insufficient memory" error when building
31 or on the first execution, see the 'PROBLEMS' file. In sufficient stack 31 or on the first execution, see the 'PROBLEMS' file. Insufficient stack
32 space is a separate problem, also address in 'PROBLEMS'. 32 space is a separate problem, also addressed in 'PROBLEMS'.
33 33
34 Building XEmacs requires about 100 Mb of disk space (including the XEmacs 34 Building XEmacs requires about 100 Mb of disk space (including the XEmacs
35 sources). Once installed, XEmacs occupies about 200 MB in the file system 35 sources). Once installed, XEmacs occupies about 200 MB in the file system
36 where it is installed, including the executable files, Lisp libraries, 36 where it is installed, including the executable files, Lisp libraries,
37 miscellaneous data files, and on-line documentation. 37 miscellaneous data files, and on-line documentation.
134 resource is the help channels for your OS distribution. If that doesn't 134 resource is the help channels for your OS distribution. If that doesn't
135 help, or you think you have the right files installed but the built XEmacs 135 help, or you think you have the right files installed but the built XEmacs
136 doesn't seem to have all the corresponding features, check with the newsgroup 136 doesn't seem to have all the corresponding features, check with the newsgroup
137 'comp.emacs.xemacs' or the mailing list 'xemacs-beta@xemacs.org'. 137 'comp.emacs.xemacs' or the mailing list 'xemacs-beta@xemacs.org'.
138 138
139 SELECTING configure OPTIONS 139 SELECTING CONFIGURE OPTIONS
140 =========================== 140 ===========================
141 141
142 Options are generally of the form `--with-FEATURE' to use a feature or 142 Options are generally of the form `--with-FEATURE' to use a feature or
143 `--without-FEATURE' to not use a feature. (Unlike the `configure' program 143 `--without-FEATURE' to not use a feature. (Unlike the `configure' program
144 used in other applications, either `--with-FEATURE' or `--enable-FEATURE' can 144 used in other applications, either `--with-FEATURE' or `--enable-FEATURE' can
400 `gnuclient', `gnudoit', and `gnuattach'. 400 `gnuclient', `gnudoit', and `gnuattach'.
401 401
402 `/usr/local/share/xemacs-VERSION/lisp' holds the basic Emacs Lisp libraries 402 `/usr/local/share/xemacs-VERSION/lisp' holds the basic Emacs Lisp libraries
403 (including core implementations of many Lisp primitives); 403 (including core implementations of many Lisp primitives);
404 `VERSION' stands for the number of the XEmacs version 404 `VERSION' stands for the number of the XEmacs version
405 you are installing, like `19.14' or `21.5.31'. Since 405 you are installing, like `21.4.22' or `21.5-b32'. Since
406 the lisp libraries change from one version of XEmacs to 406 the lisp libraries change from one version of XEmacs to
407 another, including the version number in the path 407 another, including the version number in the path
408 allows you to have several versions of XEmacs installed 408 allows you to have several versions of XEmacs installed
409 at the same time; this means that you don't have to 409 at the same time; this means that you don't have to
410 make XEmacs unavailable while installing a new version. 410 make XEmacs unavailable while installing a new version.
498 498
499 PROBLEMS 499 PROBLEMS
500 ======== 500 ========
501 501
502 The most common problem is that you forgot to read and follow the directions 502 The most common problem is that you forgot to read and follow the directions
503 for installing bootstrap packages in the FAQ. You can not have a normal 503 for installing bootstrap packages in the FAQ. You cannot have a normal
504 XEmacs without downloading some additional packages. 504 XEmacs without downloading some additional packages.
505 505
506 See the file PROBLEMS in this directory for a list of various problems 506 See the file PROBLEMS in this directory for a list of various problems
507 sometimes encountered, and what to do about them. PROBLEMS is also the place 507 sometimes encountered, and what to do about them. PROBLEMS is also the place
508 where platform-specific build notes can be found. 508 where platform-specific build notes can be found.
758 `bindir' indicates where to put executable programs that users can 758 `bindir' indicates where to put executable programs that users can
759 run. This defaults to /usr/local/bin. 759 run. This defaults to /usr/local/bin.
760 760
761 `datadir' indicates where to put the architecture-independent 761 `datadir' indicates where to put the architecture-independent
762 read-only data files that XEmacs refers to while it runs; it 762 read-only data files that XEmacs refers to while it runs; it
763 defaults to /usr/local/data. We create the following 763 defaults to /usr/local/share. We create the following
764 subdirectories under `datadir': 764 subdirectories under `datadir':
765
765 - `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and 766 - `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and
766 767
767 - `xemacs-VERSION/etc', containing the XEmacs tutorial and the 768 - `xemacs-VERSION/etc', containing the XEmacs tutorial and the
768 `yow' database. 769 `yow' database.
770
769 `VERSION' is the number of the XEmacs version you are installing, 771 `VERSION' is the number of the XEmacs version you are installing,
770 like `18.59' or `19.14'. Since these files vary from one version 772 like `21.4.22' or `21.5-b32'. Since these files vary from one
771 of XEmacs to another, including the version number in the path 773 version of XEmacs to another, including the version number in the
772 allows you to have several versions of XEmacs installed at the 774 path allows you to have several versions of XEmacs installed at
773 same time; this means that you don't have to make XEmacs 775 the same time; this means that you don't have to make XEmacs
774 unavailable while installing a new version. 776 unavailable while installing a new version.
775 777
776 `datarootdir' indicates where to put the documentation. (Usually, 778 `datarootdir' indicates where to put the documentation. (Usually,
777 this is identical to `datadir'---in the default configuration 779 this is identical to `datadir'---in the default configuration
778 `datadir' is set to the value of `datarootdir'.) 780 `datadir' is set to the value of `datarootdir'.)
882 The top-level Makefile stores the variable settings it used in the Makefiles 884 The top-level Makefile stores the variable settings it used in the Makefiles
883 for the subdirectories, so you don't have to specify them when running make 885 for the subdirectories, so you don't have to specify them when running make
884 in the subdirectories. 886 in the subdirectories.
885 887
886 Using GNU Make allows for simultaneous builds with and without the --srcdir 888 Using GNU Make allows for simultaneous builds with and without the --srcdir
887 option. 889 option (see the section Running Configure).
888 890
889 MAIL LOCKING 891 MAIL LOCKING
890 ============ 892 ============
891 893
892 For most platforms, configure or the src/s file have the preferred method for 894 For most platforms, configure or the src/s file have the preferred method for
1175 unnecessary directories leads to obscure problems (typically startup delays) 1177 unnecessary directories leads to obscure problems (typically startup delays)
1176 if those directories are mounted over a network, and the automounter 1178 if those directories are mounted over a network, and the automounter
1177 configuration changes. Not all systems need this option; it's best to avoid 1179 configuration changes. Not all systems need this option; it's best to avoid
1178 using it if you can. 1180 using it if you can.
1179 1181
1182 To specify multiple directories in these commands, use a list delimited by
1183 spaces, colons, or commas. You will need to protect space-delimited lists
1184 from shell parsing by quoting them.
1185
1180 If you haven't built XEmacs 21.5 recently, the change from the configure 1186 If you haven't built XEmacs 21.5 recently, the change from the configure
1181 script based on Autoconf 2.13 can be a shock. Appendix: Correspondence to 1187 script based on Autoconf 2.13 can be a shock. Appendix: Correspondence to
1182 Old Configure Options (at the end of this document) contains a list of old 1188 Old Configure Options (at the end of this document) contains a list of old
1183 options and their new equivalents. 1189 options and their new equivalents.
1184 1190