Obsoleted by new material in IDSoftwareRelease2010
[ZOOM-Perl-moved-to-github.git] / Changes
diff --git a/Changes b/Changes
index e1585b9..5d686e6 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,7 +1,205 @@
-$Id: Changes,v 1.33 2006-05-11 21:41:25 mike Exp $
-
 Revision history for Perl extension Net::Z3950::ZOOM.
 
+1.27  Wed Aug 11 17:13:07 BST 2010
+       - Support for Index Data build procedures, including making
+         Debian/Ubuntu and Red Hat packages from clean tarballs.
+       - No upstream changes -- packaging only.
+
+1.26  Tue Jun  8 16:43:29 BST 2010
+       - Tweak the test-suite so that it works correctly on Fedora
+         Core 12 (2.6.31.5-127.fc12.x86_64).  For some reason,
+         attempts to connect to a non-existent host can fail with
+         ERROR_TIMEOUT and no addinfo, rather than ERROR_CONNECT and
+         the hostname as addinfo; and the number of terms to request
+         in a scan needs to be explicitly specified in an option.
+       - Add "debclean" target to generated Makefile.
+       - Remove extraneous and misleading old CVS IDs.
+
+1.25  Fri Feb 19 15:04:26 GMT 2010
+       - Fix test-suite not to run the "packages" tests against
+         test.indexdata.com, which has gone away, but against
+         z3950.indexdata.com, like the other tests.  A new server
+         runs on a different port for these tests.
+       - Rename zdump.pl to zoomdump, and add it to the set of
+         programs installed.
+       - Switch to git for version control.  Not that it should make
+         any difference to the Perl distribution.
+       - Add semicolons to the commented-out sample configuration
+         lines for Windows in Makefile.PL
+
+1.24  Tue Jun 17 11:31:08 BST 2008
+       - When Net::Z3950::ZOOM::record_get() fetches an XML record
+         because the requested OPAC record is empty,  it now wraps it
+         in an OPAC wrapper, making the difference invisible to
+         application code.
+
+1.23  Mon Jun  9 14:53:15 BST 2008
+       - Net::Z3950::ZOOM::record_get() now patches around the
+         problem of naughty servers that refuse to return anything
+         for an OPAC record when there is no non-bibliographic part,
+         by falling back on requesting an XML record in such cases.
+
+1.22  Tue May 27 14:00:12 BST 2008
+       - Fix Net::Z3950::ZOOM::record_get() to use a struct datachunk
+         _when_ appropriate, e.g. for "render" not for "database" and
+         "syntax".
+       - Remove the unused $len reference parameter from record_get()
+         and $record->get(): this is now used in the underlying C
+         layer to make Perl strings of the right length, and is of no
+         value higher up the stack.
+       - Fix a bug in ZOOM::ResultSet::records(): requests including
+         the last record in the set were incorrectly declined.
+       - Better Debian packaging: use "make debian" to create new
+         "debian/output" directory containing .deb package file,
+         changes file, etc.
+       - Clear up a few warnings in ZOOM.xs
+       - Minor documentation improvements.
+
+1.21  Mon Oct 29 12:07:25 GMT 2007
+       - In the "typemap" file's handling of opaquechar*, use STRLEN
+         type for _unused_len in instead of unsigned: this prevents a
+         (possibly serious) warning on some 64-bit architectures,
+         although applications that do not use the option_binary()
+         methods will be safe with the previous release.
+       - Add explicit "#include <yaz/log.h>" to ZOOM.xs in the hope
+         of preventing undeclared-function warnings that some users
+         have reported but which I have been unable to reproduce.
+
+1.20  Fri Sep 21 17:51:55 BST 2007
+       - Add new sample program, samples/zoom/zoomscan.pl
+       - samples/zoom/zoomtst1.pl now accepts arbitrary options at
+         the end of the command-line, so that (for example) you can
+         specify a non-USMARC record syntax.
+       - Add new functions Net::Z3950::ZOOM::diag_srw_str() and
+         ZOOM::diag_srw_str() to map SRW diagnostic codes into
+         human-readable messages.
+       - ZOOM::Exception() constructor uses diag_srw_str() to fill in
+         the error message, if it is undefined, for SRW errors.
+       - The render() method of ZOOM::Exception(), and therefore the
+         overloaded stringifying operator, deals with exceptions that
+         have no message().
+       - Corrected the scan parts of the test-suite that use CQL so
+         that they explicitly perform client-side CQL compilation and
+         send the resulting Type-1 query.  Previously, these tests
+         were (accidentally) requesting that CQL be sent as-is to the
+         server, but this mistake was being masked by an error in
+         older versions of ZOOM-C that compiled client-side anyway!
+
+1.19  Mon Jul  9 14:09:31 BST 2007
+       - Add $conn->exception() method.
+       - Set version number for Net::Z3950 to 0.99 -- less than the
+         1.0 version number that will be used when it successfully
+         emulates the old Net::Z3950 module, but superseding the last
+         release, 0.51, of that module.
+       - Include samples/zoom/zdump.pl in distribution.
+       - Add "irspy" namespace to samples/zoom/zselect
+
+1.18  Mon Feb 26 14:57:48 GMT 2007
+       - When a connection is in asynchronous mode, failing
+         operations (search, scan, etc.) no longer throw exceptions.
+         This is because the event-loop in asychronous applications
+         needs to check for errors anyway, in case the server has
+         returned high-level diagnostics such as "unsupported use
+         attribute".  So this check within the event-loop is now the
+         only place where error-checking need be done.
+       - Add new public ZOOM::Connection() function, check(), which
+         throws an exception if an error is pending (even if the
+         connection is asynchronous).
+       - New YAZ logging level, "zoom_check", notes when errors are
+         detected and either left unreported (asynchronous
+         connections) or thrown as exception (synchronous).
+
+1.17  Thu Feb 22 20:38:45 GMT 2007
+       - Change Net::Z3950::ZOOM::event() to allocate its array of
+         connection pointers dynamically, so there is no longer an
+         arbitrary limit of 100.
+       - New connection-level option "_check_debug" emits messages on
+         standard error when checking a connection find an error that
+         is about to result in throwing an exception.  There is no
+         reason for you ever to use this, though -- pretend you don't
+         know about it.
+
+1.16  Tue Jan 16 11:18:34 GMT 2007
+       - Require version 2.1.41 or better of YAZ, so that Init
+         Response options are available using
+         $conn->option("init_opt_sort") etc.
+       - Include samples/zoom/zhello.pl to exercise these options.
+       - Add ZOOM_connection_peek_event() and $conn->peek_event().
+       - Require YAZ version 2.1.45, which is the first to provide
+         ZOOM_connection_peek_event().
+
+1.15  Fri Dec  1 14:17:49 GMT 2006
+       - ZOOM::Error::INIT is renamed to ZOOM::Error::ZINIT, since
+         INIT is a reserved word in Perl.  In version 1.14 and
+         earlier, "require ZOOM" would fail, saying "Too late to run
+         INIT block", and "use ZOOM" would result in
+         ZOOM::Error::INIT having a value equal to its name (why?!)
+         rather than, as intended, Net::Z3950::ZOOM::ERROR_INIT.
+       - Belatedly added documentation for $rec->error() and
+         $rec->exception().
+
+1.14  Tue Nov 28 17:33:07 GMT 2006
+       - Add $record->error() to return non-surrogate diagnostics,
+         and $record->exception() to return the same information
+         wrapped in a ZOOM::Exception object.
+       - Requires YAZ 2.1.40, which provides ZOOM_record_error().
+       - $conn->error_x() now returns the error-code when called in
+         scalar context, rather than the diagnostic set name.
+
+1.13  Sat Nov  4 16:47:00 GMT 2006
+       - ZOOM::Connection::create() may now take either a single
+         argument, which is a ZOOM::Options object, or any even
+         number of argument (including zero), which are key => value
+         pairs of options to set.
+       - ZOOM::Connection::new(), having been refactored to use
+         create(), can now also take a ZOOM::Options argument.
+       - Documentation now includes information on specifying SRW,
+         SRU-over-GET and SRU-over-POST connections.
+       - ZOOM::ResultSet::record() throws a diagnostic if asked to
+         retrieve records out of range for the result-set.
+       - All tests against indexdata.com are now explicitly against
+         z3950.indexdata.com, as the identity of the former name has
+         recently changed.
+
+1.12  (NEVER PUBLICLY RELEASED; these changes are included in 1.13)
+       - Include the useful example program samples/zoom/zselect,
+         which is installed as part of "make install".
+       - Add ZOOM_connection_is_idle() and $conn->is_idle().
+       - Require YAZ version 2.1.35, which is the first to provide
+         ZOOM_connection_is_idle().
+       - Fix bug in ZOOM::Connection class code that made the
+         difficult to subclass -- when called as
+         $class->SUPER::new(@_), the constructor blessed the new
+         object into ZOOM::Connection rather than info the subclass.
+
+1.11  Thu Aug 31 16:47:53 BST 2006
+       - Require YAZ version 2.1.17, which has important ZOOM-C
+         bug-fixes.
+       - Do not use "-Wdeclaration-after-statement" compiler option,
+         since this supported only by GCC (and only recent versions).
+
+1.10  Thu Jun 15 16:42:47 BST 2006
+       - No functional changes, but use Adam's modified API to
+         ZOOM_query_ccl2rpn().  This incompatible change means that
+         RELEASE 1.09 WILL NOT BUILD against any recent YAZ.
+
+1.09  Tue Jun 13 17:44:43 2006
+       - Add new function Net::Z3950::ZOOM::query_ccl2rpn(), for
+         client-side CCL compilation.
+       - Add new ZOOM::Query::CCL2RPN class, encapsulating CCL
+         compiler functionality as a Query subclass.  This allows
+         client-side CCL to be used for both search and scan.
+       - Add two new error-codes, CCL_CONFIG and CCL_PARSE,
+         returned by the client-side CCL facilities.
+       - Supply a sample CCL profile file: samples/ccl/default.bib,
+         copied from the same-named file distributed with YAZ.
+       - The test-scripts t/12-query.t and t/22-query.t are extended
+         to also test client-side CCL searching.
+       - The test-scripts t/15-scan.t and t/25-scan.t are extended
+         to also test client-side CCL scanning.
+       - Documentation updated to describe use of CCL.
+       - Add a nice, simple update client: samples/zoom/update.pl
+
 1.08  Thu May 11 22:40:41 BST 2006
        - Requires version 2.1.11 of YAZ, not 2.0.11.  This is a
          bugfix: the old reliance on 2.0.11 was merely a typo.
@@ -113,9 +311,6 @@ Revision history for Perl extension Net::Z3950::ZOOM.
 
 To be done in future releases:
        - Complete, test and document "update.pl"
-       - Fix Net::Z3950::ZOOM::record_get() to use a struct datachunk
-         _when_ appropriate, e.g. for "render" but probably not for
-         "database" and "syntax".
        - Create old-style Net::Z3950 compatibility layer.
        - Fix memory leaks in callback functions for option sets.
        - Fix limitation that option-set callback functions must be