X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=33c0e491ac4a4b119f65a0223a1a34c67d1ffea6;hb=2bf08e725ba16cfa16df8d03468891c57c1670b8;hp=02d6c9814dc8dabc2d2cbc60d2d9c0ba5c64dc6a;hpb=1e5554fc59c8cad2105b2a8cf095d13315dc6ed1;p=yaz-moved-to-github.git

diff --git a/doc/installation.xml b/doc/installation.xml
index 02d6c98..33c0e49 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,4 +1,4 @@
-<!-- $Id: installation.xml,v 1.16 2003-03-18 13:30:21 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.20 2003-11-19 22:05:15 adam Exp $ -->
  <chapter id="installation"><title>Compilation and Installation</title>
   
   <sect1><title>Introduction</title>
@@ -20,21 +20,23 @@
     <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>
    
@@ -248,56 +250,77 @@
     <para>
      The following files are generated by the make process:
      <variablelist>
-      <varlistentry><term><filename>lib/libyaz.la</filename></term>
+      <varlistentry><term><filename>src/libyaz.la</filename></term>
        <listitem><para>
          Main &yaz; library. This is no ordinary library. It's
          a Libtool archive.
          By default, &yaz; creates a static library in 
          <filename>lib/.libs/libyaz.a</filename>.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
-      <varlistentry><term><filename>lib/libyazthread.la</filename></term>
+      <varlistentry><term><filename>src/libyazthread.la</filename></term>
        <listitem><para>
          When threading is supported/enabled by configure this Libtool
          library is created. It includes functions that allows &yaz;
          to use threads.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
       <varlistentry><term><filename>ztest/yaz-ztest</filename></term>
        <listitem><para>Test Z39.50 server. 
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
       <varlistentry><term><filename>client/yaz-client</filename></term>
        <listitem><para>Z39.50 client for testing the protocol.
          See chapter <link linkend="client">
           YAZ client</link> for more information.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
-      <varlistentry><term><filename>yaz-config</filename></term>
+      <varlistentry><term><filename>util/yaz-config</filename></term>
        <listitem><para>A Bourne-shell script, generated by configure, that
          specifies how external applications should compile - and link with
          &yaz;.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
-      <varlistentry><term><filename>yaz-comp</filename></term>
+      <varlistentry><term><filename>util/yaz-asncomp</filename></term>
        <listitem><para>The ASN.1 compiler for &yaz;. Requires the
          Tcl Shell, <application>tclsh</application>, in
          <literal>PATH</literal> to operate.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
+      
+      <varlistentry><term><filename>util/yaz-iconv</filename></term>
+       <listitem><para>This program converts data in one character set to
+	 another. This command exercises the YAZ character set
+	 conversion API.
+        </para></listitem>
+      </varlistentry>
+       
+      <varlistentry><term><filename>util/yaz-marcdump</filename></term>
+       <listitem><para>This program parses ISO2709 encoded MARC records
+	 and prints them in line-format or XML.
+        </para></listitem>
+      </varlistentry>
       
-      <varlistentry><term><filename>zoom/zoomsh</filename></term>
+     <varlistentry><term><filename>zoom/zoomsh</filename></term>
        <listitem><para>
          A simple shell implemented on top of the 
          <link linkend="zoom">ZOOM</link> functions.
          The shell is a command line application that allows you to enter
          simple commands to perform ZOOM operations.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
       
       <varlistentry><term><filename>zoom/zoomtst1</filename>, 
         <filename>zoom/zoomtst2</filename>, ..</term>
        <listitem><para>
          Several small applications that demonstrates the ZOOM API.
-        </para></listitem></varlistentry>
+        </para></listitem>
+      </varlistentry>
      </variablelist>
      
     </para>
@@ -458,6 +481,22 @@
       </varlistentry>
 
       <varlistentry>
+       <term><literal>HAVE_BISON</literal>,
+        <literal>BISON</literal></term>
+       <listitem><para>
+         If GNU Bison is present, you might set <literal>HAVE_ICONV</literal>
+         to 1 and specify the Bison executable in <literal>BISON</literal>.
+         Bison is only required if you use the CVS version of
+         YAZ or if you modify the grammar for CQL
+         (<filename>cql.y</filename>).
+        </para>
+        <para>
+         GNU Bison for Windows is part of 
+         <ulink url="http://unxutils.sourceforge.net/">unxutils</ulink>.
+        </para></listitem>
+      </varlistentry>
+
+      <varlistentry>
        <term><literal>HAVE_ICONV</literal>,
         <literal>ICONV_DIR</literal></term>
        <listitem><para>
@@ -466,7 +505,7 @@
          <literal>ICONV_DIR</literal> to the iconv source directory.
         </para></listitem>
       </varlistentry>
-
+      
       <varlistentry>
        <term><literal>HAVE_LIBXML2</literal>,
         <literal>LIBXML2_DIR</literal></term>
@@ -479,7 +518,7 @@
         </para>
 
         <para>
-         You can get libxml2 and iconv binaries from
+         Windows versions of libxml2 and iconv can be found
          <ulink url="http://www.zlatkovic.com/projects/libxml/binaries.html">
           here</ulink>.
         </para>