X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fyaz-ztest-man.xml;h=6d1cc23d5a3ea5c872f92e077959f359c8ad1386;hb=2bfb0b990bbbe0f9c5ef9e78b094a2063bc45f33;hp=566c938affc98d26dce0ebf7a38445d354cc4c62;hpb=a85807bde8a4a08706d266bd7dd089fb6778e281;p=yaz-moved-to-github.git

diff --git a/doc/yaz-ztest-man.xml b/doc/yaz-ztest-man.xml
index 566c938..6d1cc23 100644
--- a/doc/yaz-ztest-man.xml
+++ b/doc/yaz-ztest-man.xml
@@ -17,18 +17,18 @@
   <productnumber>&version;</productnumber>
   <info><orgname>Index Data</orgname></info>
  </refentryinfo>
- 
+
  <refmeta>
   <refentrytitle>yaz-ztest</refentrytitle>
   <manvolnum>8</manvolnum>
   <refmiscinfo class="manual">System management commands</refmiscinfo>
  </refmeta>
- 
+
  <refnamediv>
   <refname>yaz-ztest</refname>
   <refpurpose>Z39.50/SRU Test Server</refpurpose>
  </refnamediv>
- 
+
  <refsynopsisdiv>
   &gfs-synopsis;
  </refsynopsisdiv>
@@ -53,7 +53,7 @@
    </screen>
   </para>
   <para>
-   For UNIX local socket the address is the filename of the local socket.
+   For UNIX local socket, the address is the filename of the local socket.
   </para>
  </refsect1>
  <refsect1>
@@ -64,12 +64,28 @@
    <title>TESTING</title>
    <para>
     <command>yaz-ztest</command> normally returns a random hit count between
-    0 and 24. However, if a query term includes leading digits, then the 
+    0 and 24. However, if a query term includes leading digits, then the
     integer value of that term is used as hit count. This allows testers
     to return any number of hits. <command>yaz-ztest</command> includes
-    24 MARC records for testing. Hit counts exceeding 24 will make 
-    <command>yaz-ztest</command> return the same record batch over and over..
-    So record at position 1, 25, 49, etc .. are equivalent.
+    24 MARC records for testing. Hit counts exceeding 24 will make
+    <command>yaz-ztest</command> return the same record batch over and over.
+    So record at position 1, 25, 49, etc. are equivalent.
+   </para>
+   <para>
+    For XML, if no element set is given or element has value "marcxml",
+    MARCXML is returned (each of the 24 dummy records converted from
+    ISO2709 to XML). For element set OP, then OPAC XML is returned.
+   </para>
+   <para>
+    yaz-ztest may also return predefined XML records (for testing).
+    This is enabled if <literal>YAZ_ZTEST_XML_FETCH</literal> environment
+    variable is defined. A record is fetched from a file (one record per file).
+    The path for the filename is
+    <replaceable>F</replaceable><replaceable>E</replaceable><literal>.</literal><replaceable>d</replaceable><literal>.xml</literal>
+    where <replaceable>F</replaceable> is the YAZ_ZTEST_XML_FETCH value
+    (possibly
+    empty), <replaceable>E</replaceable> is element-set,
+    <replaceable>d</replaceable> is record position (starting from 1).
    </para>
    <para>
      The following databases are honored by <command>yaz-ztest</command>:
@@ -92,11 +108,11 @@
      The value of the delay may either be a fixed floating point
      value which specifies the delay in seconds.
      Alternatively the value may be given as two floating point numbers
-     separated by colon, which wil make <command>yaz-ztest</command> perform
+     separated by colon, which will make <command>yaz-ztest</command> perform
      a random sleep between the first and second number.
    </para>
    <para>
-     The database parameter <literal>seed</literal> takes an integer 
+     The database parameter <literal>seed</literal> takes an integer
      as value. This will call <literal>srand</literal> with this integer to
      ensure that the random behavior can be re-played.
    </para>
@@ -133,15 +149,7 @@
 
 <!-- Keep this comment at the end of the file
 Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-local-catalogs: nil
-sgml-namecase-general:t
+mode: nxml
+nxml-child-indent: 1
 End:
 -->