Make ztest_explain non-static
[yaz-moved-to-github.git] / doc / installation.xml
index 7f55b56..8ea4d78 100644 (file)
@@ -1,4 +1,4 @@
-<!-- $Id: installation.xml,v 1.19 2003-11-19 21:17:26 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.26 2004-08-19 07:48:00 adam Exp $ -->
  <chapter id="installation"><title>Compilation and Installation</title>
   
   <sect1><title>Introduction</title>
     <ulink url="http://www.debian.org/">Debian GNU/Linux</ulink>,
     <ulink url="http://www.redhat.com/">Redhat Linux</ulink>,
     <ulink url="http://www.gentoo.org/">Gentoo Linux</ulink>,
-    <ulink url="http://www.netbsd.org/Ports/cobalt/">
-     NetBSD (Cobalt MIPS)</ulink>,
     <ulink url="http://www.freebsd.org/">FreeBSD (i386)</ulink>,
     <ulink url="http://www.apple.com/macosx/">MAC OSX</ulink>,
     <ulink url="http://wwws.sun.com/software/solaris/">
      SunOS 5.8 (sparc)</ulink>,
     <ulink url="http://www.microsoft.com/windows2000/">
-     Windows 2000 SP3</ulink>.
+     Windows 2000</ulink>.
    </para>
    
    <para>
     Some versions have be known to work on HP/UX,
-    DEC Unix, OpenBSD, IBM AIX, Data General DG/UX (with some CFLAGS tinkering),
+    DEC Unix, <ulink url="http://www.netbsd.org/">NetBSD</ulink>,
+    <ulink url="http://www.openbsd.org/">OpenBSD</ulink>,
+    IBM AIX,
+    Data General DG/UX (with some CFLAGS tinkering),
     SGI/IRIX, DDE Supermax, Apple Macintosh (using the Codewarrior programming
-    environment and the GUSI socket libraries), IBM AS/400 .
+    environment and the GUSI socket libraries),
+    IBM AS/400 .
    </para>
 
    <para>
@@ -69,7 +71,7 @@
     and 
     <ulink url="http://www.redhat.com/">Redhat</ulink> packages for &yaz;. 
     Only i386 binary packages are available. You should be able to
-    create packages for other CPU's by building them from the source
+    create packages for other CPUs by building them from the source
     package.
    </para>
    
@@ -92,7 +94,7 @@
 
     <para>
      The XML C library <ulink url="http://www.xmlsoft.org/">libxml2</ulink>
-     is required if &yaz; is to support SRW (and SOAP).
+     is required if &yaz; is to support SRW and SRU.
      This library is very portable and should compile out-of-the
      box on virtually all Unix platforms. It is available in binary
      forms for Linux and others.
     <para>
      &yaz; is shipped with "makefiles" for the NMAKE tool that comes
      with <ulink url="http://msdn.microsoft.com/vstudio/">
-      Microsoft Visual C++</ulink>.
-     Version 6 has been tested. We expect that &yaz; compiles
+      Microsoft Visual Studio</ulink>.
+     Version 6 and .NET has been tested. We expect that &yaz; compiles
      with version 5 as well.
     </para>
     <para>
          (<filename>cql.y</filename>).
         </para>
         <para>
-         GNU Bison for Windows is part of 
+         A Windows version of GNU Bison is part of 
          <ulink url="http://unxutils.sourceforge.net/">unxutils</ulink>.
         </para></listitem>
       </varlistentry>
        <listitem>
         <para>
          If <literal>HAVE_LIBXML2</literal> is set to 1, YAZ is compiled
-         with SRW (and SOAP) support. In this configuration, set 
+         with SRW and SRU support. In this configuration, set 
          <literal>LIBXML2_DIR</literal> to the 
-         <ulink url="http://www.xmlsoft.org/">libxml2</ulink> source directory.
+         <ulink url="http://www.xmlsoft.org/">libxml2</ulink> source directory
+        and
+        <literal>ZLIB_DIR</literal> to the zlib directory.
         </para>
 
         <para>
-         Windows versions of libxml2 and iconv can be found
-         <ulink url="http://www.zlatkovic.com/projects/libxml/binaries.html">
-          here</ulink>.
+         Windows versions of libxml2, zlib and iconv can be found
+        <ulink url="http://www.zlatkovic.com/libxml.en.html">
+         Igor Zlatkovi&#x0107;' site</ulink>.
         </para>
+
+       <note>
+        <para>
+         YAZ is not using ZLIB. But libxml2 is.
+        </para>
+       </note>
        </listitem>
       </varlistentry>
 
      <variablelist>
       <varlistentry><term><filename>bin/yaz.dll</filename></term>
        <listitem><para>
-         &yaz; multi-threaded Dynamic Link Library.
+         &yaz; release mode multi-threaded Dynamic Link Library.
         </para></listitem></varlistentry>
       
       <varlistentry><term><filename>lib/yaz.lib</filename></term>
          Import library for <filename>yaz.dll</filename>.
         </para></listitem></varlistentry>
       
+      <varlistentry><term><filename>bin/yazd.dll</filename></term>
+       <listitem><para>
+         &yaz; debug mode multi-threaded Dynamic Link Library.
+        </para></listitem></varlistentry>
+      
+      <varlistentry><term><filename>lib/yazd.lib</filename></term>
+       <listitem><para>
+         Import library for <filename>yazd.dll</filename>.
+        </para></listitem></varlistentry>
+      
       <varlistentry><term><filename>bin/yaz-client.exe</filename></term>
        <listitem><para>
          &yaz; Z39.50 client application. It's a WIN32 console application.
        </term><listitem><para>
          You must link with this library. It's located in the 
          sub directory <filename>lib</filename> of &yaz;.
+        If you want to link with the debug version of &yaz;, you must
+        link with <filename>yazd.dll</filename> instead.
         </para></listitem></varlistentry>
       <varlistentry><term>dynamic link library <filename>yaz.dll</filename>
        </term><listitem><para>