Add ZOOM_connection_diagset()

Rolling.

Many huge changes.

Add render() method to ZOOM::Exception.
Overload '""' to use render()
ZOOM::Connection::new() is now OK with no second argument passed.
Three new comments about places where we should throw exceptions.

Rolling.

Remove extraneous print.

Add lib/ZOOM.pod

We now attempt to create a new DB (but this fails because I don't know
the right parameters to set.  We await Adam's sample ZOOM-C XS
client.)

ROlling.

Tested ZOOM_scanset_option_get() and ZOOM_scanset_option_set()
This means all functions have been tested except
ZOOM_event()
ZOOM_connection_last_event()
which are to do with asynchronous functioning.  Since I don't properly
understand yet how this works in ZOOM-C, trying to test the Perl
interface would be premature :-)

Many additional tests, for field-specific scanning, non-default
scanset size, follow-up scans with seed-term position=0, and option
setting/getting.

Support for ScanSet options.

Fix typo in diagnostic.

Nicer option-setting syntax.

Many additional tests, for field-specific scanning, non-default
scanset size, follow-up scans with seed-term position=0, and option
setting/getting.

First version -- embryonic.

Adjust count of tests.

ZOOM::ResultSet::sort() now uses Net::Z3950::ZOOM::resultset_sort1()
rather then ...::sort(), and returns its status.

Two new tests: resultset_sort1() rejects a syntactically invalid sort
specification, and accepts a good one.

Add ZOOM_resultset_sort1()

Add t/16-packages.t and t/26-packages.t

Tested package functions, so far as possible.

New

As far as I can tell, I have added Extended Services support, in the
form of the ZOOM::Connection::package() method and the ZOOM::Package
class (and, OK, the ZOOM::Error::PACKAGE error-code if you want to be
pedantic).  But it's hard to know whether that's meaningfully true as
I don't yet know how to _use_ these functions.

Nicer option-setting syntax.

New -- initial version exercises all the functions, but doesn't
actually _do_ anything yet.  I need more information.

Move package-related function (not yet implemented) below
option-related function (tested).

Support for scanning: Connnection::scan() and the ScanSet class.

Add t/25-scan.t

New

Add no-op final test mirroring scanset re-destruction in OO API.

Remove extraneous "use MARC::Record".

Include t/15-scan.t

Tested scan-related functions other than option_get/set:
connection_scan(), scanset_term(), scanset_display_term(),
scanset_size() and scanset_destroy()

New.

Remove outdated comment about sorting not working.

Testing for record cloning and deletion.

Support for record cloning and deletion.
(This includes a new private error-code.)
Corrections to commenting on PRIVATE methods.

Tested record_clone() and record_destroy()

Include t/14-sorting.t and t/24-sorting.t.

New

Add ZOOM::ResultSet::sort()

Tested ZOOM_resultset_sort()

Test for success of sortby() call.

Typo.

Removed unusued my($errcode, $errmsg, $addinfo);

New -- doesn't yet pass, but I think that's Adam's fault :-)

Reorder XSUBs -- no other changes.

Add t/23-resultset.t

New -- tests OO interface to advanced result-set functionality.

Add new methods to the ZOOM::ResultSet class:
option(), record_immediate(), cache_reset(), records()
Add check for undefined return from Net::Z3950::ZOOM::resultset_record()

Rename `return_values' parameters to `return_records'.
No substantive changes.

Extra test: not-previously-fetched record works with _immediate after
having been included in a records() request.

Reinstate resultset_records() tests that were commented out before
that function worked properly.

Fixed resultset_records()

Include t/13-resultset.t

Additional tests for resultset_records().

Much work on ZOOM_resultset_records().  It now has a different,
Perl-friendly, signature, and works correctly in the case where it is
not asked to actually return the records that it fetches.  However,
when asked to do so, while it does return an array of the correct
number of entries, these are all undefined values.  D'oh!

Many more tests -- still not complete as resultset_records() doesn't work.

Tested resultset_record_immediate() and resultset_cache_reset().
Steps towards a working ZOOM_resultset_records()

Modified in accordance with Per's suggestions.

New (but not really complete)

Tested ZOOM_resultset_option_get() and ZOOM_resultset_option_set()

Include t/22-query.t in distribution.

New/

Added new, OO-specific, error-codes to the ZOOM::Error class
CREATE_QUERY, QUERY_CQL, QUERY_PQF, SORTBY
Added support for these to ZOOM::diag_str()
Moved that function after the enumerations.
Added utility function _oops() for throwing exceptions.
Fix typo in Connection::destroy() error message.
Added Connection::search(), with Query object as its argument.
Added Query class, with Query::CQL and Query::PQF subclasses.

Check size of result-set arising from search on created query, check
returned record, destroy all objects.

Stricter checking of retrieved record.

Tweaks.

Add t/12-query.t

Do not include the "archive" directory in distributions.

New -- autogenerated by "make dist" in recent Perl versions, including
v5.8.4 onwards, but not be older versions, including v5.8.0.  So it
needs to be included in the distribution and in CVS for the benefit of
the older versions.

Do not omit META.yml

New -- not to be included in distributions

Tested connection_search(), query_create(), query_destroy(),
query_cql(), query_prefix() and query_sortby().

Test-script for query object (not yet complete).

Include "t/21-option-callback.t"

New.

Horrible, horrible support for set_callback().  I can hear them coming
to get me.  The rats ... the rats are in the walls!  IN THE WALLS!

(Also, the first few lines of ZOOM::Query support.)

More belt-and-braces copying of values passed into
ZOOM_options_set_callback().  This is ugly and leaky, but
works, more or less.  I feel bad about it.  I need a hug.

Comments fixed.  No functional changes.

Include "t/20-options.t"

New.

Many changes to the ZOOM::Options class:
- constructor now accepts one or two optional parents.
- _opts() now dies if the object's been destroy()ed.
- Added option(), option_binary(), bool(), int(), set_int(), destroy().

Include "t/10-options.t" and "t/11-option-callback.t"

New

ZOOM_connection_option_getl() now correctly sets its $len parameter.
Support for ZOOM_options_set_callback() -- *complicated*
Support for ZOOM_options_getl() and ZOOM_options_setl().
### Some memory-management issues remain.
Comment that ZOOM_record_get() should _sometimes_(!) use datachunk.
Testing complete for all other option-block functions:
ZOOM_options_create_with_parent()
ZOOM_options_create_with_parent2()
ZOOM_options_get()
ZOOM_options_set()
ZOOM_options_destroy()
ZOOM_options_get_bool()
ZOOM_options_get_int()
ZOOM_options_set_int()

use warnings;
Remove extraneous comments.

use warnings;
Comment now correctly names program.
Remove extraneous comments.

getl() test emits recovered length in commentary.

Three new tests of connectionless create and explicit connect.
Two new tests of option setting/getting in text and binary mode.
Four new tests of consistency of error functions.

Two new tests of option setting/getting in text and binary mode.
Four new tests of consistency of error functions.

Support for T_OPAQUECHAR (input only)
Support for T_DATACHUNK (output only)

Note that ZOOM::Exception should support diagnostic set.
Add new class ZOOM::Options (with minimal support).
Add error_x(), errcode(), errmsg(), addinfo() methods to ZOOM::Connection.
Add connectionless create() and explcit connect() to ZOOM::Connection.
Add option_binary() to ZOOM::Connection -- should it be default?

Fix error in comment.

Revert "const char*" arguments to their original const-qualified
types, now that I have modified the typemap to support this.
Add "opaquechar" and "struct datachunk" types, used to get binary data
strings in and out of C respectively.
These are used by ZOOM_connection_option_setl() and
ZOOM_connection_option_getl() respectively.
Implemented ZOOM_connection_error_x().
Tested ZOOM_connection_{errcode,errmsg,addinfo)().
Tested ZOOM_options_create().
Add explicit "UNTESTED" markers to not-yet-tested functions.

Clearer commentary.

Formatting.

Remove extraneous output.

Correct number of tests.