X-Git-Url: http://lists.indexdata.dk/cgi-bin?a=blobdiff_plain;f=test%2FREADME;h=614a2ca61337548c3004c0e68535446a2409d5d3;hb=08b7f3f08d97b9efdd5a3aef7992a359b71910d6;hp=fff96be7dfb458d30fa2f30b937396ecf6bab5f6;hpb=cae635a47469f62058626e9b8231b231d0861fb0;p=cql-java-moved-to-github.git

diff --git a/test/README b/test/README
index fff96be..614a2ca 100644
--- a/test/README
+++ b/test/README
@@ -1,6 +1,6 @@
-$Id: README,v 1.1 2002-11-01 23:45:28 mike Exp $
+$Id: README,v 1.3 2002-11-03 16:49:38 mike Exp $
 
-"raw" is the file of test queries as provided by Rob.
+"queries.raw" is the file of test queries as provided by Rob.
 "mktests" parses the raw file into sections and individual queries
 "sections" is the top-level directory created by that program.
   "01", "02" etc. represent the sections within the raw file
@@ -8,4 +8,29 @@ $Id: README,v 1.1 2002-11-01 23:45:28 mike Exp $
     "01/01.cql", "01/02.cql" etc. are the CQL queries themselves.
 "mkanswers" uses a trusted CQL compiler to generate corresponding XCQL.
     "01/01.xcql", "01/02.xcql" etc. are the compiled XCQL queries.
-"Makefile" controls the building of all this.
+"runtests" compares the output of a CQL compiler with existing XCQL files.
+
+"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
+written into it, so it may be easier to run the tests by hand -- but
+it's a useful reference for the kinds of commands you might need,
+anyway.
+
+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,
+against its results, do this:
+
+	rm -rf sections
+	./mktests queries.raw
+	./mkanswers CQLParser.py
+	./runtests CQLParser sgmlnorm
+
+(Except that sgmlnorm is useless -- gotta find something better.)
+
+Also: there's a nasty hack here called "showtest" which, when run like
+``./showtest 07/03'', will show you the ways in which my output
+differs from Adam's.  I'll probably delete it soon.
+
+Also: there's a subdirectory "random" which tests in a completely
+different way.  That ought to be a sister directory with this one, and
+will be when I move the rest of this stuff down a level.