maint: consolidate Introductions of README and README.alpha.

* README (Introduction): Rewritten to a more logical order for
first time users, incorporating some additional text that was
previously only in README.alpha.
* README.alpha (Introduction): Adjust to match.

Signed-off-by: Gary V. Vaughan <gary@gnu.org>

diff --git a/ChangeLog b/ChangeLog
index 4aaebdc881171f2c9d0f27da54cfd23b06ae76a3..da2247382e2c3fbeb8506ceb5e3cf773087aa1ca 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -6,6 +6,12 @@
 
 2010-09-18  Gary V. Vaughan  <gary@gnu.org>
 
+       maint: consolidate Introductions of README and README.alpha.
+       * README (Introduction): Rewritten to a more logical order for
+       first time users, incorporating some additional text that was
+       previously only in README.alpha.
+       * README.alpha (Introduction): Adjust to match.
+
        maint: copy the Version Numbering section into README.alpha.
        * README.alpha (Version Numbering): No less useful for users
        of alpha releases.  Copied from README.

diff --git a/README b/README
index 16328bb3d36c9041d3283acea99ac660a34a3fe5..c2e83f1e965510a9bc0398a3d52e32205689abf6 100644 (file)
--- a/README
+++ b/README
@@ -8,22 +8,34 @@ This is GNU Libtool, a generic library support script.  Libtool hides
 the complexity of using shared libraries behind a consistent, portable
 interface.
 
-To use Libtool, add the new generic library building commands to your
-Makefile, Makefile.in, or Makefile.am.  See the documentation for
-details.
-
 Libtool's home page is:
 
-  http://www.gnu.org/software/libtool/libtool.html
+    http://www.gnu.org/software/libtool/libtool.html
 
 See the file NEWS for a description of recent changes to Libtool.
 
-See the file INSTALL for generic instructions on how to build and install
-Libtool.  Please see the file doc/notes.txt for some platform-specific
-information.  Please note that you need GNU make to build Libtool.
+Please note that you can build GNU Libtool from this directory using a
+vendor Make program as long as this is an official release tarball;
+otherwise you will need GNU Make for sane VPATH support.  See the file
+INSTALL for complete generic instructions on how to build and install
+Libtool.  Also, see the file doc/notes.txt for some platform- specific
+information.
+
+See the info node (libtool)Tested Platforms. (or the file doc/PLATFORMS)
+for a list of platforms that Libtool already supports.
 
-See the info node (libtool)Tested Platforms. (or the file
-doc/PLATFORMS) for a list of platforms that Libtool supports.
+Please try it on all the platforms you have access to:
+
+ * If it builds and passes the test suite (`gmake check'), please send
+   a short note to the libtool mailing list <libtool@gnu.org> with a
+   subject line including the string `[PLATFORM]', and containing the
+   details from the end of `./libtool --help' in the body.
+ * Otherwise, see `Reporting Bugs' below for how to help us fix any
+   problems you discover.
+
+To use Libtool, add the new generic library building commands to your
+Makefile, Makefile.in, or Makefile.am.  See the documentation for
+details.
 
 
 2. Reporting Bugs

diff --git a/README.alpha b/README.alpha
index 8c72c0397015038f544ef876f52bf49489811104..d7d271872873a31a325212a57e784f9c5db05c7a 100644 (file)
--- a/README.alpha
+++ b/README.alpha
@@ -4,17 +4,38 @@ GNU Libtool
 1. Introduction
 ===============
 
-This is an alpha testing release of GNU Libtool, please try it on all
-the platforms you have access to.  Using it more or less implicitly
-signs you up to help us find whatever problems you report.
+This is an alpha testing release of GNU Libtool, a generic library
+support script.  Libtool hides the complexity of using shared libraries
+behind a consistent, portable interface.
 
-See the file INSTALL for generic instructions on how to build and install
-Libtool.  Please see the file doc/notes.txt for some platform-specific
-information.  Please note that you need GNU make to build Libtool.
+Libtool's home page is:
 
-If it builds and passes the test suite (`gmake check'), please send
-notification to the libtool mailing list <libtool@gnu.org> with a
-subject line including the string `[PLATFORM]'.
+    http://www.gnu.org/software/libtool/libtool.html
+
+See the file NEWS for a description of recent changes to Libtool.
+
+Please note that you can build GNU Libtool from this directory using a
+vendor Make program as long as this is an official release tarball;
+otherwise you will need GNU Make for sane VPATH support.  See the file
+INSTALL for complete generic instructions on how to build and install
+Libtool.  Also, see the file doc/notes.txt for some platform- specific
+information.
+
+See the info node (libtool)Tested Platforms. (or the file doc/PLATFORMS)
+for a list of platforms that Libtool already supports.
+
+Please try it on all the platforms you have access to:
+
+ * If it builds and passes the test suite (`gmake check'), please send
+   a short note to the libtool mailing list <libtool@gnu.org> with a
+   subject line including the string `[PLATFORM]', and containing the
+   details from the end of `./libtool --help' in the body.
+ * Otherwise, see `Reporting Bugs' below for how to help us fix any
+   problems you discover.
+
+To use Libtool, add the new generic library building commands to your
+Makefile, Makefile.in, or Makefile.am.  See the documentation for
+details.
 
 
 2. Reporting Bugs