X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=e45f3558a737a152d173364792a9d0b752c6d424;hb=68b64d522e3196a8d593a3f683ef95aaf9e5e713;hp=bf02c665554eae56ee7c7270bb45339f778c76dc;hpb=7767f42f8aa5359239cfe3dd99ee18b6fb23546f;p=yazproxy-moved-to-github.git

diff --git a/doc/installation.xml b/doc/installation.xml
index bf02c66..e45f355 100644
--- 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.12 2006-06-14 10:12:26 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="&url.gcc;">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
@@ -11,20 +12,30 @@
   </para>
   <para>
    YAZ proxy is built on top of the 
-   <ulink url="http://indexdata.dk/yaz/">YAZ</ulink> and
-   <ulink url="http://indexdata.dk/yazplusplus/">YAZ++</ulink>
+   <ulink url="&url.yaz;">YAZ</ulink> and
+   <ulink url="&url.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.
+   <ulink url="&url.libxml2;">libxml2</ulink> and
+   <ulink url="&url.libxslt;">libXSLT</ulink> are installed.
    YAZ must be configured with libxml2 support.
-   If not, SRW/SRU is not supported.
+   If not, 
+   <ulink url="&url.sru;">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="&url.usemarcon;">British Library USEMARCON page
+   </ulink>.
+  </para>
   <section id="unix">
    <title>Building on Unix</title>
    <para>On UNIX, the software is compiled as follows:
@@ -49,14 +60,14 @@
      <varlistentry>
       <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 +81,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:
@@ -134,7 +154,7 @@
    <title>Building on Windows</title>
    <para>
     YAZ++ is shipped with "makefiles" for the NMAKE tool that comes
-    with <ulink url="http://msdn.microsoft.com/vstudio/">
+    with <ulink url="&url.vstudio;">
      Microsoft Visual Studio</ulink>.
     Version 6 and .NET has been tested. We expect that YAZ++ compiles
     with version 5 as well.
@@ -187,7 +207,7 @@
 	If <literal>HAVE_LIBXSLT</literal> is set to 1, the proxy is compiled
 	with XSLT and XML support. In this configuration, set 
 	<literal>LIBXSLT_DIR</literal> to the 
-	<ulink url="http://www.xmlsoft.org/">libXSLT</ulink> source
+	<ulink url="&url.libxslt;">libXSLT</ulink> source
 	directory.
        </para>
        
@@ -200,7 +220,7 @@
        
        <para>
 	Windows versions of libXSLT, libxml2, zlib and iconv can be found
-	<ulink url="http://www.zlatkovic.com/libxml.en.html">
+	<ulink url="&url.libxml2.download.win32;">
 	 here</ulink>.
        </para>
       </listitem>
@@ -224,7 +244,7 @@
 	If <literal>HAVE_LIBXML2</literal> is set to 1, the proxy is compiled
 	with XML support. In this configuration, set 
 	<literal>LIBXML2_DIR</literal> to the 
-	<ulink url="http://www.xmlsoft.org/">libxml2</ulink> source directory
+	<ulink url="&url.libxml2;">libxml2</ulink> source directory
 	and
 	<literal>ZLIB_DIR</literal> to the zlib directory.
        </para>