Obsoleted by new material in IDSoftwareRelease2010
[ZOOM-Perl-moved-to-github.git] / samples / README
index f4e7686..df6d413 100644 (file)
@@ -1,5 +1,3 @@
-$Id: README,v 1.2 2005-12-09 10:35:46 mike Exp $
-
 This area contains sample programs that exercise all three of the APIs
 supported by this module.  The programs for each API are contained in
 separate subdirectories:
@@ -23,11 +21,25 @@ net-z3950 -- Test programs using the obsolescent Net::Z3950 interface,
 In general, each sample program exists in a different version in all
 three directories, under the same name in each.  The programs are:
 
-zoomtst1.pl -- A direct translation of the "zoomtst.c" application
+zoomtst1.pl -- A direct translation of the "zoomtst1.c" application
        from the YAZ distribution, except that these versions go on to
        fetch the records that they find, whereas the C version is
        satisfied just to get the hit count.
 
+zoomtst3.pl -- A direct translation of the "zoomtst3.c" application
+       from the YAZ distribution -- simultaneous search of multiple
+       targets.  Pretty cool :-)
+
+async.pl -- A slightly cleverer version of "zoomtst3.pl" which takes
+       advantage of the new END element introduced in YAZ 2.1.17 to
+       display each server's records as soon as they have been
+       received, rather than waiting until all servers have finished
+       their jobs as in every previous ZOOM-based multiplexer.
+
+update.pl -- Create a new database and add a record to it.
+
 In addition, this "sample" directory contains sample records that are
 used by the test-suite to exercise the update functionality.  These
-are found in the "records" subdirectory.
+are found in the "records" subdirectory.  It also provides a
+CQL-to-PQF mapping file (copied blindly from the one in the YAZ
+distribution), found in the "cql" directory.