X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fzoom.xml;h=51da6e923f3742c3215b344bc8333865d4d8ada7;hb=d9b58094a0cf30748e32337fa9f460f8f0273826;hp=19f5c378a90fd83127cf863928a892450e003fe4;hpb=a669063b8341659cd03dc90998997876b7177f4a;p=yaz-moved-to-github.git

diff --git a/doc/zoom.xml b/doc/zoom.xml
index 19f5c37..51da6e9 100644
--- a/doc/zoom.xml
+++ b/doc/zoom.xml
@@ -20,7 +20,6 @@ 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.61 2007-06-29 08:05:07 adam Exp $ -->
  <chapter id="zoom"><title>ZOOM</title>
   <para>
     &zoom; is an acronym for 'Z39.50 Object-Orientation Model' and is
@@ -267,6 +266,19 @@ 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</entry><entry>
+	SRU transport type. Must be either <literal>soap</literal>,
+	<literal>get</literal> or <literal>post</literal>.
+       </entry><entry>soap</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.2</entry></row>
      </tbody>
     </tgroup>
    </table>
@@ -744,6 +756,12 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
         <literal>const char *</literal>. 
        </para></listitem>
      </varlistentry>
+     <varlistentry><term><literal>schema</literal></term>
+      <listitem><para>The schema of the record is returned
+        as a C null-terminated string. Return type is
+        <literal>const char *</literal>. 
+       </para></listitem>
+     </varlistentry>
      <varlistentry><term><literal>render</literal></term>
       <listitem><para>The record is returned in a display friendly
         format. Upon completion buffer is returned
@@ -831,14 +849,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 +914,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>
@@ -1163,6 +1189,19 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
 	<entry>none</entry>
        </row>
        <row>
+	<entry>recordOpaque</entry>
+	<entry>Specifies an opaque record which is
+	  encoded as an ASN.1 ANY type with the OID as tiven by option
+	  <literal>syntax</literal> (see below).
+	  Option <literal>recordOpaque</literal> is an alternative
+	  to record - and <literal>record</literal> option (above) is
+	  ignored if recordOpaque is set. This option is only available in 
+	  YAZ 3.0.35 and later and is meant to facilitate Updates with
+	  servers from OCLC.
+	</entry>
+	<entry>none</entry>
+       </row>
+       <row>
 	<entry>syntax</entry>
 	<entry>The record syntax (transfer syntax). Is a string that
 	 is a known record syntax.