Tests defs: improve and extends comments.

* tests/defs.in: Improve and extends some comments, especially in
relation with the changes introduced by the previous reordering.

diff --git a/ChangeLog b/ChangeLog
index 8fd8bad..5761e9f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2010-11-10  Stefano Lattarini  <stefano.lattarini@gmail.com>
 
+       Tests defs: improve and extends comments.
+       * tests/defs.in: Improve and extends some comments, especially in
+       relation with the changes introduced by the previous reordering.
+
        Tests defs: various reorderings.
        * tests/defs.in: Reordered various snippets of code in a
        clearer way.

diff --git a/tests/defs.in b/tests/defs.in
index 57a9cde..022b2a5 100644 (file)
--- a/tests/defs.in
+++ b/tests/defs.in
@@ -51,6 +51,7 @@ fi
 
 echo "=== Running test $0"
 
+# The name of the current test (without the `.test' suffix.)
 me=`echo "$0" | sed -e 's,.*[\\/],,;s/\.test$//'`
 
 
@@ -207,8 +208,12 @@ AUTOMAKE_fails ()
 ##  required by them.                                          ##
 ## ----------------------------------------------------------- ##
 
+# Print it here, so that the user will see it also if the test
+# will be skipped due to some tool missing in $PATH itslef.
 echo "$PATH"
 
+# Look for (and maybe set up) required tools and/or system features; skip
+# the current test if they are not found.
 for tool in : $required
 do
   # Check that each required tool is present.
@@ -390,7 +395,9 @@ case " $required " in
     esac
     # Libtool cannot cope with spaces in the build tree.  Our testsuite setup
     # cannot cope with spaces in the source tree name for Libtool and gettext
-    # tests.
+    # tests.  Using just "`pwd`" for the check here is ok, since the further
+    # temporary subdirectory where the test will be run is ensured not to
+    # contain any space.
     case $testsrcdir,`pwd` in
       *\ * | *\        *) Exit 77;;
     esac