Fix year
[idzebra-moved-to-github.git] / doc / installation.xml
index 9b0f697..c3f04b4 100644 (file)
@@ -1,9 +1,12 @@
-<!-- $Id: installation.xml,v 1.12 2003-03-31 20:48:12 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.19 2006-04-25 12:26:26 marc Exp $ -->
  <chapter id="installation">
   <title>Installation</title>
   <para>
    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.
+   We primarily use <ulink url="http://gcc.gnu.org/">GCC</ulink> on UNIX and 
+   <ulink url="http://msdn.microsoft.com/vstudio/">
+    Microsoft Visual C++</ulink>
+   on Windows.
   </para>
 
   <para>
    <ulink url="http://www.redhat.com/">Redhat Linux</ulink>,
    <ulink url="http://www.gentoo.org/">Gentoo Linux</ulink>,
    <ulink url="http://www.suse.com/">SuSE 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>.
+   <ulink url="http://www.sun.com/software/solaris/">SunOS 5.8
+    (sparc)</ulink>,
+   <ulink url="http://www.microsoft.com/windows2000/">Windows 2000</ulink>.
   </para>
   
   <para>
@@ -29,7 +32,7 @@
       (required)</term>
      <listitem>
       <para>
-       Zebra uses YAZ to support Z39.50/SRW. Also the memory management
+       Zebra uses YAZ to support Z39.50/ <ulink url="http://www.loc.gov/standards/sru/srw/">SRW</ulink>. Also the memory management
        utilites from YAZ is used by Zebra.
       </para>
      </listitem>
     to configure.
    </para>
   </sect1>
+
+  <sect1 id="installation.debian"><title>GNU/Debian</title>
+   <sect2 id="installation.debianlinux"><title>GNU/Debian Linux</title>
+    <para>
+     Index Data provides pre-compiled <literal>GNU/Debian
+      Linux</literal> packages at our Debian package archive, both for
+     the <literal>Sarge</literal> and the <literal>Etch</literal> release. 
+    </para>
+    
+    <para>
+     To install these packages, you need to add two lines to your
+     <literal>/etc/apt/sources.list</literal> configuration file,
+     either the <literal>Sarge</literal> sources found at
+     <screen>
+      deb http://www.indexdata.dk/debian indexdata/sarge released
+      deb-src http://www.indexdata.dk/debian indexdata/sarge released
+     </screen>
+     or the <literal>Etch</literal> sources from 
+     <screen>
+      deb http://www.indexdata.dk/debian indexdata/etch released
+      deb-src http://www.indexdata.dk/debian indexdata/etch released
+     </screen>
+     After refreshing the package cache with the command
+     <screen>
+      apt-get update
+     </screen>
+     as <literal>root</literal>, the 
+     <ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
+     easily installed issuing
+     <screen>
+      apt-get install idzebra idzebra-doc
+     </screen>
+    </para>
+   </sect2>
+   
+   <sect2 id="installation.debianother">
+    <title>GNU/Debian On Other Platforms</title>
+    <para>
+     These <ulink url="http://indexdata.dk/zebra/">Zebra</ulink>
+     packages are specifically compiled for
+     <literal>GNU/Debian Linux</literal> systems. Installation on other 
+     <literal>GNU/Debian</literal> systems is possible by
+     re-compilation the Debian way: you need to add only the 
+     <literal>deb-src</literal> sources lines to the 
+     <literal>/etc/apt/sources.list</literal> configuration file,
+     that is either the <literal>Sarge</literal> sources
+     <screen>
+      deb-src http://www.indexdata.dk/debian indexdata/sarge released
+     </screen>
+     or the <literal>Etch</literal> sources
+     <screen>
+      deb-src http://www.indexdata.dk/debian indexdata/etch released
+     </screen>
+     After refreshing the package cache with the command
+     <screen>
+      apt-get update
+     </screen>
+     as <literal>root</literal>, the 
+     <ulink url="http://indexdata.dk/zebra/">Zebra</ulink> indexer is
+     recompiled and installed issuing
+     <screen>
+      apt-get build-dep idzebra
+      apt-get source --compile idzebra
+     </screen>
+     as normal user.
+     The compiled <literal>GNU/Debian</literal> packages can then be
+     installed as <literal>root</literal> issuing
+     <screen>
+      dpkg -i install idzebra*.deb idzebra-doc*.deb
+     </screen>
+    </para>
+   </sect2>
+  </sect1>
+
   <sect1 id="installation.win32"><title>WIN32</title>
    <para>The easiest way to install Zebra on Windows is by downloading
     an installer from 
        <literal>EXPAT_DIR</literal></term>
       <listitem><para>
         If <literal>HAVE_EXPAT</literal> is set to 1, Zebra is compiled
-        with Expat support. In this configuration, set 
-        <literal>ZEBRA_DIR</literal> to the Expat source directory.
+        with <ulink url="http://expat.sourceforge.net/">Expat</ulink> support. In this configuration, set 
+        <literal>ZEBRA_DIR</literal> to the <ulink url="http://expat.sourceforge.net/">Expat</ulink> source directory.
+       Windows version of Expat can be downloaded from
+       <ulink url="http://sourceforge.net/projects/expat/">
+        SourceForge
+       </ulink>.
        </para></listitem>
      </varlistentry>
      
         If <literal>HAVE_ICONV</literal> is set to 1, Zebra is compiled
         with iconv support. In this configuration, set 
         <literal>ICONV_DIR</literal> to the iconv source directory.
-        
-        iconv binaries can be downloaded from
+        Iconv binaries can be downloaded from
         <ulink url="http://www.zlatkovic.com/projects/libxml/binaries.html">
-         this site</ulink>.
-        </para>
+         this site
+       </ulink>.
+       </para>
       </listitem>
      </varlistentry>
-
+     
      <varlistentry>
       <term><literal>BZIP2INCLUDE</literal>,
        <literal>BZIP2LIB</literal>,
       </term>
       <listitem><para>
         Define these symbols if Zebra is to be compiled with
-        BZIP2 record compression support.
+       <ulink url="http://sources.redhat.com/bzip2/">BZIP2</ulink>
+       record compression support.
        </para></listitem>
      </varlistentry>
      
     
    </para>
   </sect1>
+
+  
  </chapter>
  <!-- Keep this comment at the end of the file
  Local variables: