X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=README;h=eea8b25f10c55ee10c61b40e735060dff12b5d64;hb=4e874df732f94bfee7f0e737b74143b191cde33f;hp=9f940c2f240a28fa458bcab93935cc2e54602062;hpb=aaafb116f81536ca6f842885f4a64fbc3c345b99;p=cql-java-moved-to-github.git diff --git a/README b/README index 9f940c2..eea8b25 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -$Id: README,v 1.22 2002-12-09 16:29:44 mike Exp $ +$Id: README,v 1.24 2007-06-07 16:04:50 mike Exp $ CQL-Java - a free CQL compiler, and other CQL tools, for Java @@ -16,33 +16,38 @@ CQL-Java is a Free Software project that provides: * XCQL (the standard XML representation) * CQL (i.e. decompiling the parse-tree) * PQF (Yaz-style Prefix Query Format) + * BER code for the Z39.50 Type-1 query * A random query generator, useful for testing. -CQL is "Common Query Language", a new query language designed under +CQL is "Common Query Language", a query language designed under the umbrella of the ZING initiative (Z39.59-International Next Generation). The official specification is at - http://www.loc.gov/z3950/agency/zing/cql/cql-syntax.html + http://www.loc.gov/standards/sru/cql/ and there's more (and friendlier) information at http://zing.z3950.org/cql/index.html XCQL is "XML CQL", a representation of CQL-equivalent queries in XML which is supposed to be easier to parse. The specification is at - http://www.loc.gov/z3950/agency/zing/cql/xcql.html -and includes an XML Schema. + http://www.loc.gov/standards/sru/xml-files/xcql.xsd +in the form of an XML Schema. But if you didn't know that, why are you even reading this? :-) -What's what in this distribution? +WHAT'S WHAT IN THIS DISTRIBUTION? +--------------------------------- - README This file - VERSION The version-number of this distribution - 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" - test Various testing and sanity-checking frameworks - etc Other files: CQL Grammar, generator properties, etc. + README This file + VERSION The version-number of this distribution + Changes History of releases + LGPL-2.1 The GNU lesser GPL (see below) + Makefile, Build Files to control compilation. + 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" + test Various testing and sanity-checking frameworks + etc Other files: PQF indexes, generator properties, etc. "Installation" of this package would consist of putting the bin directory on your PATH and lib/cql-java.jar on your CLASSPATH. @@ -55,7 +60,7 @@ Using the test-harnesses: $ CQLParser 'title=foo and author=(bar or baz)' $ CQLParser -c 'title=foo and author=(bar or baz)' - $ CQLParser -p /etc/pqf.properties 'title=foo and author=(bar or baz)' + $ CQLParser -p /etc/pqf.properties 'dc.title=foo and dc.author=bar' $ CQLLexer 'title=foo and author=(bar or baz)' (not very interesting unless you're debugging) $ CQLGenerator etc/generate.properties seed 18 @@ -91,8 +96,9 @@ subdirectory. AUTHOR ------ -All code and documentation by Mike Taylor - http://www.miketaylor.org.uk +Code and documentation by Mike Taylor, Index Data + http://indexdata.com + http://zing.z3950.org/cql Please email me with bug-reports, wishlist items, patches, deployment stories and, of course, large cash donations. @@ -110,8 +116,9 @@ 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 -(i.e. you must share your enhancements), but does let you deploy -CQL-Java as a part of a non-free larger work. +(i.e. you must share your enhancements), but does let you do pretty +much anything else with it. In particular, you may deploy CQL-Java as +a part of a non-free larger work. SEE ALSO