This commit was generated by cvs2svn to compensate for changes in r5670,
[chise/xemacs-chise.git.1] / INSTALL
diff --git a/INSTALL b/INSTALL
index 4019235..3cbcd98 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -32,8 +32,8 @@ error in the command `temacs -batch -l loadup dump', found in
 XEmacs.
 
 Verify that your users have a high enough stack limit. On some systems
-such as OpenBSD and OSF/Tru64 the default is 2MB which is too low. See
-'PROBLEMS' for details.
+such as OpenBSD and OSF/Tru64 the default is 2MB which is too low.  On
+MacOS/X (Darwin), it's 512kB.  See 'PROBLEMS' for details.
 
 Building XEmacs requires about 100 Mb of disk space (including the
 XEmacs sources).  Once installed, XEmacs occupies between 20 and 100 Mb
@@ -44,7 +44,8 @@ installed
 
 XEmacs requires an ANSI C compiler, such as GCC.  If you wish to build
 the documentation yourself, you will need at least version 1.68 of
-makeinfo (GNU texinfo-3.11).
+makeinfo (GNU texinfo-3.11).  GNU Texinfo 4.2 is recommended; it is
+necessary for building packages, and we may move to it for the core.
 
 ADD-ON LIBRARIES
 ================
@@ -292,7 +293,7 @@ The `--rel-alloc' option can be used to either enable or disable use
 of the relocating allocator.  Turning on --rel-alloc will allow XEmacs
 to return unused memory to the operating system, thereby reducing its
 memory footprint.  However, it may make XEmacs runs more slowly,
-especially if your system's `mmap' implemntation is missing or
+especially if your system's `mmap' implementation is missing or
 inefficient.  Generally, it's best to go with the default
 configuration for your system.  You can tweak this based on how you
 use XEmacs, and the memory and cpu resources available on your system.
@@ -320,7 +321,7 @@ determining configure failures is the file `config.log', which
 contains the results of the compile and link tests used by configure.
 
 The `--with-mule' option enables (MUlti-Lingual Emacs) support, needed
-to suport non-Latin-1 (including Asian) languages.  The Mule support
+to support non-Latin-1 (including Asian) languages.  The Mule support
 is not yet as stable or efficient as the `Latin1' support.   Enabling
 Mule support requires the mule-base package installed prior to
 building XEmacs.  The following options require Mule support:
@@ -373,11 +374,16 @@ supports.
 MAIL LOCKING
 ============
 
-Find out what the preferred method for locking mail spool files is in
-your environment.  Presently, XEmacs supports lockf, flock, and dot
-locking.  Specify the locking method via the --mail-locking=METHOD
-option to configure.  Valid values for METHOD are --mail-locking are
-`lockf', `flock', and `dot'.
+For most platforms, configure or the src/s file have the preferred
+method for locking mail spool files preconfigured.  Otherwise you must
+find out for youself.  Do not choose a locking protocol "on the
+objective merits."  XEmacs must use the same method as other mail
+utilities on your system, or you will lose mail.
+
+Presently, XEmacs supports lockf, flock, and dot locking.  Specify the
+locking method via the --mail-locking=METHOD option to configure.
+Valid values for METHOD are --mail-locking are `lockf', `flock', and
+`dot'.
 
 RUNNING CONFIGURE
 =================
@@ -639,8 +645,8 @@ GNU software; here are some variables specific to XEmacs.
        `/usr/local/lib/xemacs-VERSION/CONFIGURATION-NAME/modules'
        (where VERSION and CONFIGURATION-NAME are as described above).
        By their very nature, dynamic loadable modules are architecture-
-       dependant, and care should be taken not to set this directory
-       to a system- or architecture-independant directory.
+       dependent, and care should be taken not to set this directory
+       to a system- or architecture-independent directory.
 
 Remember that you must specify any variable values you need each time
 you run `make' in the top directory.  If you run `make' once to build
@@ -686,5 +692,6 @@ The most likely problem is that you forgot to read and follow the
 directions in README.packages.  You can not have a working XEmacs
 without downloading some additional packages.
 
-See the file PROBLEMS in this directory for a list of various
-problems sometimes encountered, and what to do about them.
+See the file PROBLEMS in this directory for a list of various problems
+sometimes encountered, and what to do about them.  PROBLEMS is also
+the place where platform-specific build notes can be found.