From a654dca0f59fd27228816703c8bb959f2970ca4e Mon Sep 17 00:00:00 2001
From: Adam Dickmeiss <adam@indexdata.dk>
Date: Mon, 19 Apr 2004 13:43:44 +0000
Subject: [PATCH] Prepare examples. More info on syntax rules

---
 doc/reference.xml |   80 +++++++++++++++++++++++++++++++++++------------------
 doc/using.xml     |   17 +++++++++++-
 2 files changed, 69 insertions(+), 28 deletions(-)

diff --git a/doc/reference.xml b/doc/reference.xml
index 15274ea..2bd922d 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -117,14 +117,16 @@
     <title>Proxy Configuration Header</title>
     <para>
      The proxy config file must have a root element called
-     <literal>proxy</literal>. All information except an optional XML
-     header must be stored within the <literal>proxy</literal> element.
+     <literal>proxy</literal> and scoped within namespace
+     <literal> xmlns="http://indexdata.dk/yazproxy/schema/0.8/</literal>.
+     All information except an optional XML header must be stored
+     within the <literal>proxy</literal> element.
     </para>
     <screen>
      &lt;?xml version="1.0"?>
-      &lt;proxy>
-       &lt;!-- content here .. -->
-      &lt;/proxy>
+     &lt;proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
+      &lt;!-- content here .. -->
+     &lt;/proxy>
     </screen>
    </section>
    <section id="proxy-config-target">
@@ -142,7 +144,7 @@
     <para>
      <screen>
      &lt;?xml version="1.0"?>
-     &lt;proxy>
+     &lt;proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
       &lt;target name="server1" default="1">
        &lt;!-- description of server1 .. -->
       &lt;/target>
@@ -306,19 +308,6 @@
      </screen>
     </para>
    </section>
-
-   <!-- TODO -->
-   <!--
-
-    <syntax type="xml" marcxml="1" stylesheet="MARC21slim2MODS.xsl"
-      identifier="http://www.loc.gov/mods"
-      >
-      <title>MODS v2</title>
-      <name>mods2</name>
-    </syntax>
-
-
--->
    <section id="proxy-config-syntax">
     <title>syntax</title>
     <para>
@@ -344,18 +333,55 @@
      <literal>type</literal> should be XML. The proxy will use
      preferred record syntax USMARC/MARC21 against the backend target.
     </para>
-    <para>To accept USMARC and offer MARCXML XML records but reject
-     all other requests the following configuration could be used:
-     <screen>
-      &lt;proxy>
+    <para>
+     If attribute <literal>stylesheet</literal> is given, the proxy
+     will convert XML record from server via XSLT. It is important
+     that the content from server is XML. If used in conjunction with
+     attribute <literal>marcxml</literal> the MARC to MARCXML conversion
+     takes place before the XSLT conversion takes place.
+    </para>
+    <para>
+     If attribute <literal>identifier</literal> is given that is the
+     SRW/SRU record schema identifier for the resulting output record (after
+     MARCXML and/or XSLT conversion). 
+    </para>
+    <para>
+     If sub element <literal>title</literal> is given (as child element
+     of <literal>syntax</literal>, then that is the official SRW/SRU
+     name of the resulting record schema.
+    </para>
+    <para>
+     If sub element <literal>name</literal> is given that is an alias
+     for the record schema identifier. Multiple <literal>name</literal>s
+     may be specified.
+    </para>
+    <example>
+     <title>MARCXML conversion</title>
+     <para>To accept USMARC and offer MARCXML XML plus Dublin Core (via
+      XSLT conversion) but the following configuration could be used:
+      <screen>
+       &lt;proxy>
        &lt;target name="mytarget">
+       ..
        &lt;syntax type="usmarc"/>
-        &lt;syntax type="xml" marcxml="1"/>
-        &lt;syntax type="*" error="238"/>
+       &lt;syntax type="xml" marcxml="1"
+        identifier="info:srw/schema/1/marcxml-v1.1"
+        &lt;title>MARCXML&lt;title>
+        &lt;name>marcxml&lt;name>
+       &lt;syntax>
+       &lt;syntax type="xml" marcxml="1" stylesheet="MARC21slim2SRWDC.xsl"
+        identifier="info:srw/schema/1/dc-v1.1">
+        &lt;title>Dublin Core&lt;title>
+        &lt;name>dc&lt;name>
+       &lt;syntax>
+       &lt;syntax type="*" error="238"/>
+       ..
        &lt;/target>
-      &lt;/proxy>
-     </screen>
+       &lt;/proxy>
+      </screen>
     </para>
+    </example>
+
    </section>
 
    <section id="proxy-config-explain">
diff --git a/doc/using.xml b/doc/using.xml
index f6106f8..d6ed178 100644
--- a/doc/using.xml
+++ b/doc/using.xml
@@ -25,7 +25,7 @@
    except any log files you ask for.
   </para>
 
-  <example id="proxy-example">
+  <example id="example-apdu-logging">
    <title>Using the Proxy to Log APDUs</title>
    <para>
     Suppose you use a commercial Z39.50 client for which you do not
@@ -126,6 +126,21 @@
 ]]>
    </screen>
   </example>
+
+  <example id="example-firewall">
+   <title>Exposing a Z39.50 server behind a firewall</title>
+   <para>
+    ..
+   </para>
+  </example>
+  
+  <example id="example-srw-service">
+   <title>Offering SRW/SRU/Z39.50 service</title>
+   <para>
+    ..
+   </para>
+  </example>
+
  </chapter>
 
  <!-- Keep this comment at the end of the file
-- 
1.7.10.4