X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=util%2Frandom%2FREADME;fp=util%2Frandom%2FREADME;h=586796b25aa332f8acc7f29cfe55787377fe33b9;hb=03ef3621fa8624d56eef1f85274de365ddafed90;hp=0000000000000000000000000000000000000000;hpb=d48bccaed9308a737cdfa55ba555891d0ad85b87;p=cql-java-moved-to-github.git

diff --git a/util/random/README b/util/random/README
new file mode 100644
index 0000000..586796b
--- /dev/null
+++ b/util/random/README
@@ -0,0 +1,14 @@
+
+In this directory, we test the integrity of the CQL-Java tools as
+follows:
+
+* Generate a random tree with CQLGenerate
+* Take a copy
+* Canonicalise it with CQLparser -c.
+* Compare the before-and-after versions.
+
+Since the CQLGenerate output is in canonical form anyway, the
+before-and-after versions should be identical.  This process exercises
+the comprehensiveness and bullet-proofing of the parser, as well as
+the accuracy of the rendering.
+