From: Stefano Lattarini <stefano.lattarini@gmail.com>
Date: Wed, 10 Nov 2010 22:46:57 +0000 (+0100)
Subject: Tests defs: improve and extends comments.
X-Git-Tag: ng-0.5a~343^2~8
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=498bb93fe6fcd255959990c411a438a2d0cf1fa3;p=thirdparty%2Fautomake.git

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 8fd8bad37..5761e9faa 100644
--- 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 57a9cde49..022b2a52d 100644
--- 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