Changes

   1 $Id: Changes,v 1.47 2007-09-25 09:02:03 mike Exp $
   2
   3 Revision history for Perl extension Net::Z3950::SimpleServer
   4
   5 1.10  (IN PROGRESS)
   6         - Document the init-handler's PEER_NAME argument.
   7
   8 1.09  Mon Sep 10 15:54:38 BST 2007
   9         - *Argh*  Another mixed statement/declaration.
  10
  11 1.08  Mon Sep 10 12:15:29 BST 2007
  12         - *Sigh*  Fix mixed statement/declaration.
  13
  14 1.07  Sat Sep  1 10:31:26 BST 2007
  15         - When the scan-handler callback returns, do not attempt to
  16           copy the terms from Perl structures if the error-code is
  17           non-zero (i.e. if an error has occurred).  This protects
  18           against a segmentation fault when the Perl callback does not
  19           explicitly set $args->{NUMBER} = 0 on error.
  20         - Correct transcription of string-valued attributes in
  21           $args->{RPN}.
  22         - Scan handler is now passed RPN as well as TERM, a tree of
  23           Perl structures representing the entire scan clause
  24           including access-points and other attributes (which are
  25           discarded from TERM).
  26         - The various classes used to represent nodes in the RPN query
  27           tree (Net::Z3950::APDU::Query, Net::Z3950::RPN::And,
  28           Net::Z3950::RPN::Or, Net::Z3950::RPN::AndNot,
  29           Net::Z3950::RPN::Term and Net::Z3950::RPN::RSID) now all
  30           share a newly introduced superclass Net::Z3950::RPN::Node,
  31           making it possible to write methods that apply to all node
  32           types.
  33         - A utility method toPQF() is provided for
  34           Net::Z3950::RPN::Node, enabling the RPN tree to be converted
  35           back into a flat PQF query.
  36         - Add support for the Delete Result Set service.
  37         - Add documentation for the Sort service.
  38         - Some clarifications to documentation.
  39
  40 1.06  Fri Aug 10 23:30:00 BST 2007
  41         - New global-handle element can be specified when creating a
  42           simple-server object and will be passed to all callback
  43           functions.  This allows global state to be eliminated from
  44           SimpleServer applications ... finally!
  45         - Search handler now deals correctly with undefined addinfo:
  46           previously a (harmless) error message was emitted.
  47         - Add Perl API to yaz_diag_srw_to_bib1(), which SimpleServer
  48           applications will need if they access SRU/SRW back-end
  49           databases and need to report errors.
  50         - Add Perl API to yaz_diag_bib1_to_srw(), because it would
  51           seem churlish not to.
  52
  53 1.05  Wed Dec 27 13:19:13 CET 2006
  54         - Taking new naming convention for YAZ constants into account.
  55
  56 1.04  Fri Dec  1 10:48:32 CET 2006
  57         - Build such that SimpleServer links to new yaz shared object.
  58
  59 1.03  Tue Aug  8 17:27:16 BST 2006
  60         - Rely on version 2.1.14 or later of YAZ; this is the first
  61           version that reliably passes through the additional
  62           information associated with errors generated while serving
  63           SRU/W requests.  No functional differences since 1.02.
  64
  65 1.02  Wed Jul 26 12:09:50 BST 2006
  66         - Better support for Open and User/Password authentication.
  67         - SimpleServer.xs's rpn2pquery() is now discarded, and YAZ's
  68           yaz_rpnquery_to_wrbuf() used instead.  This is more robust
  69           in dealing with unusual cases such as string-valued
  70           attributes.
  71         - Support for SCHEMA element when fetching records.
  72
  73 1.01  Fri Mar 24 12:09:32 GMT 2006
  74         - Documentation of release 1.00's SRU/SRW facilities.
  75         - Makefile.PL now fails if YAZ version is earlier than 2.0.0,
  76           which was the first with SRU/SRW support.
  77
  78 1.00  Fri Mar 24 01:20:24 GMT 2006
  79         - Support for SRU and SRW.  Mostly this is provided by the YAZ
  80           GFS, but changes are needed to allow for the case where
  81           there is no RPN query (due to absent on invalid <cql2rpn>
  82           element in GFS configuration) so that CQL is passed through
  83           natively; and also to fake up an {REQ_FORM} and {REP_FORM}
  84           parameters set to the "text/xml" OID when this information
  85           is not specified by the GFS.
  86           (The jump in version number is due to the SRU/W support.)
  87         - Include "logging-server.pl" in the distribution: the
  88           simplest possible SimpleServer application, which merely
  89           logs the client-request data structures.
  90         - Makefile.PL is more helpful if yaz-config isn't found.
  91         - Explicitly disable prototypes in SimpleServer.xs: makes no
  92           difference but suppresses an error message for a cleaner
  93           build.
  94
  95 0.08  Mon Jun 14 14:51:01 2004
  96         - SimpleServer is now perl 5.8 thread proof
  97         - Support for IMP_ID parameter in Init responses.  This was
  98           actually written a long time ago, but left commented out as
  99           the underlying YAZ back-end server didn't support
 100           implementation-ID setting.  Now that it does (and has done
 101           for eighteen months -- since YAZ release 1.8.6 of
 102           2002/03/25!), I've finally removed the comments.
 103         - Init handler now understands the setting of {ERR_CODE} as
 104           more than a boolean success indicator, and also {ERR_STR}.
 105           They are now passed back to the client (thanks to recent
 106           changes to the YAZ generic front-end server) in accordance
 107           with Z39.50 Implementor Agreement 5, found at
 108                 http://lcweb.loc.gov/z3950/agency/agree/initdiag.html
 109
 110 0.07  Fri Jan 03 10:12:15 2003
 111         - Applied Dave Mitchell's (davem@fdgroup.com) GRS-1 parsing patch.
 112           Thanks Dave, and sorry it didn't find its way to release 0.06,
 113           completely my fault.
 114
 115 0.06  Thu Jan 02 11:15:01 2003
 116         - Added support for authentication
 117         - Add documentation for the object tree passed as the RPN
 118           member of the search-handler's argument hash.
 119         - We actually removed the vacuous Changelog and TODO files
 120           back in 0.05.  They should never have been here :-)
 121
 122 0.05  Tue Feb 05 21:54:30 2002
 123         - Add brief documentation of the new handling
 124           of RPN.
 125
 126 0.04  Tue Feb 05 21:49:56 2002
 127         - Add Changelog (Why?  We already have this file!)
 128         - Add TODO file (although it's empty!)
 129         - Change interface to constructor, and fix test.pl script to
 130           use the new interface.
 131         - Add support for Scan.
 132         - Add support for building GRS-1 records.
 133         - Add grs_test.pl test suite for new GRS-1 code.
 134         - Add RPN structure to search-handler argument hash.
 135         - Add PID element to init, search, fetch and present-handler
 136           argument hashes (but not the sort, scan and close-handlers,
 137           for some reason.)
 138         - Fix typos in documentation.
 139
 140 0.03  Thu Nov 09 16:22:00 2000
 141         - Add the INSTALL file.
 142         - Add support for a present-handler (distinct from fetch).
 143         - Remove `$args->{LEN} = length($record)' from the example
 144           fetch-handler in the documentation.
 145         - Minor corrections to documentation, e.g. add commas after
 146           elements in anonymous hash of arguments.
 147         - Record syntaxes (formats) are now specified as ASCII OIDs
 148           (e.g. "1.2.840.10003.5.10") rather than human-readable
 149           strings (e.g. "usmarc")
 150         - Add some XS code to support sorting, though it doesn't seem
 151           to be finished yet, and is not wired out.
 152         - Use symbolic constants (e.g. Z_ElementSetNames_generic
 153           instead of hard-wired magic number 1).
 154         - Add PEER_NAME element to init-handler argument hash.
 155         - Minor changes to ztest.pl.
 156
 157 0.02  Mon Sep 11 12:32:00 2000
 158         - First released versions
 159
 160 0.01  Wed Aug 30 14:54:01 2000
 161         - original version; created by h2xs 1.19
 162