Added id attributes for section tags
[yaz-moved-to-github.git] / doc / installation.xml
index 761964c..51ed70b 100644 (file)
@@ -1,7 +1,7 @@
-<!-- $Id: installation.xml,v 1.28 2006-04-24 12:41:00 marc Exp $ -->
+<!-- $Id: installation.xml,v 1.33 2006-09-06 09:27:16 adam Exp $ -->
  <chapter id="installation"><title>Compilation and Installation</title>
   
-  <sect1><title>Introduction</title>
+  <sect1 id="installation-introduction"><title>Introduction</title>
    <para>
     The latest version of the software will generally be found at:
    </para>
     <ulink url="&url.freebsd;">FreeBSD (i386)</ulink>,
     <ulink url="&url.macosx;">MAC OSX</ulink>,
     <ulink url="&url.solaris;">SunOS 5.8 (sparc)</ulink>,
-    <ulink url="&url.windows2000;">,
-     Windows 2000</ulink>,
-    <ulink url="&url.windows2003server;">,
-     Windows 2003 server</ulink>.
+    <ulink url="&url.windows2000;">Windows 2000</ulink>,
+    <ulink url="&url.windows2003server;">Windows 2003 server</ulink>.
    </para>
    
    <para>
     </para>
 
     <para>
-     The XML C library <ulink url="&url.libxml2;">libxml2</ulink>
-     is required if &yaz; is to support SRW and SRU.
-     This library is very portable and should compile out-of-the
+     The <ulink url="&url.libxslt;">libxslt</ulink>,
+     <ulink url="&url.libxml2;">libxml2</ulink> librararies are required
+     if &yaz; is to support SRU.
+     These libraries are 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>
         </para></listitem>
       </varlistentry>
 
-      <varlistentry><term><literal>--enable-shared</literal></term>
-       <listitem><para>The make process will create shared
+      <varlistentry><term><literal>--disable-shared</literal></term>
+       <listitem><para>The make process will not create shared
          libraries (also known as shared objects <filename>.so</filename>).
-         By default, no shared libraries are created -
-         equivalent to <literal>--disable-shared</literal>.
+         By default, shared libraries are created -
+         equivalent to <literal>--enable-shared</literal>.
         </para></listitem>
       </varlistentry>
 
        </term>
        <listitem><para>Compile &yaz; with iconv library in directory
          <replaceable>prefix</replaceable>. By default configure will
-         search for iconv on your system. Use this option if it
-         doesn't find iconv. Alternatively you can use 
-         <literal>--without-iconv</literal> to force &yaz; not to use
-         iconv.
+         search for iconv on the system. Use this option if it
+         doesn't find iconv. Alternatively, 
+         <literal>--without-iconv</literal>, can be uset to force &yaz;
+        not to use iconv.
         </para></listitem>
       </varlistentry>
 
       <varlistentry><term>
-        <literal>--with-xml2</literal>[=<replaceable>prefix</replaceable>]
+        <literal>--with-xslt</literal>[=<replaceable>prefix</replaceable>]
        </term>
        <listitem><para>Compile &yaz; with 
-         <ulink url="&url.libxml2;">libxml2</ulink> in directory
+         <ulink url="&url.libxslt;">libxslt</ulink> in directory
          <replaceable>prefix</replaceable>. 
-         Use this option if you want SOAP support.
-         By default configure will
-         search for libxml2 on your system. Use this option if it
-         doesn't find libxml2. Alternatively you can use 
-         <literal>--without-xml2</literal> to force &yaz; not to use
-         libxml2.
+         Use this option if you want SRU support.
+         By default, configure will
+         search for libxslt on the system. Use this option if it
+         libxslt is not found automatically. Alternatively, 
+         <literal>--without-xslt</literal>, can be used to force &yaz;
+        not to use libxslt.
         </para></listitem>
       </varlistentry>
 
     </para>
    </sect2>
 
-   <sect2><title>How to make apps using YAZ on UNIX</title>
+   <sect2 id="installation-linking-yaz-unix">
+    <title>How to make apps using YAZ on UNIX</title>
     <para>
      This section describes how to compile - and link your own
      applications using the &yaz; toolkit.
        <listitem>
         <para>
          If <literal>HAVE_LIBXML2</literal> is set to 1, YAZ is compiled
-         with SRW and SRU support. In this configuration, set 
+         with SRU support. In this configuration, set 
          <literal>LIBXML2_DIR</literal> to the 
          <ulink url="&url.libxml2;">libxml2</ulink> source directory
         and
         </para>
 
         <para>
-         Windows versions of libxml2, zlib and iconv can be found
+         Windows versions of libxslt, libxml2, zlib and iconv can be found
         <ulink url="&url.libxml2.download.win32;">
          Igor Zlatkovi&#x0107;' site</ulink>.
         </para>
 
        <note>
         <para>
-         YAZ is not using ZLIB. But libxml2 is.
+         YAZ is not using zlib but libxml2 is depending on it.
         </para>
        </note>
        </listitem>
       </varlistentry>
 
+      <varlistentry>
+       <term><literal>HAVE_LIBXSLT</literal>,
+        <literal>LIBXSLT_DIR</literal></term>
+       <listitem>
+        <para>
+         If <literal>HAVE_LIBXSLT</literal> is set to 1, YAZ is compiled
+         with XSLT support. In this configuration, set 
+         <literal>LIBXSLT_DIR</literal> to the 
+         <ulink url="&url.libxslt;">libxslt</ulink> source directory.
+        </para>
+
+       <note>
+        <para>
+         libxslt depends libxml2.
+        </para>
+       </note>
+       </listitem>
+
+      </varlistentry>
+
      </variablelist>
     </para>
     <para>
     </para>
    </sect2>
 
-   <sect2><title>How to make apps using YAZ on WIN32</title>
+   <sect2 id="installation-linking-yaz-win32">
+    <title>How to make apps using YAZ on WIN32</title>
     <para>
      This section will go though the process of linking your WIN32
      applications with &yaz;.
   </sect1>
  </chapter>
  
- <!-- Keep this Emacs mode comment at the end of the file
-Local variables:
-mode: nxml
-End:
--->
-
+ <!-- Keep this comment at the end of the file
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ sgml-parent-document: "yaz.xml"
+ sgml-local-catalogs: nil
+ sgml-namecase-general:t
+ End:
+ -->