debian compat 9
[yazproxy-moved-to-github.git] / doc / using.xml
index add3570..c2d09b6 100644 (file)
@@ -5,7 +5,7 @@
    This chapter includes a few examples.
   </para>
   <para>
-   The YAZ Proxy is useful for debugging SRW/SRU/Z39.50 software, logging
+   The YAZ Proxy is useful for debugging SRU/Z39.50 software, logging
    APDUs, redirecting Z39.50 packages through firewalls, etc.
    Furthermore, it offers facilities that often
    boost performance for connection-less Z39.50 clients such
     be achieved by creating a configuration with the following contents:
     <screen><![CDATA[
      <?xml version="1.0"?>
-     <proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
+     <proxy xmlns="http://indexdata.dk/yazproxy/schema/0.9/">
        <target name="foo" default="1">
          <url>foo.bar.com:18398</url>
          <log>client-apdu</log>
   </example>
   
   <example id="example-srw-service">
-   <title>Offering SRW/SRU/Z39.50 service</title>
+   <title>Offering SRU/Z39.50 service</title>
    <para>
-    In order to offer SRW/SRU service we must be specify sufficient
-    information to allow the proxy to convert from SRW/SRU to Z39.50.
-    This involves CQL to Type-1 (also called RPN/PQF), since most
+    In order to offer SRU service we must be specify sufficient
+    information to allow the proxy to convert from SRU to Z39.50.
+    This involves translating CQL queries
+    to Type-1 (also called RPN/PQF), since most
     Z39.50 servers do not support CQL. The conversion
     is specified by the <literal>cql2rpn</literal> element.
    </para>
     recommended). 
    </para>
    <para>
-    An explain record for the SRW/SRU service must also be created.
+    An explain record for the SRU service must also be created.
    </para>
    <para>
     The following is a relatively simple configuration file for 
     given by <literal>url</literal>.
    </para>
    <para>
-    The server may return USMARC/MARC21 (Z39.50/SRW/SRU) and
-    MARCXML (SRW/SRU only) as specified by the
+    The server may return USMARC/MARC21 (Z39.50/SRU) and
+    MARCXML (SRU only) as specified by the
     <link linkend="proxy-config-syntax">syntax</link> elements.
    </para>
     <screen><![CDATA[
 <?xml version="1.0"?>
-<!-- $Id: using.xml,v 1.4 2004-04-21 08:16:42 adam Exp $ -->
-<proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
+<proxy xmlns="http://indexdata.dk/yazproxy/schema/0.9/">
   <target name="bagel">
     <url>indexdata.dk</url>
     <target-timeout>240</target-timeout>
 ]]>
     </screen>
    <para>
-    The conversion from CQL to RPN is specified by the
+    The conversion from CQL to RPN is specified by a file whose name,
+    relative to the working directory, is given in the
     <link linkend="proxy-config-cql2rpn">cql2rpn</link> element.
-    <filename>pqf.properties</filename>.
-    A complete BATH/DC conversion file
-    <filename>pqf.properties</filename> is
-    part of yazproxy in sub directory <filename>etc</filename>.
+    A complete Bath/DC conversion file,
+    <filename>pqf.properties</filename> is provided as part of the
+    yazproxy distribution in the <filename>etc</filename>
+    subdirectory.
    </para>
    <para>
     Explain information is embedded in the configuration file.