Use proper tags for references to man pages
[yaz-moved-to-github.git] / doc / installation.xml
index 60f1aa9..4f89d4d 100644 (file)
@@ -1,4 +1,4 @@
-<!-- $Id: installation.xml,v 1.11 2002-05-22 11:19:20 adam Exp $ -->
+<!-- $Id: installation.xml,v 1.13 2002-09-17 20:17:44 adam Exp $ -->
  <chapter id="installation"><title>Compilation and Installation</title>
   
   <sect1><title>Introduction</title>
@@ -22,7 +22,8 @@
        <listitem><para>HP/UX</para></listitem>
        <listitem><para>SunOS/Solaris</para></listitem>
        <listitem><para>DEC Unix</para></listitem>
-       <listitem><para>OpenBSD/FreeBSD</para></listitem>
+       <listitem><para>BSDs: FreeBSD, OpenBSD, NetBSD, MAC OSX
+        </para></listitem>
        <listitem><para>Linux</para></listitem>
        <listitem><para>IBM AIX</para></listitem>
        <listitem><para>Data General DG/UX (with some CFLAGS tinkering)
@@ -34,7 +35,7 @@
       <itemizedlist>
        <listitem><para>Apple Macintosh (using the Codewarrior programming
          environment and the GUSI socket libraries)</para></listitem>
-       <listitem><para>MS Windows 95/98/NT/W2K (Win32)</para></listitem>
+       <listitem><para>MS Windows 95/98/NT/2K/XP (Win32)</para></listitem>
        <listitem><para>IBM AS/400</para></listitem>
       </itemizedlist></listitem>
     </itemizedlist>
@@ -45,8 +46,8 @@
     let us know about it. If you run into difficulties, we will try to help
     if we can, and if you solve the problems, we would be happy to include
     your fixes in the next release. So far, we have mostly avoided
-    &num;ifdefs for individual platforms, and we'd like to keep it that
-    way as far as it makes sense.
+    <literal>&num;ifdefs</literal> for individual platforms, and we'd
+    like to keep it that way as far as it makes sense.
    </para>
    
    <para>
@@ -54,7 +55,9 @@
     bug-fixes, as well as general discussion. Subscribe by sending mail to
     <ulink url="mailto:yaz-request@indexdata.dk">
      yaz-request@indexdata.dk
-    </ulink>.
+    </ulink> or fill-in the form
+    <ulink url="http://www.indexdata.dk/mailman/listinfo/yazlist">
+     here</ulink>.
     General questions and problems can be directed at 
     <ulink url="mailto:yaz-help@indexdata.dk">
      yaz-help@indexdata.dk
    <para>
     Note that if your system doesn't have a native ANSI C compiler, you may
     have to acquire one separately. We recommend
-    <ulink url="http://gcc.gnu.org">GCC</ulink>.
+    <ulink url="http://gcc.gnu.org/">GCC</ulink>.
    </para>
    <para>
     For UNIX, the GNU tools
     <ulink url="http://www.gnu.org/software/autoconf/">Autoconf</ulink>,
     <ulink url="http://www.gnu.org/software/automake/">Automake</ulink> and
     <ulink url="http://www.gnu.org/software/libtool/">Libtool</ulink>
-    is used to generate Makefiles and configure &yaz; for the system.
+    are used to generate Makefiles and configure &yaz; for the system.
     You do <emphasis>not</emphasis> these tools unless you're using the
     CVS version of &yaz;.
     Generally it should be sufficient to run configure without options,
          TCP wrapper library</ulink>. It allows you to allow/deny
         clients depending on IP number. The TCP wrapper library is
         often used in Linux/BSD distributions.
+        See
+        <citerefentry>
+         <refentrytitle>hosts_access</refentrytitle>
+         <manvolnum>5</manvolnum>
+        </citerefentry>
+        and 
+        <citerefentry>
+         <refentrytitle>tcpd</refentrytitle>
+         <manvolnum>8</manvolnum>
+        </citerefentry>.
        </para></listitem>
      </varlistentry>
      <varlistentry><term><literal>--enable-threads</literal></term>
     <screen>
      make
     </screen>
-    
    </para>
    
    <para>