This patch seems fine to me except that the doc/PLATFORMS information
referred to is totally archaic. It does not really matter if libtool
0.8 worked on alpha-dec-osf3.2 because we have no clue if modern
libtool does so and probably don't really care if it does. It seems
to me that doc/PLATFORMS should refer to the most recently verified
version, and not to the first version which worked. Given this, we
should plan on re-starting doc/PLATFORMS from scratch.
Bob
On Sat, 18 Sep 2010, Gary V. Vaughan wrote:
* 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.
---
ChangeLog | 6 ++++++
README | 30 ++++++++++++++++++++----------
README.alpha | 37 ++++++++++++++++++++++++++++---------
3 files changed, 54 insertions(+), 19 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 3e1cb95..9db58e1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
2010-09-18 Gary V. Vaughan <g...@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 16328bb..acf8f8b 100644
--- a/README
+++ b/README
@@ -8,22 +8,32 @@ 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.
+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.
+
+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 <libt...@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 8c72c03..6f4ed3b 100644
--- a/README.alpha
+++ b/README.alpha
@@ -4,17 +4,36 @@ 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 <libt...@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.
+
+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.
+
+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 <libt...@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
--
Bob Friesenhahn
bfrie...@simple.dallas.tx.us, http://www.simplesystems.org/users/bfriesen/
GraphicsMagick Maintainer, http://www.GraphicsMagick.org/
