doc/zeerex_explain.xml

   1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
   2     "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" [
   3  <!ENTITY copyright SYSTEM "copyright.xml">
   4  <!ENTITY % common SYSTEM "common/common.ent">
   5      %common;
   6 ]>
   7 <!-- $Id: zeerex_explain.xml,v 1.2 2007-01-08 12:27:27 marc Exp $ -->
   8 <refentry>
   9  <refmeta>
  10   <refentrytitle>zeerex_explain</refentrytitle>
  11   <manvolnum>3mp</manvolnum>
  12   <refmiscinfo>Metaproxy Module</refmiscinfo>
  13  </refmeta>
  14
  15  <refnamediv>
  16   <refname>zeerex_explain</refname>
  17   <refpurpose>answering Z39.50 ZeeReX explain requests</refpurpose>
  18  </refnamediv>
  19
  20  <refsect1><title>DESCRIPTION</title>
  21   <para>
  22    The <literal>zeerex_explain</literal> Metaproxy filter
  23    answers valid Z30.50 explain requests, returning a
  24    static ZeeReX Explain XML record from the config section. All other
  25    packages are passed through.
  26   </para>
  27   <para>
  28    Multiple database elements defining the names of the accepted
  29    databases are allowed in the configuration file. Each
  30    of them must contain their own explain record. Notice that explain
  31    records come in SRU and Z39.50 flavours, and this filter requires
  32    the Z39.50 version. See the
  33    <ulink url="&url.zeerex.explain;">ZeeReX Explain</ulink>
  34    standard pages and the
  35    <ulink url="&url.sru.explain;">SRU Explain</ulink> pages
  36    for more information.
  37   </para>
  38  </refsect1>
  39
  40  <refsect1><title>EXAMPLES</title>
  41   <para>
  42    A typical configuration looks like this:
  43    <screen><![CDATA[
  44     <filter type="zeerex_explain">
  45       <database name="Default">
  46         <explain xmlns="http://explain.z3950.org/dtd/2.0/">
  47           ...
  48         </explain>
  49       </database>
  50     </filter>
  51 ]]>
  52    </screen>
  53   </para>
  54  </refsect1>
  55
  56  <refsect1><title>SEE ALSO</title>
  57   <para>
  58    <citerefentry>
  59     <refentrytitle>metaproxy</refentrytitle>
  60     <manvolnum>1</manvolnum>
  61    </citerefentry>
  62   </para>
  63   <para>
  64    <ulink url="&url.zeerex.explain;">ZeeReX Explain</ulink>
  65   </para>
  66  </refsect1>
  67
  68  &copyright;
  69 </refentry>
  70
  71 <!-- Keep this comment at the end of the file
  72 Local variables:
  73 mode: sgml
  74 sgml-omittag:t
  75 sgml-shorttag:t
  76 sgml-minimize-attributes:nil
  77 sgml-always-quote-attributes:t
  78 sgml-indent-step:1
  79 sgml-indent-data:t
  80 sgml-parent-document:nil
  81 sgml-local-catalogs: nil
  82 sgml-namecase-general:t
  83 End:
  84 -->