tests: add excerpts from few original bug reports, for clarity.

* tests/comment6.test: Add excerpts and/or details from the
original bug report that prompted this tests to be added and/or
extended.
* tests/dejagnu4.test: Likewise.
* tests/installdir.test: Likewise.

diff --git a/ChangeLog b/ChangeLog
index 4b10c8e6686cac96f0ae0384d90472072cd47ce9..cf2fc141e0b27795f5de48a1b0158c3e204e8a0f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2011-05-04  Stefano Lattarini  <stefano.lattarini@gmail.com>
+
+       tests: add excerpts from few original bug reports, for clarity.
+       * tests/comment6.test: Add excerpts and/or details from the
+       original bug report that prompted this tests to be added and/or
+       extended.
+       * tests/dejagnu4.test: Likewise.
+       * tests/installdir.test: Likewise.
+
 2011-05-04  Stefano Lattarini  <stefano.lattarini@gmail.com>
 
        tests defs: allow requirements for compilers (mostly dummy)

diff --git a/tests/comment6.test b/tests/comment6.test
index 0895768194fd3991aa8942d717fdecb35ee58281..1c46c8669009f1c208f0847836fedaad2211c11d 100755 (executable)
--- a/tests/comment6.test
+++ b/tests/comment6.test
@@ -15,6 +15,8 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 # Test for PR/322.
+# Automake 1.6.1 seems to have a problem parsing comments that use
+# '\' to span multiple lines.
 
 . ./defs || Exit 1
 
@@ -62,3 +64,5 @@ $AUTOMAKE
 $MAKE
 grep '# SOME_FILES' Makefile
 grep '# *file3' Makefile
+
+:

diff --git a/tests/dejagnu4.test b/tests/dejagnu4.test
index 0d6a1bde2d83dd70cd3fa578f6fa5b05d918131b..02eb4448a9bcde35b450c2810dee35a841054ff8 100755 (executable)
--- a/tests/dejagnu4.test
+++ b/tests/dejagnu4.test
@@ -16,6 +16,12 @@
 
 # Check that the DejaGnu rules work for a simple program and test case.
 # Also check PR 488: Failure of the first of several tools tested.
+# From the original bug report:
+# ``If you use dejagnu for testing and have multiple tools (i.e.,
+#   multiple entries in the DEJATOOL variable) then the success/failure
+#   of "make check" is only dependent on the success/failure of the
+#   tests on the final tool. Thus there may be failures in the tests on
+#   previous tools, but at first glance "make check" has passed.''
 
 required=runtest
 . ./defs || Exit 1

diff --git a/tests/installdir.test b/tests/installdir.test
index ff4ced5ce51f0a2b83d31e6280f670212c4bd01c..faa074d96c42ed7900424327ac51da2b2dd496a4 100755 (executable)
--- a/tests/installdir.test
+++ b/tests/installdir.test
@@ -15,6 +15,10 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 # Test for PR 203.
+# == Report ==
+# Some standard targets are missing `-local' hooks.  For instance,
+# installdirs is missing this.  Ideally this would be an automatic
+# feature of any exported target.
 
 . ./defs || Exit 1