Improve testsuite's --help output.

* lib/autotest/general.m4: Correct the example in ./testsuite --help.
Improve wording.

diff --git a/ChangeLog b/ChangeLog
index 45cc4b4a2ad1822c3b52c74ad8f44c70d231a463..ddac2578b644b5acf526853ce6bb003ca19c0bfc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2009-06-06  Jim Meyering  <meyering@redhat.com>
+
+       Improve testsuite --help
+       * lib/autotest/general.m4: Correct the example in ./testsuite --help.
+       Improve wording.
+
 2009-06-06  Eric Blake  <ebb9@byu.net>
 
        Document fallback behavior of AC_PROG_LEX.

diff --git a/lib/autotest/general.m4 b/lib/autotest/general.m4
index ce653978d10d33253ff3b2e09ef00a3e7b41d6d7..ddc2270a02d7e887d501cab1e717e8c9c7bcd078 100644 (file)
--- a/lib/autotest/general.m4
+++ b/lib/autotest/general.m4
@@ -667,16 +667,17 @@ Usage: $[0] [[OPTION]... [VARIABLE=VALUE]... [TESTS]]
 Run all the tests, or the selected TESTS, given by numeric ranges, and
 save a detailed log file.  Upon failure, create debugging scripts.
 
-You should not change environment variables unless explicitly passed
-as command line arguments.  Set \`AUTOTEST_PATH' to select the executables
+Do not change environment variables directly.  Instead, set them via
+command line arguments.  Set \`AUTOTEST_PATH' to select the executables
 to exercise.  Each relative directory is expanded as build and source
-directories relatively to the top level of this distribution.  E.g.,
+directories relative to the top level of this distribution.
+E.g., from within the build directory /tmp/foo-1.0, invoking this:
 
   $ $[0] AUTOTEST_PATH=bin
 
-possibly amounts into
+is equivalent to the following, assuming the source directory is /src/foo-1.0:
 
-  PATH=/tmp/foo-1.0/bin:/src/foo-1.0/bin:\$PATH
+  PATH=/tmp/foo-1.0/bin:/src/foo-1.0/bin:\$PATH $[0]
 _ATEOF
 m4_divert_pop([HELP])dnl
 m4_divert_push([HELP_MODES])dnl