Added standalone document, which describe MARC indexing process.

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

diff --git a/doc/installation.xml b/doc/installation.xml
index 021a610..cb06bbc 100644 (file)
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,20 +1,34 @@
-<!-- $Id: installation.xml,v 1.7 2003-03-04 23:30:20 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.10 2003-03-06 13:16:02 adam Exp $ -->
  <chapter id="installation">
   <title>Installation</title>
   <para>
-   Zebra is very portable. An ANSI C compiler is required. We
-   primarily use GNU C on UNIX and Microsoft Visual C++ on Windows.
+   Zebra is written in ANSI C and was implemented with portability in mind. 
+   We primarily use GCC on UNIX and Microsoft Visual C++ on Windows.
   </para>
 
   <para>
-   Zebra uses following components. Most of these are optional.
+   The software is regularly tested on
+   <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)</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>.
+  </para>
+  
+  <para>
+   Zebra can be configured to use the following utilities (most of
+   which are optional):
+
    <variablelist>
     <varlistentry>
      <term><ulink url="http://www.indexdata.dk/yaz/">yaz</ulink> (required)</term>
      <listitem>
       <para>
-       Zebra uses lots of utilities provided by YAZ. Most notably
-       Z39.50 support.
+       Zebra uses YAZ to support Z39.50/SRW. Also the memory management
+       utilites from YAZ is used by Zebra.
       </para>
      </listitem>
     </varlistentry>
@@ -35,12 +49,12 @@
      <listitem>
       <para>
        XML parser. If you're going to index real XML you should
-       install this (filter grs.xml). On most system, you should be able
+       install this (filter grs.xml). On most systems you should be able
        to find binary Expat packages.
       </para>
      </listitem>
     </varlistentry>
-
+    
     <varlistentry>
      <term><ulink url="http://www.perl.com/">Perl</ulink> (optional)</term>
      <listitem>
@@ -52,7 +66,7 @@
       </para>
      </listitem>
     </varlistentry>
-
+    
     <varlistentry>
      <term><ulink url="http://www.tcl.tk/">Tcl</ulink> (optional)</term>
      <listitem>
@@ -63,13 +77,12 @@
       </para>
      </listitem>
     </varlistentry>
-
+    
     <varlistentry>
      <term>
       <ulink url="http://www.gnu.org/software/autoconf/">Autoconf</ulink>,
-      <ulink url="
-      
- (optional)</term>
+      <ulink url="http://www.gnu.org/software/automake/">Automake</ulink>
+      (optional)</term>
      <listitem>
       <para>
        GNU Automake and Autoconf are only required if you're
@@ -80,11 +93,12 @@
     </varlistentry>
     
     <varlistentry>
-     <term>Docbook and friends (optional)</term>
+     <term><ulink url="http://docbook.org/">Docbook</ulink>
+      and friends (optional)</term>
      <listitem>
       <para>
        These tools are only required if you're writing
-       Documentation for Zebra. You need the following
+       documentation for Zebra. You need the following
        Debian packages: jadetex, docbook, docbook-dsssl,
        docbook-xml, docbook-utils.
       </para>
@@ -183,9 +197,9 @@
     to configure.
    </para>
   </sect1>
-  <sect1><title>WIN32</title>
+  <sect1 id="installation.win32"><title>WIN32</title>
    <para>
-    
+    [to be written]
    </para>
   </sect1>
  </chapter>