Omit debian directory from distribution.
[ZOOM-Perl-moved-to-github.git] / Changes
diff --git a/Changes b/Changes
index 55139de..9161ddc 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,7 +1,101 @@
-$Id: Changes,v 1.37 2006-06-15 15:43:13 mike Exp $
+$Id: Changes,v 1.61 2007-05-09 12:03:52 mike Exp $
 
 Revision history for Perl extension Net::Z3950::ZOOM.
 
+1.19  (IN PROGRESS)
+       - 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