List more dependencies

[yazproxy-moved-to-github.git] / doc / installation.xml

diff --git a/doc/installation.xml b/doc/installation.xml
index bf02c66..9cc450d 100644 (file)
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,9 +1,10 @@
 <chapter id="installation">
-  <!-- $Id: installation.xml,v 1.6 2004-04-23 16:10:24 adam Exp $ -->
+  <!-- $Id: installation.xml,v 1.8 2005-02-07 09:50:23 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:
@@ -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: