From 0164f8c66acc5fa7f1d41deee65de39adf20e1cc Mon Sep 17 00:00:00 2001
From: Friedhelm Betz <betz@php.net>
Date: Thu, 26 Sep 2002 21:47:41 +0000
Subject: [PATCH] be a little bit more verbose and explicit about the
 installation of c-client library

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@97060 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/imap/reference.xml | 67 +++++++++++++++++++++++++++---------
 1 file changed, 50 insertions(+), 17 deletions(-)

diff --git a/reference/imap/reference.xml b/reference/imap/reference.xml
index 0c21b064ed..b80ec66029 100644
--- a/reference/imap/reference.xml
+++ b/reference/imap/reference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
  <reference id='ref.imap'>
   <title>IMAP, POP3 and NNTP functions</title>
   <titleabbrev>IMAP</titleabbrev>
@@ -18,29 +18,62 @@
    <section id="imap.requirements">
     &reftitle.required;
     <para>
-    This extension requires the c-client library to be installed.
-    Grab the latest version from <ulink url="&url.imap;">&url.imap;</ulink>
-    and compile it.
+     This extension requires the c-client library to be installed.
+     Grab the latest version from <ulink url="&url.imap;">&url.imap;</ulink>
+     and compile it.
     </para>
+    <para>
+     You have to copy some files to make sure they are in your link path
+     (e.g.: <filename>/usr/local/lib/</filename>) and include directory
+     (e.g.: <filename>/usr/local/include</filename>).
+     The files to copy can be found in the source tree
+     under <filename>imap-200x/c-lient</filename> after a succesfull run of
+     <command>make</command>. Copy <filename>c-client.a</filename>
+     to <filename>/usr/local/lib/libc-client.a</filename> or some other
+     directory on your <emphasis>link path</emphasis>.
+    </para>
+    <note>
+     <para>
+      Make sure <filename>c-client.a</filename> ends up in your link path
+      under the name <filename>libc-client.a</filename>.
+     </para>
+    </note>
+    <para>
+     Copy the following files to <filename>/usr/local/include</filename> or some
+     other directory in your <emphasis>include path</emphasis>.
+     <simplelist>
+      <member><filename>c-client.h</filename></member>
+      <member><filename>imap4r1.h</filename></member>
+      <member><filename>rfc822.h</filename></member>
+      <member><filename>mail.h</filename></member>
+      <member><filename>linkage.h</filename></member>
+      <member><filename>env.h</filename></member>
+      <member><filename>env_unix.h</filename></member>
+      <member><filename>fs.h</filename></member>
+      <member><filename>ftl.h</filename></member>
+      <member><filename>misc.h</filename></member>
+      <member><filename>nntp.h</filename></member>
+      <member><filename>nl.h</filename></member>
+      <member><filename>osdep.h</filename></member>
+      <member><filename>smtp.h</filename></member>
+      <member><filename>tcp.h</filename></member>
+     </simplelist>
+    </para>
+    <note>
+     <para>
+      The name of <filename>env_unix.h</filename> depends on your OS.
+      Make sure to copy this files with following symlinks option.
+      To build the c-client library with SSL or/and Kerberos support read
+      the docs supplied with the package.
+     </para>
+    </note>
    </section>
 
    <section id="imap.installation">
     &reftitle.install;
     <para>
      To get these functions to work, you have to compile PHP with
-     <option role="configure">--with-imap</option>. 
-    </para>
-    <para>
-     Then copy <filename>c-client/c-client.a</filename> to
-     <filename>/usr/local/lib/libc-client.a</filename> or some other 
-     directory on your link path and copy
-     <filename>c-client/c-client.h</filename>,
-     <filename>c-client/imap4r1.h</filename>,
-     <filename>c-client/rfc-882.h</filename>,
-     <filename>c-client/mail.h</filename> and
-     <filename>c-client/linkage.h</filename>
-     to <filename>/usr/local/include</filename> or some other directory in
-     your include path.
+     <option role="configure">--with-imap</option>.
     </para>
     <note>
      <simpara>