X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Ffrontend.xml;h=14a564bf954cfa7e9d3623b31554125f7bc15554;hb=23511a86ab565d5a4ce3c8f5924a49e9d310ba98;hp=2350af3ef892eda070163d754a273cf5543e165e;hpb=21f7c16c6b1b694405dbc1760d3d6cb3caac38f6;p=yaz-moved-to-github.git

diff --git a/doc/frontend.xml b/doc/frontend.xml
index 2350af3..14a564b 100644
--- a/doc/frontend.xml
+++ b/doc/frontend.xml
@@ -1,6 +1,6 @@
-<!-- $Id: frontend.xml,v 1.30 2006-06-13 16:01:51 adam Exp $ -->
+<!-- $Id: frontend.xml,v 1.33 2007-02-01 09:56:14 adam Exp $ -->
  <chapter id="server"><title>Generic server</title>
-  <sect1><title>Introduction</title>
+  <sect1 id="server.introduction"><title>Introduction</title>
    
    <para>
     If you aren't into documentation, a good way to learn how the
@@ -167,7 +167,7 @@ int statserv_main(int argc, char **argv,
    </para>
 
    <synopsis>
-statserv_options_block *statserv_getcontrol(void);
+    statserv_options_block *statserv_getcontrol(void);
    </synopsis>
 
    <para>
@@ -200,18 +200,12 @@ statserv_options_block *statserv_getcontrol(void);
        </para></listitem></varlistentry>
      
      <varlistentry><term>
-       <literal>int loglevel</literal></term><listitem><para>
-	Set this by ORing the constants defined in
-	<filename>include/yaz/yaz-log.h</filename>.
-       </para></listitem></varlistentry>
-     
-     <varlistentry><term>
-       <literal>char logfile&lsqb;ODR_MAXNAME+1&rsqb;</literal></term>
+       <literal>char logfile[ODR_MAXNAME+1]</literal></term>
       <listitem><para>File for diagnostic output (&quot;&quot;: stderr).
        </para></listitem></varlistentry>
      
      <varlistentry><term>
-       <literal>char apdufile&lsqb;ODR_MAXNAME+1&rsqb;</literal></term>
+       <literal>char apdufile[ODR_MAXNAME+1]</literal></term>
       <listitem><para>
 	Name of file for logging incoming and outgoing APDUs
 	(&quot;&quot;: don't log APDUs, &quot;-&quot;:
@@ -219,7 +213,7 @@ statserv_options_block *statserv_getcontrol(void);
        </para></listitem></varlistentry>
 
      <varlistentry><term>
-      <literal>char default_listen&lsqb;1024&rsqb;</literal></term>
+      <literal>char default_listen[1024]</literal></term>
       <listitem><para>Same form as the command-line specification of
 	listener address. &quot;&quot;: no default listener address.
 	Default is to listen at &quot;tcp:@:9999&quot;. You can only
@@ -250,12 +244,12 @@ statserv_options_block *statserv_getcontrol(void);
        </para></listitem></varlistentry>
 
      <varlistentry><term>
-       <literal>char configname&lsqb;ODR_MAXNAME+1&rsqb;</literal></term>
+       <literal>char configname[ODR_MAXNAME+1]</literal></term>
       <listitem><para>Passed to the backend when a new connection is received.
        </para></listitem></varlistentry>
 
      <varlistentry><term>
-       <literal>char setuid&lsqb;ODR_MAXNAME+1&rsqb;</literal></term>
+       <literal>char setuid[ODR_MAXNAME+1]</literal></term>
       <listitem><para>Set user id to the user specified, after binding
 	the listener addresses.
        </para></listitem></varlistentry>
@@ -321,7 +315,7 @@ void statserv_setcontrol(statserv_options_block *block);
     functions representing the services that you wish to implement.
    </para>
 
-   <sect2><title>Init</title>
+   <sect2 id="server.init"><title>Init</title>
 
     <synopsis>
 bend_initresult (*bend_init)(bend_initrequest *r);
@@ -435,7 +429,7 @@ typedef struct bend_initresult
 
    </sect2>
 
-   <sect2><title>Search and retrieve</title>
+   <sect2 id="server.search.retrieve"><title>Search and Retrieve</title>
 
     <para>We now describe the handlers that are required to support search -
      and retrieve. You must support two functions - one for search - and one
@@ -509,7 +503,7 @@ typedef struct {
      structure (note that CQL is now part of Z39.50 via an external).
      To support CQL in existing implementations that only do Type-1,
      we refer to the CQL-to-PQF tool described
-     <link linkend="tools.cql.pqf">here</link>.
+     <link linkend="cql.to.pqf">here</link>.
     </para>
 
     <para>
@@ -656,7 +650,7 @@ typedef struct {
 
    </sect2>
 
-   <sect2><title>Delete</title>
+   <sect2 id="server.delete"><title>Delete</title>
 
     <para>
      For back-ends that supports delete of a result set only one handler
@@ -690,7 +684,7 @@ typedef struct bend_delete_rr {
 
    </sect2>
 
-   <sect2><title>scan</title>
+   <sect2 id="server.scan"><title>Scan</title>
 
     <para>
      For servers that wish to offer the scan service one handler
@@ -768,7 +762,7 @@ typedef struct bend_scan_rr {
    </para>
 
    <synopsis>
-    hostname | IP-number &lsqb;: portnumber&rsqb;
+    hostname | IP-number [: portnumber]
    </synopsis>
    
    <para>
@@ -785,7 +779,7 @@ typedef struct bend_scan_rr {
     which causes the server to listen on any local interface. 
    </para>
 
-   <example><title>Running the GFS on Unix</title>
+   <example id="server.example.running.unix"><title>Running the GFS on Unix</title>
     <para>
      Assuming the server application <replaceable>appname</replaceable> is
      started as root, the following will make it listen on port 210.
@@ -799,7 +793,7 @@ typedef struct bend_scan_rr {
      The server will accept Z39.50 requests and offer SRU service on port 210.
     </para>
    </example>
-   <example><title>Setting up Apache as SRU Frontend</title>
+   <example id="server.example.apache.sru"><title>Setting up Apache as SRU Frontend</title>
     <para>
      If you use <ulink url="&url.apache;">Apache</ulink>
      as your public web server and want to offer HTTP port 80
@@ -822,7 +816,8 @@ typedef struct bend_scan_rr {
      The above for the Apache 1.3 series.
     </para>
    </example>
-   <example><title>Running a server with local access only</title>
+   <example id="server.example.local.access">
+    <title>Running a server with local access only</title>
     <para>
      Servers that is only being accessed from the local host should listen
      on UNIX file socket rather than a Internet socket. To listen on