Towards 1.01.
[ZOOM-Perl-moved-to-github.git] / Changes
1 $Id: Changes,v 1.12 2005-12-21 17:06:55 mike Exp $
2
3 Revision history for Perl extension Net::Z3950::ZOOM.
4
5 1.01  (IN PROGRESS)
6         - Place some CODE: chunks in "ZOOM.xs" inside curly brackets
7           so that the declarations they begin with are at the start of
8           the block.  This avoid mixed code/declarations.  (The
9           "correct" solution is to use INIT: clauses in the XS file,
10           but they don't seem to work: the code in them is slapped
11           down right next to the CODE:, so declarations are not
12           acceptable there either.)
13         - Add new function Net::Z3950::ZOOM::connection_scan1(), which
14           uses a query object to indicate the start-term.  This opens
15           the way for using CQL queries for scanning once the
16           underlying ZOOM-C code supports this.
17         - NOTE BACKWARDS-INCOMPATIBLE CHANGE: The ZOOM::Connection
18           method scan() is renamed scan_pqf(), and a new scan() method
19           is introduced which calls the underlying scan1() function.
20           Thus the scan()/scan_pqf() dichotomy is consistent with that
21           between search()/search_pqf().
22         - The tests t/15-scan.t and t/25-scan.t now also test for
23           scanning by CQL query.  To support these tests, a new files
24           is added to the distribution, "samples/cql/pqf.properties"
25         - Remove nonsensical clause about CQL sort-specifications from
26           the documentation.
27         - Add new function Net::Z3950::ZOOM::query_cql2rpn(), for
28           client-side CQL compilation.
29         - Add new ZOOM::Query::CQL2RPN class, encapsulating CQL
30           compiler functionality as a Query subclass.
31         - Add two new error-codes, CQL_PARSE and CQL_TRANSFORM,
32           returned by the client-side CQL facilities.
33         - The test t/22-query.t is extended to also test client-side
34           CQL compilation.  ### t/12-query.t needs to be similarly
35           modified.
36         - Add all the yaz_log*() functions within the Net::Z3950::ZOOM
37           namespace. 
38         - Add new ZOOM::Log class for logging, providing aliases for
39           the functions in the Net::Z3950::ZOOM layer.
40         - Add diagnostic set to rendering of Exception objects.
41         - ### Documentation updates required for CQL compilation,
42           logging and exception rendering.
43
44 1.00  Wed Dec 14 11:18:33 GMT 2005
45         - First distributed version.
46
47 0.01  Fri Oct  7 16:14:20 2005
48         - original version; created by h2xs 1.23 with options
49                 --name=Net::Z3950::ZOOM --compat-version=5.8.0 \
50                 --omit-constant --skip-exporter --skip-ppport \
51                 --autogen-xsubs yaz/zoom.h -lyaz -lxml2
52
53 --
54
55 To be done in future releases:
56         - Fix Net::Z3950::ZOOM::record_get() to use a struct datachunk
57           _when_ appropriate, e.g. for "render" but probably not for
58           "database" and "syntax".
59         - Support for asynchronous multiplexing: implement
60           ZOOM::event() and test ZOOM::Connection::last_event().
61         - Write example programs for "samples" direction.
62         - Create old-style Net::Z3950 compatibility layer.
63         - Fix memory leaks in callback functions for option sets.
64         - Fix limitation that option-set callback functions must be
65           specified as strings containing package-qualified function
66           names.
67         - Fix test-suite to actually send the "drop" packages once
68           Zebra's been fixed so this doesn't current the store.
69