test/regression/README

   1 $Id: README,v 1.1 2002-11-03 16:53:04 mike Exp $
   2
   3 "queries.raw" is the file of test queries as provided by Rob.
   4 "mktests" parses the raw file into sections and individual queries
   5 "sections" is the top-level directory created by that program.
   6   "01", "02" etc. represent the sections within the raw file
   7     "01/name", "02/name", etc. contain the names of the sections.
   8     "01/01.cql", "01/02.cql" etc. are the CQL queries themselves.
   9 "mkanswers" uses a trusted CQL compiler to generate corresponding XCQL.
  10     "01/01.xcql", "01/02.xcql" etc. are the compiled XCQL queries.
  11 "runtests" compares the output of a CQL compiler with existing XCQL files.
  12
  13 "Makefile" controls the building of all this.  You'll need to edit it
  14 if you want to use different compilers and suchlike from what's
  15 written into it, so it may be easier to run the tests by hand -- but
  16 it's a useful reference for the kinds of commands you might need,
  17 anyway.
  18
  19 So, for example, if you think Rob Sanderson's parser, CQLParser.py, is
  20 reliable, and you want to test my parser, cql-java's CQLParser class,
  21 against its results, do this:
  22
  23         rm -rf sections
  24         ./mktests queries.raw
  25         ./mkanswers CQLParser.py
  26         ./runtests CQLParser sgmlnorm
  27
  28 (Except that sgmlnorm is useless -- gotta find something better.)
  29
  30 Also: there's a nasty hack here called "showtest" which, when run like
  31 ``./showtest 07/03'', will show you the ways in which my output
  32 differs from Adam's.  I'll probably delete it soon.