APPROVE COMMIT 21.5
Robert Royar writes:
 I have made some corrections (to minor word forms and version
numbers)
 in the new INSTALL file. The patch is included for INSTALL and
 CHANGELOG. 
Thank you, Robert!  I didn't actually read much past the section
titles. ;-)
 I read one section where more detail would help, but I do
 not know the detail to add. In "Specifying Location of Headers and
 Libraries" the --with-site-runtime-libraries explanation states that
 multiple directories can be added to the search path; however, it does
 not specify the format of that list. 
As you guessed, the same code is used for processing all these lists.
I added a paragraph to that effect.
 In the section "Advanced Make" the default for datadir is
listed as
 /usr/local/data. This does not seem to be correct on all systems. 
As Sean pointed out, this is a 21.5 improvement (ie, FHS compatibility).
 I changed references to version numbers at various places in the file
Good idea.  I fixed the syntax of betas (21.5-b32) and added the
patchlevel for the stable line.
 Consider whether the section "Selecting configure Options"
should
 include a forward reference to "Appendix: Correspondence to Old
 configure Options." The list of removed options and enable/with
 modifiers could be useful. I suggest moving the last paragraph of
 "Random Notes" into the "Selecting configure Options" section.
Postponed to issue849.
 I am not certain of the style for some nomenclature. I cannot tell
 whether the document should always to refer to the file `configure' in
 all lower case or to let that float. 
I put section titles in upper case, text uses in lower case, and
references to section titles in title case.
# HG changeset patch
# Parent 6b027725e3401176451d62ba5e86de32bc38c6d6
More corrections to INSTALL by Robert Royer.
diff -r 6b027725e340 -r 37b107e878b8 ChangeLog
--- a/ChangeLog	Fri Dec 28 02:29:16 2012 +0900
+++ b/ChangeLog	Fri Dec 28 12:35:44 2012 +0900
@@ -1,3 +1,13 @@
+2012-12-27  Robert D. Royar	<xemacs(a)royar.org>
+
+	Minor additions by Stephen J. Turnbull <stephen(a)xemacs.org>.
+
+	* INSTALL: correct typographical errors; update 
+	version numbers provided in Running Make section;
+	change default datadir reference to /usr/local/share
+	to match all other references to datadir's subdirectories;
+	change "can not" to "cannot".
+
 2012-11-04  Stephen J. Turnbull  <stephen(a)xemacs.org>
 
 	* INSTALL: Reorganize and update.
diff -r 6b027725e340 -r 37b107e878b8 INSTALL
--- a/INSTALL	Fri Dec 28 02:29:16 2012 +0900
+++ b/INSTALL	Fri Dec 28 12:35:44 2012 +0900
@@ -28,8 +28,8 @@
 
 Modern systems generally have more than enough RAM and virtual memory to run
 XEmacs well.  If you run into an "insufficient memory" error when building
-or on the first execution, see the 'PROBLEMS' file.  In sufficient stack
-space is a separate problem, also address in 'PROBLEMS'.
+or on the first execution, see the 'PROBLEMS' file.  Insufficient stack
+space is a separate problem, also addressed in 'PROBLEMS'.
 
 Building XEmacs requires about 100 Mb of disk space (including the XEmacs
 sources).  Once installed, XEmacs occupies about 200 MB in the file system
@@ -136,7 +136,7 @@
 doesn't seem to have all the corresponding features, check with the newsgroup
 'comp.emacs.xemacs' or the mailing list 'xemacs-beta(a)xemacs.org'.
 
-SELECTING configure OPTIONS
+SELECTING CONFIGURE OPTIONS
 ===========================
 
 Options are generally of the form `--with-FEATURE' to use a feature or
@@ -402,7 +402,7 @@
 `/usr/local/share/xemacs-VERSION/lisp' holds the basic Emacs Lisp libraries
                 (including core implementations of many Lisp primitives);
 		`VERSION' stands for the number of the XEmacs version
-		you are installing, like `19.14' or `21.5.31'.  Since
+		you are installing, like `21.4.22' or `21.5-b32'.  Since
 		the lisp libraries change from one version of XEmacs to
 		another, including the version number in the path
 		allows you to have several versions of XEmacs installed
@@ -500,7 +500,7 @@
 ========
 
 The most common problem is that you forgot to read and follow the directions
-for installing bootstrap packages in the FAQ.  You can not have a normal
+for installing bootstrap packages in the FAQ.  You cannot have a normal
 XEmacs without downloading some additional packages.
 
 See the file PROBLEMS in this directory for a list of various problems
@@ -760,17 +760,19 @@
 
 `datadir' indicates where to put the architecture-independent
 	read-only data files that XEmacs refers to while it runs; it
-	defaults to /usr/local/data.  We create the following
+	defaults to /usr/local/share.  We create the following
 	subdirectories under `datadir':
+
 	- `xemacs-VERSION/lisp', containing the XEmacs lisp libraries, and
 
 	- `xemacs-VERSION/etc', containing the XEmacs tutorial and the
 		`yow' database.
+
 	`VERSION' is the number of the XEmacs version you are installing,
-	like `18.59' or `19.14'.  Since these files vary from one version
-	of XEmacs to another, including the version number in the path
-	allows you to have several versions of XEmacs installed at the
-	same time; this means that you don't have to make XEmacs
+	like `21.4.22' or `21.5-b32'.  Since these files vary from one
+	version	of XEmacs to another, including the version number in the
+	path allows you to have several versions of XEmacs installed at
+	the same time; this means that you don't have to make XEmacs
 	unavailable while installing a new version.
 
 `datarootdir' indicates where to put the documentation.  (Usually,
@@ -884,7 +886,7 @@
 in the subdirectories.
 
 Using GNU Make allows for simultaneous builds with and without the --srcdir
-option.
+option (see the section Running Configure).
 
 MAIL LOCKING
 ============
@@ -1177,6 +1179,10 @@
 configuration changes.  Not all systems need this option; it's best to avoid
 using it if you can.
 
+To specify multiple directories in these commands, use a list delimited by
+spaces, colons, or commas.  You will need to protect space-delimited lists
+from shell parsing by quoting them.
+
 If you haven't built XEmacs 21.5 recently, the change from the configure
 script based on Autoconf 2.13 can be a shock.  Appendix: Correspondence to
 Old Configure Options (at the end of this document) contains a list of old
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://lists.xemacs.org/mailman/listinfo/xemacs-patches