X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=364e4fdb7acf942c66eba2924f42accf21deabd5;hp=62356a597c670ba62c9b659fd69b91793724fab2;hb=36b087dfdcfd7d098d170ea72b29a1b0690032d2;hpb=d7f83afe64067abffcffb82be0c4d042d1c9f2ca

diff --git a/doc/installation.xml b/doc/installation.xml
index 62356a5..364e4fd 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,10 +1,9 @@
 <chapter id="installation">
-  <!-- $Id: installation.xml,v 1.7 2004-04-23 16:25:17 adam Exp $ -->
   <title>Installation</title>
   <para>
    You need a C++ compiler to compile and use YAZ proxy.
    The software was implemented using
-   <ulink url="http://gcc.gnu.org/">GCC</ulink> so we know that works
+   <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
@@ -12,22 +11,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 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, 
-   <ulink url="http://www.loc.gov/z3950/agency/zing/srw/">SRW/SRU</ulink>
+   <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:
@@ -52,14 +59,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>
@@ -73,6 +80,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:
@@ -137,7 +153,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.
@@ -190,7 +206,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>
        
@@ -203,7 +219,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>
@@ -227,7 +243,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>