X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=96ced05098b01e66d03d78ac7b2451aeb616d66d;hp=4c32b9d3915378a3b6fb3d9961b9c8f05a79ba1a;hb=b276287e0e21b0bb267c5d5a7d87254ee1f5e29f;hpb=b65837a1f4aadf842d112f5e37382d93f26da83d

diff --git a/doc/installation.xml b/doc/installation.xml
index 4c32b9d..96ced05 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,9 +1,10 @@
 <chapter id="installation">
-  <!-- $Id: installation.xml,v 1.4 2004-04-21 08:16:42 adam Exp $ -->
+  <!-- $Id: installation.xml,v 1.9 2006-04-06 01:16:54 adam Exp $ -->
   <title>Installation</title>
   <para>
    You need a C++ compiler to compile and use YAZ proxy.
-   The software was implemented using GCC so we know that works
+   The software was implemented using
+   <ulink url="http://gcc.gnu.org/">GCC</ulink> so we know that works
    well with YAZ proxy. From time to time the software has been
    compiled on Windows using Visual C++. Other compilers should
    work too. Let us know of portability problems, etc. with
@@ -15,16 +16,27 @@
    <ulink url="http://indexdata.dk/yazplusplus/">YAZ++</ulink>
    toolkits.
    You need to install these first.
-   For some platforms there are binary packages for YAZ/YAZ++.
+   For some platforms there are binary packages available for YAZ/YAZ++.
   </para>
   <para>
    We also highly recommend that
    <ulink url="http://xmlsoft.org/">libxml2</ulink> and
    <ulink url="http://xmlsoft.org/XSLT/">libXSLT</ulink> are installed.
    YAZ must be configured with libxml2 support.
-   If not, SRW/SRU is not supported.
+   If not, 
+   <ulink url="http://www.loc.gov/z3950/agency/zing/srw/">SRW/SRU</ulink>
+   is not supported.
    The YAZ Proxy uses libXSLT for record conversions via XSLT.
   </para>
+  <para>
+   YAZ proxy may also use USEMARCON to convert between MARC
+   formats. This is useful if you want the proxy to offer more
+   MARC record types than the backend target supports. Get USEMARCON
+   from:
+   <ulink url="http://www.bl.uk/services/bibliographic/usemarcon.html">
+    British Library USEMARCON page
+   </ulink>.
+  </para>
   <section id="unix">
    <title>Building on Unix</title>
    <para>On UNIX, the software is compiled as follows:
@@ -47,16 +59,16 @@
        </para></listitem>
      </varlistentry>
      <varlistentry>
-      <term><literal>--with-yazppconfig </literal>directory</term>
+      <term><literal>--with-yazpp </literal>directory</term>
       <listitem><para>
-        Specifies the location of <filename>yaz++-config</filename>.
-        The <filename>yaz++-config</filename> program is generated in
+        Specifies the location of <filename>yazpp-config</filename>.
+        The <filename>yazpp-config</filename> program is generated in
         the source directory of YAZ++ as well as the binaries
         directory when YAZ++ is installed (via make install).
         </para>
        <para>
         If you don't supply this option, <literal>configure</literal> will
-        look for <filename>yaz++-config</filename> in directories of the
+        look for <filename>yazpp-config</filename> in directories of the
         <envar>PATH</envar> environment - which is nearly always
         what you want.
        </para></listitem>
@@ -70,6 +82,15 @@
 	for <command>xslt-config</command> in the current PATH.
        </para></listitem>
      </varlistentry>
+     <varlistentry>
+      <term><literal>--with-usemarcon </literal>directory</term>
+      <listitem><para>
+        Specifies USEMARCON installation prefix.
+	configure must be able to locate <command>usemarcon-config</command>
+	in PREFIX/bin. If this option is omitted, configure looks
+	for <command>usemarcon-config</command> in the current PATH.
+       </para></listitem>
+     </varlistentry>
     </variablelist>
     For the whole list of <literal>configure</literal> options, refer
     to the help:
@@ -117,8 +138,11 @@
      <varlistentry>
       <term><literal>etc</literal></term> 
       <listitem><para>
-	Various files that may be read by YAZ proxy - including
-	configuration file, XSLT files, CQL to RPN conversion.
+	Various files such as
+	configuration files, XSLT files, CQL to RPN conversion files,
+	a sample start/stop control script
+	<filename>yazproxy.ctl.sh</filename> that can be used as
+	template for an <filename>/etc/init.d</filename> script.
 	These files are installed in the YAZ proxy's data area
 	(<parameter>prefix</parameter><literal>/share/yazproxy</literal>).
        </para></listitem>