Add (premature) note about Ralph's changes.

[cql-java-moved-to-github.git] / Changes

diff --git a/Changes b/Changes
index 6e19590..b804262 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,9 +1,21 @@
-$Id: Changes,v 1.17 2002-11-20 09:49:28 mike Exp $
+$Id: Changes,v 1.23 2002-12-04 16:55:45 mike Exp $
 
-Revision history for "cql-java"
+Revision history for the "cql-java" package.
 See the bottom of this file for a list of things still to do.
 
-0.4  (IN PROGRESS)
+0.5  (IN PROGRESS)
+       - Add an extra back-end method,
+               byte[] toType1(Properties config)
+         which generates an opaque BER-encoded PDU suitable for
+         forwarding to Z39.50 server as a pasrt of a searchRequest
+         APDU.  This was contributed by Ralph Levan <levan@oclc.org>
+       - Change regression-test rules for Adam's compiler to use his
+         new front-end cql2xcql instead of the old cqlparse3.
+       - Fix comment in etc/pqf.properties (claimed that the Type-1
+         "string" attribute was "phrase").  Just a documentation
+         error.
+
+0.4  Thu Nov 21 10:09:26 2002
        - Add support for the new "phonetic" relation modifier,
          including its mapping in "etc/pqf.properties".
        - Make prefix-maps bind loosely, so that ``>dc=x a and b''
@@ -15,15 +27,19 @@ See the bottom of this file for a list of things still to do.
          rendition of prefix-mapping: a <prefixes> element,
          containing one of more <prefix>es may appear at the top
          of either a <searchClause> or a <triple>.
+       - Include test/regression/xmlpp.pl in the distribution: this
+         may now be used for testing whether a CQL compiler produces
+         _equivalent_ XCQL to what's in the regression test, rather
+         than requiring byte-identical output.
+       - Include the reference XCQL output in the distribution, for
+         the regression test suite to run against.
        - Change build process so that javadoc documentation is built
-         by "make" in the "docs" directory.
+         by "make" in the "docs" directory.  There's now a top-level
+         makefile that builds the source, runs the test suite and
+         creates the documentation.
        - Write javadoc comments for CQLRelation and ModifierSet.
        - Other improvements to javadoc comments (e.g. describe the
          `config' parameter to the toPQF() method.)
-       - Include test/regression/xmlpp.pl in the distribution: this
-         is now used for testing whether a CQL compiler produces
-         _equivalent_ XCQL to the what's in the regression test,
-         rather than requiring byte-identical output.
        - Sort out the licence: I've settled on the LGPL.
        - Remove the redundant and misleading etc/Grammar file.
        - Fix up various Maintenance Agency web addresses that have
@@ -90,11 +106,11 @@ See the bottom of this file for a list of things still to do.
          think it's actually possible to fix this without throwing
          out StreamTokenizer and rolling our own, which we absolutely
          _don't_ want to do.
-       - Find out what the ZNG group finally settled on as the
-         correct XCQL representation of prefix-mapping, and tweak my
-         toXCQL() output to match that.
        - Add srw.resultSet support to the toPFQ() method.
-       - Write "overview" file for the javadoc documentation.
+       - Write some "glue" code to generate a BER-encoded Type-1
+         query packet using ZJKit's PQF-compiler and the facilities
+         for serialising the resulting Type-1 tree representation.
+       - Write "package.html" file for the javadoc documentation.
        - Some niceties for the cql-decompiling back-end:
          * Don't emit redundant parentheses.
          * Don't put spaces around relations that don't need them.