-$Id: Changes,v 1.23 2002-12-04 16:55:45 mike Exp $
+$Id: Changes,v 1.24 2002-12-09 16:29:44 mike Exp $
-Revision history for the "cql-java" package.
+Revision history for the CQL-Java package.
See the bottom of this file for a list of things still to do.
0.5 (IN PROGRESS)
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.
+ - Change the names of the anchoring properties in
+ etc/pqf.properties and the CQLTermNode code that examines
+ them, in accordance with Adam's PQF-renderer's behaviour.
+ This gives more flexibility in terms of generating
+ attributes for end-of-field anchoring.
- Fix comment in etc/pqf.properties (claimed that the Type-1
"string" attribute was "phrase"). Just a documentation
error.
+ - Change the capitalisation of the project name from
+ "cql-java" to "CQL-Java". That doesn't really make any
+ difference to anything: in particular, file-names such as
+ "cql-java.jar" remain the same.
0.4 Thu Nov 21 10:09:26 2002
- Add support for the new "phonetic" relation modifier,
-$Id: README,v 1.21 2002-11-20 09:49:28 mike Exp $
+$Id: README,v 1.22 2002-12-09 16:29:44 mike Exp $
-cql-java - a free CQL compiler, and other CQL tools, for Java
+CQL-Java - a free CQL compiler, and other CQL tools, for Java
INTRODUCTION
------------
-cql-java is a Free Software project that provides:
+CQL-Java is a Free Software project that provides:
* A set of classes for representing a CQL parse tree (a base CQLNode
class, CQLBooleanNode and its subclasses, CQLTermNode, etc.)
README This file
VERSION The version-number of this distribution
- src Source-code for the cql-java library
+ src Source-code for the CQL-Java library
lib The compiled library file, "cql-java.jar"
bin Simple shell-scripts to invoke the test-harnesses
docs Documentation automatically generated by "javadoc"
LICENCE
-------
-The cql-java suite is Free Software, which is pretty much legally
+The CQL-Java suite is Free Software, which is pretty much legally
equivalent -- though not morally equivalent -- to Open Source. See
http://www.gnu.org/philosophy/free-software-for-freedom.html
for a detailed if somewhat one-sided discussion of the differences,
and particularly of why Free Software is an important idea.
-cql-java is distributed under version 2.1 of the LGPL (GNU LESSER
+CQL-Java is distributed under version 2.1 of the LGPL (GNU LESSER
GENERAL PUBLIC LICENSE). A copy of the licence is included in this
distribution, as the file LGPL-2.1. This licence does not allow you
-to restrict the freedom of others to use derived versions of cql-java
+to restrict the freedom of others to use derived versions of CQL-Java
(i.e. you must share your enhancements), but does let you deploy
-cql-java as a part of a non-free larger work.
+CQL-Java as a part of a non-free larger work.
SEE ALSO
-$Id: README,v 1.1 2002-11-03 16:49:38 mike Exp $
+$Id: README,v 1.2 2002-12-09 16:29:44 mike Exp $
The library file "cql-java.jar" will appear here when you do a build
in ../src/org/z3950/zing/cql. Put it on your CLASSPATH to use the
-cql-java utilities.
+CQL-Java utilities.
#!/bin/sh
-# mkdist - make a distribution of the cql-java software
-# $Id: mkdist,v 1.2 2002-11-21 10:11:08 mike Exp $
+# mkdist - make a distribution of the CQL-Java software
+# $Id: mkdist,v 1.3 2002-12-09 16:29:44 mike Exp $
version=`cat VERSION`
distdir=cql-java-$version
-// $Id: CQLNode.java,v 1.18 2002-12-08 00:37:54 mike Exp $
+// $Id: CQLNode.java,v 1.19 2002-12-09 16:29:44 mike Exp $
package org.z3950.zing.cql;
import java.util.Properties;
/**
* Represents a node in a CQL parse-tree.
*
- * @version $Id: CQLNode.java,v 1.18 2002-12-08 00:37:54 mike Exp $
+ * @version $Id: CQLNode.java,v 1.19 2002-12-09 16:29:44 mike Exp $
*/
public abstract class CQLNode {
CQLNode() {} // prevent javadoc from documenting this
* A <TT>Properties</TT> object containing configuration
* information that specifies the mapping from CQL qualifiers,
* relations, etc. to Type-1 attributes. The mapping
- * specification is described in the cql-java distribution's
+ * specification is described in the CQL-Java distribution's
* sample PQF-mapping configuration file,
* <TT>etc/pqf.properties</TT>, which see.
* @return
* A <TT>Properties</TT> object containing configuration
* information that specifies the mapping from CQL qualifiers,
* relations, etc. to Type-1 attributes. The mapping
- * specification is described in the cql-java distribution's
+ * specification is described in the CQL-Java distribution's
* sample PQF-mapping configuration file,
* <TT>etc/pqf.properties</TT>, which see.
* @return
-# $Id: Makefile,v 1.12 2002-11-17 23:29:02 mike Exp $
+# $Id: Makefile,v 1.13 2002-12-09 16:29:44 mike Exp $
#
# Your Java compiler will require that this source directory is on the
-# classpath. The best way to do that is just to add the cql-java
+# classpath. The best way to do that is just to add the CQL-Java
# distribution's "src" subdirectory to your CLASSPATH environment
# variable, like this:
# CLASSPATH=$CLASSPATH:/where/ever/you/unpacked/it/cql-java-VERSION/src
-$Id: README,v 1.1 2002-11-03 16:49:38 mike Exp $
+$Id: README,v 1.2 2002-12-09 16:29:44 mike Exp $
-In this directory, we test the integrity of the cql-java tools as
+In this directory, we test the integrity of the CQL-Java tools as
follows:
* Generate a random tree with CQLGenerate
* 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.
+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.
-$Id: README,v 1.5 2002-11-21 09:57:28 mike Exp $
+$Id: README,v 1.6 2002-12-09 16:29:44 mike Exp $
-cql-java's regression-testing framework
+CQL-Java's regression-testing framework
---------------------------------------
"queries.raw" is the file of test queries as provided by Rob.
"runtests" compares the output of a nominated CQL compiler with
existing XCQL files. Most often, you'll use this to compare the
-results of your own build of cql-java with those of my build. I'll
+results of your own build of CQL-Java with those of my build. I'll
use it to test new versions, and people who've written other compilers
can use it to test their code.
first, then the next "make" will rebuild the reference results.
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,
+reliable, and you want to test my parser, CQL-Java's CQLParser class,
against its results, do this:
make refclean