Note that "update.pl" needs to be finished and tested.
[ZOOM-Perl-moved-to-github.git] / Changes
1 $Id: Changes,v 1.25 2006-04-07 13:08:43 mike Exp $
2
3 Revision history for Perl extension Net::Z3950::ZOOM.
4
5 1.05  [IN PROGRESS]
6         - Implementation of asynchronous events!  The Net::Z3950::ZOOM
7           interface provides this through the event, last_event() and
8           event_str() functions.  The ZOOM interface provides it
9           through the ZOOM::event() and ZOOM:event_str() functions,
10           and the ZOOM::Connection class's last_event() function.
11         - New sample programs added illustrating both asynchronous
12           interfaces: samples/net-z3950-zoom/zoomtst3.pl and
13           samples/zoom/zoomtst3.pl respectively.
14         - ### documentation
15         - ### test-case
16         - ### complete and test "update.pl"
17
18 1.04  Mon Apr  3 14:56:11 BST 2006
19         - The ZOOM-Perl layer now provides access to the underlying
20           ZOOM-C's character-translation functionality, through new
21           optional arguments to ZOOM::Record's render() and raw()
22           methods, and a new underlying get() method.
23
24 1.03  Thu Mar  9 12:55:23 GMT 2006
25         - Allow additional key => value pairs as arguments to the
26           ZOOM::Connectoion constructor; these are added as Connection
27           options before the protocol connection is forged.
28
29 1.02  Thu Mar  9 11:36:55 GMT 2006
30         - Add interface to yaz_version().
31         - Emit big warning at startup time if YAZ version is less than
32           2.0.11 (which is what ZOOM-Perl 1.02 requires) unless the
33           file /tmp/ignore-ZOOM-YAZ-version-mismatch exists.
34         - Fix incorrect ZOOM-package URL in documentation.
35         - Fix typo ("createdb" package) in documentation.
36         - The ZOOM::Connection constructor may now be called with only
37           a single argument (host-string) and does not require a
38           dummy port-number argument.
39
40 1.01  Thu Dec 22 14:13:34 GMT 2005
41         - Place some CODE: chunks in "ZOOM.xs" inside curly brackets
42           so that the declarations they begin with are at the start of
43           the block.  This avoid mixed code/declarations.  (The
44           "correct" solution is to use INIT: clauses in the XS file,
45           but they don't seem to work: the code in them is slapped
46           down right next to the CODE:, so declarations are not
47           acceptable there either.)
48         - Add new function Net::Z3950::ZOOM::connection_scan1(), which
49           uses a query object to indicate the start-term.  This opens
50           the way for using CQL queries for scanning once the
51           underlying ZOOM-C code supports this.
52         - NOTE BACKWARDS-INCOMPATIBLE CHANGE: The ZOOM::Connection
53           method scan() is renamed scan_pqf(), and a new scan() method
54           is introduced which calls the underlying scan1() function.
55           Thus the scan()/scan_pqf() dichotomy is consistent with that
56           between search()/search_pqf().
57         - The tests t/15-scan.t and t/25-scan.t now also test for
58           scanning by CQL query.  To support these tests, a new files
59           is added to the distribution, "samples/cql/pqf.properties"
60         - Remove nonsensical clause about CQL sort-specifications from
61           the documentation.
62         - Add new function Net::Z3950::ZOOM::query_cql2rpn(), for
63           client-side CQL compilation.
64         - Add new ZOOM::Query::CQL2RPN class, encapsulating CQL
65           compiler functionality as a Query subclass.
66         - Add two new error-codes, CQL_PARSE and CQL_TRANSFORM,
67           returned by the client-side CQL facilities.
68         - The test-scripts t/12-query.t and t/22-query.t are extended
69           to also test client-side CQL compilation.
70         - Add all the yaz_log*() functions within the Net::Z3950::ZOOM
71           namespace. 
72         - Add new ZOOM::Log class for logging, providing aliases for
73           the functions in the Net::Z3950::ZOOM layer.
74         - Add diagnostic set to rendering of Exception objects.
75         - Documentation added for CQL compilation and logging.
76
77 1.00  Wed Dec 14 11:18:33 GMT 2005
78         - First distributed version.
79
80 0.01  Fri Oct  7 16:14:20 2005
81         - original version; created by h2xs 1.23 with options
82                 --name=Net::Z3950::ZOOM --compat-version=5.8.0 \
83                 --omit-constant --skip-exporter --skip-ppport \
84                 --autogen-xsubs yaz/zoom.h -lyaz -lxml2
85
86 --
87
88 To be done in future releases:
89         - Fix Net::Z3950::ZOOM::record_get() to use a struct datachunk
90           _when_ appropriate, e.g. for "render" but probably not for
91           "database" and "syntax".
92         - Support for asynchronous multiplexing: implement
93           ZOOM::event() and test ZOOM::Connection::last_event().
94         - Write example programs for "samples" direction.
95         - Create old-style Net::Z3950 compatibility layer.
96         - Fix memory leaks in callback functions for option sets.
97         - Fix limitation that option-set callback functions must be
98           specified as strings containing package-qualified function
99           names.
100         - Fix test-suite to actually send the "drop" packages once
101           Zebra's been fixed so this doesn't current the store.
102