X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fpazpar2.xml;h=19e39ec8778ee5d09b9b932ddb8f1e6d89cfa670;hb=bd75f23928644eba826382a45d42756cdd2ac7b1;hp=c9b2614b2ae1fc52eaba78ef103d0e3581d02f43;hpb=ff90a10d56bd25ce276eab48c5cebfe7e7324f70;p=pazpar2-moved-to-github.git

diff --git a/doc/pazpar2.xml b/doc/pazpar2.xml
index c9b2614..19e39ec 100644
--- a/doc/pazpar2.xml
+++ b/doc/pazpar2.xml
@@ -1,5 +1,5 @@
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
- "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"
 [
      <!ENTITY % local SYSTEM "local.ent">
      %local;
@@ -12,10 +12,13 @@
  <refentryinfo>
   <productname>Pazpar2</productname>
   <productnumber>&version;</productnumber>
+  <info><orgname>Index Data</orgname></info>
  </refentryinfo>
+
  <refmeta>
   <refentrytitle>Pazpar2</refentrytitle>
   <manvolnum>8</manvolnum>
+  <refmiscinfo class="manual">System management commands</refmiscinfo>
  </refmeta>
  
  <refnamediv>
@@ -31,19 +34,24 @@
    <arg choice="opt"><option>-f <replaceable>config</replaceable></option></arg>
    <arg choice="opt"><option>-h <replaceable>ip:port</replaceable></option></arg>
    <arg choice="opt"><option>-l <replaceable>logfile</replaceable></option></arg>
+   <arg choice="opt"><option>-m <replaceable>timeformat</replaceable></option></arg>
    <arg choice="opt"><option>-p <replaceable>pidfile</replaceable></option></arg>
+   <arg choice="opt"><option>-R <replaceable>recfile</replaceable></option></arg>
    <arg choice="opt"><option>-t</option></arg>
-   <arg choice="opt"><option>-T <replaceable>session_timeout</replaceable></option></arg>
    <arg choice="opt"><option>-u <replaceable>uid</replaceable></option></arg>
+   <arg choice="opt"><option>-v <replaceable>level</replaceable></option></arg>
    <arg choice="opt"><option>-V</option></arg>
+   <arg choice="opt"><option>-w <replaceable>dir</replaceable></option></arg>
    <arg choice="opt"><option>-X</option></arg>
    <arg choice="opt"><option>-install</option></arg>
    <arg choice="opt"><option>-remove</option></arg>
   </cmdsynopsis>
  </refsynopsisdiv>
  
- <refsect1><title>DESCRIPTION</title>
-  <para><command>pazpar2</command> is the Pazpar2 Metasearch daemon
+ <refsect1>
+  <title>DESCRIPTION</title>
+  <para>
+   <command>pazpar2</command> is the Pazpar2 Metasearch daemon
    and server.
    In normal operation it acts as a simple HTTP server which serves
    the Pazpar2 protocol.
@@ -54,8 +62,8 @@
   </para>
  </refsect1>
  
- <refsect1><title>OPTIONS</title>
-  <para></para>
+ <refsect1>
+  <title>OPTIONS</title>
   
   <variablelist>
    <varlistentry>
@@ -65,12 +73,19 @@
       Enables dump of XML records to the current log file.
       It is useful if stylesheets are being debugged.
      </para>
+     <para>
+      This option may also be used together with option <option>-t</option>
+      in which case the configuration, after include processing, will be
+      dumped to stdout.
+     </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><option>-D</option></term>
     <listitem>
-     <para>Puts the Pazpar2 server in the background.</para>
+     <para>
+     Puts the Pazpar2 server in the background.
+     </para>
     </listitem>
    </varlistentry>
    <varlistentry>
@@ -103,6 +118,17 @@
     </listitem>
    </varlistentry>
    <varlistentry>
+    <term>-m <replaceable>timeformat</replaceable></term>
+    <listitem><para>
+     Sets the format of time-stamps for logging.
+     Refer to the
+       <ulink
+	   url="http://pubs.opengroup.org/onlinepubs/009695399/functions/strftime.html">
+       strftime(3)</ulink>
+       man page for the format.
+    </para></listitem>
+   </varlistentry>
+   <varlistentry>
     <term><option>-p <replaceable>pidfile</replaceable></option></term>
     <listitem>
      <para>
@@ -111,6 +137,15 @@
      </para>
     </listitem>
    </varlistentry>
+   <varlistentry>
+    <term><option>-R <replaceable>recfile</replaceable></option></term>
+    <listitem>
+     <para>
+      If this option is given, HTTP requests are logged to file named
+      <replaceable>recfile</replaceable>.
+     </para>
+    </listitem>
+   </varlistentry>
 
    <varlistentry>
     <term><option>-t</option></term>
@@ -120,9 +155,13 @@
       started. Useful for checking a new configuration before a
       Pazpar2 is restarted.
      </para>
+     <para>
+      The configuration, after include processing, may also be dumped
+      to stdout by supplying option <option>-d</option> as well.
+     </para>
      <note>
       <para>
-       In Pazpar2 1.2 and earlier releasese, option -t specified a
+       In Pazpar2 1.2 and earlier releases, option -t specified a
        local target settings file.
       </para>
      </note>
@@ -130,22 +169,21 @@
    </varlistentry>
 
    <varlistentry>
-    <term><option>-T <replaceable>session_timeout</replaceable></option></term>
+    <term><option>-u <replaceable>uid</replaceable></option></term>
     <listitem>
      <para>
-      Specifies a Pazpar2 HTTP session timeout. This
-      overrides the default value of 60 seconds which is to low for some broken browser.
+      Makes the Pazpar2 server change user ID to the
+      <replaceable>uid</replaceable> given.
+      This, normally, requires root privilege.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><option>-u <replaceable>uid</replaceable></option></term>
+    <term><option>-v <replaceable>level</replaceable></option></term>
     <listitem>
      <para>
-      Makes the Pazpar2 server change user ID to the
-      <replaceable>uid</replaceable> given.
-      This, normally, requires root privilege.
+      Sets log level (YAZ log level system).
      </para>
     </listitem>
    </varlistentry>
@@ -155,13 +193,22 @@
     <listitem>
      <para>
       Shows Pazpar2 version and versions of some of the components that it
-      is using (ICU and YAZ). Pazpar2 will not exit immediately after
+      is using (ICU and YAZ). Pazpar2 will exit immediately after
       displaying the version information (no daemon started).
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
+    <term><option>-w <replaceable>dir</replaceable></option></term>
+    <listitem>
+     <para>
+      Changes working directory to <replaceable>dir</replaceable>.
+     </para>
+    </listitem>
+   </varlistentry>
+
+   <varlistentry>
     <term><option>-X</option></term>
     <listitem>
      <para>
@@ -176,14 +223,14 @@
     <term><option>-install</option></term>
     <listitem>
      <para>
-       This is an option which is only recognized on Windows. It installs
-       Pazpar2 as a Windows Service.
+      This is an option which is only recognized on Windows. It installs
+      Pazpar2 as a Windows Service.
      </para>
      <note>
-       <para>
-	 Pazpar2 only supports Windows Service options if Pazpar2 is
-	 linked against YAZ 3.0.29 or later.
-       </para>
+      <para>
+       Pazpar2 only supports Windows Service options if Pazpar2 is
+       linked against YAZ 3.0.29 or later.
+      </para>
      </note>
     </listitem>
    </varlistentry>
@@ -192,8 +239,8 @@
     <term><option>-remove</option></term>
     <listitem>
      <para>
-       This is an option which is only recognized on Windows. It removes
-       a Pazpar2 - Windows Service.
+      This is an option which is only recognized on Windows. It removes
+      a Pazpar2 - Windows Service.
      </para>
     </listitem>
    </varlistentry>
@@ -202,7 +249,8 @@
   
  </refsect1>
  
- <refsect1><title>EXAMPLES</title>
+ <refsect1>
+  <title>EXAMPLES</title>
   <para>The Debian package of pazpar2 starts the server with:
    <screen>
     pazpar2 -D -f /etc/pazpar2/pazpar2.cfg -l /var/log/pazpar2.log -p /var/run/pazpar2.pid -u nobody
@@ -232,15 +280,17 @@
   </para>
  </refsect1> 
  
- <refsect1><title>FILES</title>
+ <refsect1>
+  <title>FILES</title>
   <para><filename>/usr/sbin/pazpar2</filename>: pazpar2 daemon</para>
-
+  
   <para><filename>/usr/share/pazpar2</filename>: pazpar2 shared files</para>
-
+  
   <para><filename>/etc/pazpar2</filename>: pazpar2 config area</para>
  </refsect1>
  
- <refsect1><title>SEE ALSO</title>
+ <refsect1>
+  <title>SEE ALSO</title>
   <para>
    Pazpar2 configuration:
    <citerefentry>
@@ -259,18 +309,9 @@
 
 </refentry>
 
-
 <!-- 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:
 -->