[PATCH 5/6] Adjust docs for renaming and for parallel-tests.

[Ralf Wildenhues]

* README: Update example TESTS setting.
* README.alpha: Likewise.
* NEWS: Update.
* doc/libtool.texi (Test descriptions): Update for test renaming,
adjust descriptions accordingly.

Signed-off-by: Ralf Wildenhues <address@hidden>
---
 ChangeLog        |    6 ++
 NEWS             |   10 +++
 README           |    4 +-
 README.alpha     |    4 +-
 doc/libtool.texi |  162 +++++++++++++++++++++++++++++++++++++++++++++--------
 5 files changed, 157 insertions(+), 29 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0363756..e31a9d1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2010-08-22  Ralf Wildenhues  <address@hidden>
 
+       Adjust docs for renaming and for parallel-tests.
+       * README: Update example TESTS setting.
+       * README.alpha: Likewise.
+       * doc/libtool.texi (Test descriptions): Update for test renaming,
+       adjust descriptions accordingly.
+
        Update VERBOSE handling for parallel-tests driver.
        * tests/defs.m4sh: Default to verbose output, drop now-unneeded
        handling of 'VERBOSE=no'.
diff --git a/NEWS b/NEWS
index 95fa97d..9beb0f7 100644
--- a/NEWS
+++ b/NEWS
@@ -6,8 +6,18 @@ New in 2.2.12 2010-08-??: git version 2.2.11a, Libtool team:
 
   - On non-cygwin Windows systems, we now lookup potential library
     file names without regard to file name case.
+  - The old testsuite now uses the `parallel-tests' Automake test driver
+    now for more concurrency and better test logging.  For this, tests are
+    run in verbose mode by default now.
+
+* Important incompatible changes:
+
+  - Autoconf 2.62 and Automake 1.11.1 or newer are now required for building
+    Libtool.  For using Libtool in your own projects, Autoconf 2.59 and
+    Automake 1.9.6 should still work.
 
 * Changes in supported systems or compilers:
+
   - Initial support for the Microsoft C/C++ Compiler, with help from
     the compile script in unreleased Automake 1.12. Override the manifest
     tool used to embed the manifest resource through the environment
diff --git a/README b/README
index 44396dc..0c13518 100644
--- a/README
+++ b/README
@@ -64,8 +64,8 @@ To run a test group of the old test suite in isolation (say, 
you think
 you have fixed a bug, but don't want to rerun the entire suite), you can
 do it like this:
 
-  gmake check TESTS="tests/cdemo-static.test tests/cdemo-make.test \
-                     tests/cdemo-exec.test" \
+  gmake check TESTS="tests/cdemo-static.test tests/cdemo-static-make.test \
+                     tests/cdemo-static-exec.test" \
               TESTSUITEFLAGS=-V
 
 Providing that you have a FAIL from the most recent group from a
diff --git a/README.alpha b/README.alpha
index ca92329..2632e75 100644
--- a/README.alpha
+++ b/README.alpha
@@ -69,8 +69,8 @@ To run a test group of the old test suite in isolation (say, 
you think
 you have fixed a bug, but don't want to rerun the entire suite), you can
 do it like this:
 
-  gmake check TESTS="tests/cdemo-static.test tests/cdemo-make.test \
-                     tests/cdemo-exec.test" \
+  gmake check TESTS="tests/cdemo-static.test tests/cdemo-static-make.test \
+                     tests/cdemo-static-exec.test" \
              TESTSUITEFLAGS=-V
 
 Providing that you have a FAIL from the most recent group from a
diff --git a/doc/libtool.texi b/doc/libtool.texi
index bf51157..26f9d9e 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -5032,17 +5032,29 @@ they test for:
 @table @file
 
 @item cdemo-conf.test
address@hidden cdemo-exec.test
 @itemx cdemo-make.test
address@hidden cdemo-exec.test
 @itemx cdemo-static.test
address@hidden cdemo-static-make.test
address@hidden cdemo-static-exec.test
 @itemx cdemo-shared.test
address@hidden cdemo-shared-make.test
address@hidden cdemo-shared-exec.test
 @itemx cdemo-undef.test
address@hidden cdemo-undef-make.test
address@hidden cdemo-undef-exec.test
 @pindex cdemo-conf.test
address@hidden cdemo-exec.test
 @pindex cdemo-make.test
address@hidden cdemo-exec.test
 @pindex cdemo-static.test
address@hidden cdemo-static-make.test
address@hidden cdemo-static-exec.test
 @pindex cdemo-shared.test
address@hidden cdemo-shared-make.test
address@hidden cdemo-shared-exec.test
 @pindex cdemo-undef.test
address@hidden cdemo-undef-make.test
address@hidden cdemo-undef-exec.test
 These programs check to see that the @file{tests/cdemo} subdirectory of
 the libtool distribution can be configured and built correctly.
 
@@ -5051,8 +5063,8 @@ convenience libraries, a mechanism that allows build-time 
static
 libraries to be created, in a way that their components can be later
 linked into programs or other libraries, even shared ones.
 
-The tests @file{cdemo-make.test} and @file{cdemo-exec.test} are executed
-three times, under three different libtool configurations:
+The tests matching @file{cdemo-*make.test} and @file{cdemo-*exec.test}
+are executed three times, under three different libtool configurations:
 @file{cdemo-conf.test} configures @file{cdemo/libtool} to build both
 static and shared libraries (the default for platforms that support
 both), @file{cdemo-static.test} builds only static libraries
@@ -5063,33 +5075,65 @@ The test @file{cdemo-undef.test} tests the generation 
of shared
 libraries with undefined symbols on systems that allow this.
 
 @item demo-conf.test
address@hidden demo-make.test
 @itemx demo-exec.test
 @itemx demo-inst.test
address@hidden demo-make.test
 @itemx demo-unst.test
 @itemx demo-static.test
address@hidden demo-static-make.test
address@hidden demo-static-exec.test
address@hidden demo-static-inst.test
address@hidden demo-static-unst.test
 @itemx demo-shared.test
address@hidden demo-shared-make.test
address@hidden demo-shared-exec.test
address@hidden demo-shared-inst.test
address@hidden demo-shared-unst.test
 @itemx demo-nofast.test
address@hidden demo-nofast-make.test
address@hidden demo-nofast-exec.test
address@hidden demo-nofast-inst.test
address@hidden demo-nofast-unst.test
 @itemx demo-pic.test
address@hidden demo-pic-make.test
address@hidden demo-pic-exec.test
 @itemx demo-nopic.test
address@hidden demo-nopic-make.test
address@hidden demo-nopic-exec.test
 @pindex demo-conf.test
address@hidden demo-make.test
 @pindex demo-exec.test
 @pindex demo-inst.test
address@hidden demo-make.test
 @pindex demo-unst.test
 @pindex demo-static.test
address@hidden demo-static-make.test
address@hidden demo-static-exec.test
address@hidden demo-static-inst.test
address@hidden demo-static-unst.test
 @pindex demo-shared.test
address@hidden demo-shared-make.test
address@hidden demo-shared-exec.test
address@hidden demo-shared-inst.test
address@hidden demo-shared-unst.test
 @pindex demo-nofast.test
address@hidden demo-nofast-make.test
address@hidden demo-nofast-exec.test
address@hidden demo-nofast-inst.test
address@hidden demo-nofast-unst.test
 @pindex demo-pic.test
address@hidden demo-pic-make.test
address@hidden demo-pic-exec.test
 @pindex demo-nopic.test
address@hidden demo-nopic-make.test
address@hidden demo-nopic-exec.test
 These programs check to see that the @file{tests/demo} subdirectory of
 the libtool distribution can be configured, built, installed, and
 uninstalled correctly.
 
 The @file{tests/demo} subdirectory contains a demonstration of a trivial
-package that uses libtool.  The tests @file{demo-make.test},
address@hidden, @file{demo-inst.test} and
address@hidden are executed four times, under four different
+package that uses libtool.  The tests matching @file{demo-*make.test},
address@hidden, @file{demo-*inst.test} and
address@hidden are executed four times, under four different
 libtool configurations: @file{demo-conf.test} configures
 @file{demo/libtool} to build both static and shared libraries,
 @file{demo-static.test} builds only static libraries
@@ -5130,21 +5174,45 @@ Checks whether libtool will not try to link with a 
previously installed
 version of a library when it should be linking with a just-built one.
 
 @item depdemo-conf.test
address@hidden depdemo-make.test
 @itemx depdemo-exec.test
 @itemx depdemo-inst.test
address@hidden depdemo-make.test
 @itemx depdemo-unst.test
 @itemx depdemo-static.test
address@hidden depdemo-static-make.test
address@hidden depdemo-static-exec.test
address@hidden depdemo-static-inst.test
address@hidden depdemo-static-unst.test
 @itemx depdemo-shared.test
address@hidden depdemo-shared-make.test
address@hidden depdemo-shared-exec.test
address@hidden depdemo-shared-inst.test
address@hidden depdemo-shared-unst.test
 @itemx depdemo-nofast.test
address@hidden depdemo-nofast-make.test
address@hidden depdemo-nofast-exec.test
address@hidden depdemo-nofast-inst.test
address@hidden depdemo-nofast-unst.test
 @pindex depdemo-conf.test
address@hidden depdemo-make.test
 @pindex depdemo-exec.test
 @pindex depdemo-inst.test
address@hidden depdemo-make.test
 @pindex depdemo-unst.test
 @pindex depdemo-static.test
address@hidden depdemo-static-make.test
address@hidden depdemo-static-exec.test
address@hidden depdemo-static-inst.test
address@hidden depdemo-static-unst.test
 @pindex depdemo-shared.test
address@hidden depdemo-shared-make.test
address@hidden depdemo-shared-exec.test
address@hidden depdemo-shared-inst.test
address@hidden depdemo-shared-unst.test
 @pindex depdemo-nofast.test
address@hidden depdemo-nofast-make.test
address@hidden depdemo-nofast-exec.test
address@hidden depdemo-nofast-inst.test
address@hidden depdemo-nofast-unst.test
 These programs check to see that the @file{tests/depdemo} subdirectory
 of the libtool distribution can be configured, built, installed, and
 uninstalled correctly.
@@ -5153,8 +5221,8 @@ The @file{tests/depdemo} subdirectory contains a 
demonstration of
 inter-library dependencies with libtool.  The test programs link some
 interdependent libraries.
 
-The tests @file{depdemo-make.test}, @file{depdemo-exec.test},
address@hidden and @file{depdemo-unst.test} are executed
+The tests matching @file{depdemo-*make.test}, @file{depdemo-*exec.test},
address@hidden and @file{depdemo-*unst.test} are executed
 four times, under four different libtool configurations:
 @file{depdemo-conf.test} configures @file{depdemo/libtool} to build both
 static and shared libraries, @file{depdemo-static.test} builds only static
@@ -5164,19 +5232,35 @@ only shared libraries (@option{--disable-static}).
 disable the fast-install mode (@option{--enable-fast-install=no}).
 
 @item mdemo-conf.test
address@hidden mdemo-make.test
 @itemx mdemo-exec.test
 @itemx mdemo-inst.test
address@hidden mdemo-make.test
 @itemx mdemo-unst.test
 @itemx mdemo-static.test
address@hidden mdemo-static-make.test
address@hidden mdemo-static-exec.test
address@hidden mdemo-static-inst.test
address@hidden mdemo-static-unst.test
 @itemx mdemo-shared.test
address@hidden mdemo-shared-make.test
address@hidden mdemo-shared-exec.test
address@hidden mdemo-shared-inst.test
address@hidden mdemo-shared-unst.test
 @pindex mdemo-conf.test
address@hidden mdemo-make.test
 @pindex mdemo-exec.test
 @pindex mdemo-inst.test
address@hidden mdemo-make.test
 @pindex mdemo-unst.test
 @pindex mdemo-static.test
address@hidden mdemo-static-make.test
address@hidden mdemo-static-exec.test
address@hidden mdemo-static-inst.test
address@hidden mdemo-static-unst.test
 @pindex mdemo-shared.test
address@hidden mdemo-shared-make.test
address@hidden mdemo-shared-exec.test
address@hidden mdemo-shared-inst.test
address@hidden mdemo-shared-unst.test
 These programs check to see that the @file{tests/mdemo} subdirectory of
 the libtool distribution can be configured, built, installed, and
 uninstalled correctly.
@@ -5187,8 +5271,8 @@ package that uses libtool and the system independent 
dlopen wrapper
 dlopen wrapper for various platforms (Linux, Solaris, HP/UX etc.)
 including support for dlpreopened modules (@pxref{Dlpreopening}).
 
-The tests @file{mdemo-make.test}, @file{mdemo-exec.test},
address@hidden and @file{mdemo-unst.test} are executed
+The tests matching @file{mdemo-*make.test}, @file{mdemo-*exec.test},
address@hidden and @file{mdemo-*unst.test} are executed
 three times, under three different libtool configurations:
 @file{mdemo-conf.test} configures @file{mdemo/libtool} to build both
 static and shared libraries, @file{mdemo-static.test} builds only static
@@ -5232,13 +5316,13 @@ Check whether we can actually get help for libtool.
 Check that a nonexistent objectlist file is properly detected.
 
 @item pdemo-conf.test
address@hidden pdemo-make.test
 @itemx pdemo-exec.test
 @itemx pdemo-inst.test
address@hidden pdemo-make.test
 @pindex pdemo-conf.test
address@hidden pdemo-make.test
 @pindex pdemo-exec.test
 @pindex pdemo-inst.test
address@hidden pdemo-make.test
 These programs check to see that the @file{tests/pdemo} subdirectory of
 the libtool distribution can be configured, built, and executed
 correctly.
@@ -5264,17 +5348,29 @@ This test validates that libtool can handle suffixes 
for all the file
 types that it supports, and that it fails when the suffix is invalid.
 
 @item tagdemo-conf.test
address@hidden tagdemo-exec.test
 @itemx tagdemo-make.test
address@hidden tagdemo-exec.test
 @itemx tagdemo-static.test
address@hidden tagdemo-static-make.test
address@hidden tagdemo-static-exec.test
 @itemx tagdemo-shared.test
address@hidden tagdemo-shared-make.test
address@hidden tagdemo-shared-exec.test
 @itemx tagdemo-undef.test
address@hidden tagdemo-undef-make.test
address@hidden tagdemo-undef-exec.test
 @pindex tagdemo-conf.test
address@hidden tagdemo-exec.test
 @pindex tagdemo-make.test
address@hidden tagdemo-exec.test
 @pindex tagdemo-static.test
address@hidden tagdemo-static-make.test
address@hidden tagdemo-static-exec.test
 @pindex tagdemo-shared.test
address@hidden tagdemo-shared-make.test
address@hidden tagdemo-shared-exec.test
 @pindex tagdemo-undef.test
address@hidden tagdemo-undef-make.test
address@hidden tagdemo-undef-exec.test
 These programs check to see that the @file{tests/tagdemo} subdirectory
 of the libtool distribution can be configured, built, and executed
 correctly.
@@ -5285,15 +5381,23 @@ It generates a library from C++ sources, which is then 
linked to a C++
 program.
 
 @item f77demo-conf.test
address@hidden f77demo-exec.test
 @itemx f77demo-make.test
address@hidden f77demo-exec.test
 @itemx f77demo-static.test
address@hidden f77demo-static-make.test
address@hidden f77demo-static-exec.test
 @itemx f77demo-shared.test
address@hidden f77demo-shared-make.test
address@hidden f77demo-shared-exec.test
 @pindex f77demo-conf.test
address@hidden f77demo-exec.test
 @pindex f77demo-make.test
address@hidden f77demo-exec.test
 @pindex f77demo-static.test
address@hidden f77demo-static-make.test
address@hidden f77demo-static-exec.test
 @pindex f77demo-shared.test
address@hidden f77demo-shared-make.test
address@hidden f77demo-shared-exec.test
 These programs check to see that the @file{tests/f77demo} subdirectory
 of the libtool distribution can be configured, built, and executed
 correctly.
@@ -5304,15 +5408,23 @@ sources, and a Fortran 77 program to use the former 
library, and a C
 program to use the latter library.
 
 @item fcdemo-conf.test
address@hidden fcdemo-exec.test
 @itemx fcdemo-make.test
address@hidden fcdemo-exec.test
 @itemx fcdemo-static.test
address@hidden fcdemo-static-make.test
address@hidden fcdemo-static-exec.test
 @itemx fcdemo-shared.test
address@hidden fcdemo-shared-make.test
address@hidden fcdemo-shared-exec.test
 @pindex fcdemo-conf.test
address@hidden fcdemo-exec.test
 @pindex fcdemo-make.test
address@hidden fcdemo-exec.test
 @pindex fcdemo-static.test
address@hidden fcdemo-static-make.test
address@hidden fcdemo-static-exec.test
 @pindex fcdemo-shared.test
address@hidden fcdemo-shared-make.test
address@hidden fcdemo-shared-exec.test
 These programs check to see that the @file{tests/fcdemo} subdirectory
 of the libtool distribution can be configured, built, and executed
 correctly.
-- 
1.7.2.1.222.g9988