New

[cql-java-moved-to-github.git] / test / regression / README

diff --git a/test/regression/README b/test/regression/README
index e416798..7787126 100644 (file)
--- a/test/regression/README
+++ b/test/regression/README
@@ -1,6 +1,12 @@
-$Id: README,v 1.5 2002-11-21 09:57:28 mike Exp $
+$Id: README,v 1.7 2007-06-07 16:17:04 mike Exp $
 
-cql-java's regression-testing framework
+If you just don't want to think about it
+----------------------------------------
+
+Just use "make" to run regression tests.
+
+
+CQL-Java's regression-testing framework
 ---------------------------------------
 
 "queries.raw" is the file of test queries as provided by Rob.
@@ -21,9 +27,11 @@ contain the trusted compiler output of your choice.
 
 "runtests" compares the output of a nominated CQL compiler with
 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
+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
@@ -34,7 +42,7 @@ whatever CQL and/or XCQL files it needs; if you do "make refclean"
 first, then the next "make" will rebuild the reference results.
 
 So, for example, if you think Rob Sanderson's parser, CQLParser.py, is
-reliable, and you want to test my parser, cql-java's CQLParser class,
+reliable, and you want to test my parser, CQL-Java's CQLParser class,
 against its results, do this:
 
        make refclean
@@ -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
 
+"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
 ----------------------------------