X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=Changes;h=a0f17c089f5455f3330bd1d9fe4c6aa8df59b9b7;hb=7ee6b161c1223a732703ac9bb819abca9ecbf8bf;hp=884403f8392d4552bf103c36653e72837ec13da1;hpb=fc82b225d39cc66cb85c2557db0c0d4a4c5a6e27;p=cql-java-moved-to-github.git diff --git a/Changes b/Changes index 884403f..a0f17c0 100644 --- a/Changes +++ b/Changes @@ -1,8 +1,64 @@ -$Id: Changes,v 1.2 2002-11-06 20:13:45 mike Exp $ +$Id: Changes,v 1.20 2002-11-21 10:11:08 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.2 (IN PROGRESS) +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'' + applies the dc=x binding to both the ``a'' and ``b'' + sub-queries. + - Change the XCQL output to include the nasty (but official) + and wrapper elements. + - Change the XCQL output to use the nasty (but official) + rendition of prefix-mapping: a element, + containing one of more es may appear at the top + of either a or a . + - Include test/regression/xmlpp.pl in the distribution: this + may now be used for testing whether a CQL compiler produces + _equivalent_ XCQL to the 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. 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.) + - 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 + moved in the great ZING-release shake-up. + +0.3 Fri Nov 15 12:04:04 2002 + - Allow keywords to be used unquoted as search terms. + - Add support for serverChoiceRelation (scr). + - Add support for prefix-mapping, as in + >dc="http://www.loc.gov/zing/cql/dc-indexes/" dc.title=fish + and + >"http://www.loc.gov/zing/cql/dc-indexes/" dc.title=fish + The XCQL generated corresponds to Adam's suggested format + rather than Rob's, not so much because I prefer it (although + I do) as because it's what fell out when I just Coded What + Comes Natur'ly. That may need to change, depending on the + result of the ZNG list's deliberations. + - Fix the parser to normalise relation modifiers to lower case. + - Fix the CQLParser test harness not to emit an extraneous + blank line at end of XCQL output. + - Fix CQLNode documentation to contain a link to YAZ's + documentation of Prefix Query Format (PQF) rather than + containing a rather unhelpful chunk of BNF. + - Change the test/regression Makefile so that "make clean" now + does what "make distclean" used to do - the distinction + between them is pointless. + - Fix a few typos in the documentation. + - Move the README file's old "THINGS TO DO" section to the end + of this file, the new "Still to do" section. + +0.2 Wed Nov 6 23:05:54 2002 - Fix the order of proximity parameters in accordance with the updated official grammar, which now specifies proximity operators of the form @@ -13,11 +69,11 @@ Revision history for "cql-java" through parse-trees and so implement its own back-end (e.g. to build BER-friendly data structures using whatever Z39.50 toolkit is preferred.) - - Add the toPQF(Properties p) method to CQLNode and + - Add the toPQF(Properties p) method to CQLNode and its subclasses. This produces a query in YAZ-style Prefix Query Format, which can be trivially translated into a Z39.50 Type-1 query (see, for example, JZKit's code to do so). - - Add etc/pqf.properties to configure to toPQF() method. + - Add etc/pqf.properties to configure the toPQF() method. - Add "-p " option to the CQLParser test-harness, indicating that the parsed tree is to be rendered to PQF. - Add PQFTranslationException and its subclasses @@ -30,3 +86,32 @@ Revision history for "cql-java" 0.1 Sun Nov 3 20:58:27 2002 - First public release. +-- + +### Still to do + - Fix the bug where "9x" is parsed as two tokens, a TT_NUMBER + followed by a TT_WORD. The problem here is that I don't + think it's actually possible to fix this without throwing + out StreamTokenizer and rolling our own, which we absolutely + _don't_ want to do. + - Add srw.resultSet support to the toPFQ() method. + - Write "overview" 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. + - Consider the utility of yet another back-end that translates + a CQLNode tree into JZKit's representation of a Type-1 query + tree. That would be nice so that CQL could become a JZKit + query-type; but you could achieve the same effect by + generating PQF, and running that through JZKit's existing + PQN-to-Type-1 compiler. + - Many refinements to the random query generator: + * Generate relation modifiers + * Proximity support + * Don't always generate qualifier/relation for terms + * Better selection of qualifier (configurable?) + * Better selection of terms (from a dictionary file?) + * Introduce wildcard characters into generated terms + * Generate multi-word terms + * Generate prefix-mappings +