New "no thinking" introduction.

Note on shared code in runtests/mkanswers.
Describe showtest.

diff --git a/test/regression/README b/test/regression/README
index a773182..7787126 100644 (file)
--- a/test/regression/README
+++ b/test/regression/README
@@ -1,4 +1,10 @@
-$Id: README,v 1.6 2002-12-09 16:29:44 mike Exp $
+$Id: README,v 1.7 2007-06-07 16:17:04 mike Exp $
+
+If you just don't want to think about it
+----------------------------------------
+
+Just use "make" to run regression tests.
+

 
 CQL-Java's regression-testing framework
 ---------------------------------------
 
 CQL-Java's regression-testing framework
 ---------------------------------------

@@ -23,7 +29,9 @@ contain the trusted compiler output of your choice.
 existing XCQL files.  Most often, you'll use this to compare the
 results of your own build of CQL-Java with those of my build.  I'll
 use it to test new versions, and people who've written other compilers
 existing XCQL files.  Most often, you'll use this to compare the
 results of your own build of CQL-Java with those of my build.  I'll
 use it to test new versions, and people who've written other compilers

-can use it to test their code.
+can use it to test their code.  (The code of "runtests" and
+"mkanswers" is worryingly similar: they should probably be the same
+program invoked with different command-line arguments.)

 
 "Makefile" controls the building of all this.  You'll need to edit it
 if you want to use different compilers and suchlike from what's
 
 "Makefile" controls the building of all this.  You'll need to edit it
 if you want to use different compilers and suchlike from what's

@@ -50,6 +58,10 @@ use "cat" as the second argument.)  xmlpp.pl is a fine XML
 pretty-printer from DecisionSoft, found at
        http://software.decisionsoft.com/tools.html
 
 pretty-printer from DecisionSoft, found at
        http://software.decisionsoft.com/tools.html
 

+"showtest" can be used to run a single test showing more details of
+what goes wrong, if anything.  You don't need it as part of the
+regression test, but it's useful when debugging.
+

 
 Appendix: queries that should fail
 ----------------------------------
 
 Appendix: queries that should fail
 ----------------------------------