X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=doc%2Fpazpar2_protocol.xml;h=0a40fcdd549d05251407ea6b45bc12ad67f5aa30;hb=3d99aecedf9d6e6ebeadcedbee081049b03dbbf8;hp=23ddc280a0ff6004fdc39e1997808e6b2f5b0f80;hpb=98e1ff5ebcca708e56e87ed5ff3596cdf9b2ae1a;p=pazpar2-moved-to-github.git

diff --git a/doc/pazpar2_protocol.xml b/doc/pazpar2_protocol.xml
index 23ddc28..0a40fcd 100644
--- a/doc/pazpar2_protocol.xml
+++ b/doc/pazpar2_protocol.xml
@@ -1,3 +1,4 @@
+<?xml version="1.0" standalone="no"?>
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
  "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
 [
@@ -8,7 +9,6 @@
      <!ENTITY % idcommon SYSTEM "common/common.ent">
      %idcommon;
 ]>
-<!-- $Id: pazpar2_protocol.xml,v 1.9 2007-06-22 13:18:23 adam Exp $ -->
 <refentry id="pazpar2_protocol">
  <refentryinfo>
   <productname>Pazpar2</productname>
@@ -61,7 +61,19 @@
    <para>
      The init command may take a number of setting parameters, similar to
      the 'settings' command described below. These settings are immediately
-     applied to the new session.
+     applied to the new session. Other parameters for init are:
+    <variablelist>
+     <varlistentry>
+      <term>clear</term>
+      <listitem>
+       <para>
+	If this is defined and the value is non-zero, the session will
+	not use the predefined databases in the configuration; only those
+	specified in the settings parameters (per session databases).
+	</para>
+      </listitem>
+     </varlistentry>
+    </variablelist>
    </para>
   </refsect2>
   
@@ -150,6 +162,14 @@
 	</para>
       </listitem>
      </varlistentry>
+     <varlistentry>
+      <term>filter</term>
+      <listitem>
+       <para>
+	Filtering.
+	</para>
+      </listitem>
+     </varlistentry>
     </variablelist>
 
    </para>
@@ -301,7 +321,9 @@ search.pz2?session=2044502273&command=show&start=0&num=2&sort=title:1
   <refsect2 id="command-record">
    <title>record</title>
    <para>
-    Retrieves a detailed record. Parameters:
+    Retrieves a detailed record. Unlike the 
+    <link linkend="command-show">show</link> command, this command 
+    returns metadata records before merging takes place. Parameters:
 
     <variablelist>
      <varlistentry>
@@ -322,6 +344,62 @@ search.pz2?session=2044502273&command=show&start=0&num=2&sort=title:1
 	</para>
       </listitem>
      </varlistentry>
+
+     <varlistentry>
+      <term>offset</term>
+      <listitem>
+       <para>
+	This optional parameter is an integer which, when given, makes
+	Pazpar2 return the raw record for a target. The raw record
+	from first target is numbered 0, second numbered 1, etc.
+	When a raw record is returned Pazpar2 will XSLT transform the
+	record but an XML version is returned. All ISO2709 records are
+	returned as MARCXML. OPAC records are returned as YAZ'
+	OPAC with an MARCXML sibling.
+       </para>
+       <para>
+	When offset is not given the Pazpar2 metadata for the record
+	is returned and with metadata for each targets' data specified
+	in a 'location' list.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term>syntax</term>
+      <listitem>
+       <para>
+	This optional parameter is the record syntax used for raw 
+	transfer (i.e. when offset is specified). If syntax is not given,
+	but offset is used, the value of pz:requestsyntax is used.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term>esn</term>
+      <listitem>
+       <para>
+	This optional parameter is the element set name used to retrieval
+	of a raw record (i.e. when offset is specified).
+	If esn is not given, but offset is used, the value of pz:elements
+	is used.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term>binary</term>
+      <listitem>
+       <para>
+	This optional parameter enables "binary" response for retrieval
+	of a raw record (i.e. when offset is specified). For binary
+	responses the record is <emphasis>not</emphasis> converted to
+	XML and the HTTP content type is application/octet-stream.
+       </para>
+      </listitem>
+     </varlistentry>
+
     </variablelist>
    </para>
    <para> 
@@ -341,7 +419,6 @@ search.pz2?session=605047297&command=record&id=3
   <md-author>Mairs, John W.</md-author>
   <md-subject>Cartography</md-subject>
 </record>
-    <screen><![CDATA[
 ]]></screen>
    </para>
   </refsect2>
@@ -350,10 +427,25 @@ search.pz2?session=605047297&command=record&id=3
    <title>termlist</title>
    <para>
     Retrieves term list(s). Parameters:
-
-session
-name       -- comma-separated list of termlist names (default "subject")
-
+    
+    <variablelist>
+     <varlistentry>
+      <term>session</term>
+      <listitem>
+       <para>
+	Session Id.
+       </para>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term>name</term>
+      <listitem>
+       <para>
+	comma-separated list of termlist names (default "subject")
+       </para>
+      </listitem>
+     </varlistentry>
+    </variablelist>
    </para>
    <para>
     Example:
@@ -425,7 +517,7 @@ Output:
    <para> 
     Example:
     <screen><![CDATA[
-search.pz2?session=605047297&command=record&id=3
+search.pz2?session=605047297&command=bytarget&id=3
 ]]></screen>
 
     Example output:
@@ -447,11 +539,27 @@ search.pz2?session=605047297&command=record&id=3
     The following client states are defined: Client_Connecting,
     Client_Connected, Client_Idle, Client_Initializing, Client_Searching,
     Client_Searching, Client_Presenting, Client_Error, Client_Failed,
-    Client_Disconnected, Client_Stopped.
+    Client_Disconnected, Client_Stopped, Client_Continue.
    </para>
   </refsect2>
 
  </refsect1>
+ <refsect1><title>SEE ALSO</title>
+  <para>
+   Pazpar2:
+   <citerefentry>
+    <refentrytitle>pazpar2</refentrytitle>
+    <manvolnum>8</manvolnum>
+   </citerefentry>
+  </para>
+  <para>
+   Pazpar2 Configuration:
+   <citerefentry>
+    <refentrytitle>pazpar2_conf</refentrytitle>
+    <manvolnum>5</manvolnum>
+   </citerefentry>
+  </para>
+ </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file