Add -q option to scan using a CQL query instead of PQF.
[ZOOM-Perl-moved-to-github.git] / Changes
diff --git a/Changes b/Changes
index 1a440bb..50e55fd 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,8 +1,87 @@
-$Id: Changes,v 1.43 2006-10-10 16:52:30 mike Exp $
+$Id: Changes,v 1.64 2007-08-15 18:37:01 mike Exp $
 
 Revision history for Perl extension Net::Z3950::ZOOM.
 
-1.12  (IN PROGRESS)
+1.20  (IN PROGRESS)
+       - Add new sample program, samples/zoom/zoomscan.pl
+
+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().
@@ -12,10 +91,6 @@ Revision history for Perl extension Net::Z3950::ZOOM.
          difficult to subclass -- when called as
          $class->SUPER::new(@_), the constructor blessed the new
          object into ZOOM::Connection rather than info the subclass.
-       - 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.
 
 1.11  Thu Aug 31 16:47:53 BST 2006
        - Require YAZ version 2.1.17, which has important ZOOM-C