X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fzoom.xml;h=9a8a910cd3db92b894c5bc2bfcc3b26662250140;hb=c880dceeaeca4082b215a15eb48fd655cb7b62f7;hp=2075f34cb85556a65323210be9733bde75466b21;hpb=1db93bf6100a499194c8c0e5917d718fe86f0509;p=yaz-moved-to-github.git

diff --git a/doc/zoom.xml b/doc/zoom.xml
index 2075f34..9a8a910 100644
--- a/doc/zoom.xml
+++ b/doc/zoom.xml
@@ -20,7 +20,7 @@ ZOOM_options_set_int(opt, name, value)
 ZOOM_connection_scan1 (ZOOM_connection c, ZOOM_query startterm)
 ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
 -->
-<!-- $Id: zoom.xml,v 1.60 2007-06-21 09:00:53 adam Exp $ -->
+<!-- $Id: zoom.xml,v 1.63 2007-08-31 21:23:45 adam Exp $ -->
  <chapter id="zoom"><title>ZOOM</title>
   <para>
     &zoom; is an acronym for 'Z39.50 Object-Orientation Model' and is
@@ -267,6 +267,14 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
 	discover whether the server claims to support the specified
 	operations.
        </entry><entry>none</entry></row>
+      <row><entry>
+        sru_version</entry><entry>
+	SRU/SRW version. Should be <literal>1.1</literal>, or
+	<literal>1.2</literal>. This is , prior to connect, the version
+	to offer (highest version). And following connect (in fact
+	first operation), holds the negotiated version with the server
+	(same or lower version).
+       </entry><entry>1.1</entry></row>
      </tbody>
     </tgroup>
    </table>
@@ -831,14 +839,16 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
    </para>
 
    <para>
-    The Scan interface is Z39.50 only. SRW version 1.0 does not
-    support this.
+    The Scan interface is supported for both Z39.50 and SRU.
    </para>
 
    <synopsis>
     ZOOM_scanset ZOOM_connection_scan(ZOOM_connection c,
                                       const char *startpqf);
 
+    ZOOM_scanset ZOOM_connection_scan1(ZOOM_connection c,
+                                       ZOOM_query q);
+
     size_t ZOOM_scanset_size(ZOOM_scanset scan);
 
     const char * ZOOM_scanset_term(ZOOM_scanset scan, size_t pos,
@@ -894,6 +904,12 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
      @attr 1=4 @attr 6=2 "science o"
     </literallayout>
    </para>
+
+   <para>
+    The <function>ZOOM_connecton_scan1</function> is a newer and
+    more generic alternative to <function>ZOOM_connection_scan</function>
+    which allows to use both CQL and PQF for Scan.
+   </para>
    
    <table frame="top" id="zoom.scanset.options">
     <title>ZOOM Scan Set Options</title>
@@ -1145,7 +1161,7 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
 	 <literal>recordDelete</literal>,
 	 <literal>elementUpdate</literal>.
 	</entry>
-	<entry><literal>specialUpdate</literal></entry>
+	<entry><literal>specialUpdate (recordInsert for updateVersion=1 which does not support specialUpdate)</literal></entry>
        </row>
        <row>
 	<entry>recordIdOpaque</entry>
@@ -1189,6 +1205,20 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
 	<entry>Element Set for Record</entry>
 	<entry>none</entry>
        </row>
+       <row>
+	<entry>updateVersion</entry>
+	<entry>Record Update version which holds one of the values
+	 1, 2 or 3. Each version has a distinct OID:
+	 1.2.840.10003.9.5
+	 (<ulink url="&url.z39.50.extupdate1;">first version</ulink>) ,
+	 1.2.840.10003.9.5.1 
+	 (second version) and 
+	 1.2.840.10003.9.5.1.1 
+	 (<ulink url="&url.z39.50.extupdate3;">third and
+	  newest version</ulink>).
+	</entry>
+	<entry>3</entry>
+       </row>
       </tbody>
      </tgroup>
     </table>