philip Mon Jan 20 16:41:12 2003 EDT
Modified files:
/phpdoc/en/reference/imap reference.xml configure.xml
Log:
Update imap install docs as the current method will provide conflicts on some
setups. This closes some user comments and closes bug #17458
Index: phpdoc/en/reference/imap/reference.xml
diff -u phpdoc/en/reference/imap/reference.xml:1.10
phpdoc/en/reference/imap/reference.xml:1.11
--- phpdoc/en/reference/imap/reference.xml:1.10 Sat Nov 30 07:45:46 2002
+++ phpdoc/en/reference/imap/reference.xml Mon Jan 20 16:41:12 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
<reference id='ref.imap'>
<title>IMAP, POP3 and NNTP functions</title>
<titleabbrev>IMAP</titleabbrev>
@@ -23,46 +23,23 @@
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>.
+ It's important that you do not copy the IMAP source files directly into
+ the system include directory as there may be conflicts. Instead, create
+ a new directory inside the system include directory, such as
+ <filename>/usr/local/imap-2000b/</filename> (location and name
+ depend on your setup and IMAP version), and inside this new
+ directory create additional directories named <filename>lib/</filename>
+ and <filename>include/</filename>. From the <filename>c-client</filename>
+ directory from your IMAP source tree, copy all the <filename>*.h</filename>
+ files into <filename>include/</filename> and all the
+ <filename>*.c</filename> files into <filename>lib/</filename>.
+ Additionally when you compiled IMAP, a file named
+ <filename>c-client-a</filename> was created. Also put this in the
+ <filename>lib/</filename> directory but rename it as
+ <filename>libc-client.a</filename>.
</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>
@@ -145,14 +122,6 @@
by David Wood and <ulink url="&url.imap.book;">Managing
IMAP</ulink> by Dianna Mullet & Kevin Mullet.
</para>
- <warning>
- <para>
- Crashes and startup problems of <literal>PHP</literal> may be encountered
- when loading this extension in conjunction with the recode extension.
- See the <link linkend="ref.recode">recode</link> extension for more
- information.
- </para>
- </warning>
</section>
</partintro>
Index: phpdoc/en/reference/imap/configure.xml
diff -u phpdoc/en/reference/imap/configure.xml:1.3
phpdoc/en/reference/imap/configure.xml:1.4
--- phpdoc/en/reference/imap/configure.xml:1.3 Mon Jan 20 15:21:40 2003
+++ phpdoc/en/reference/imap/configure.xml Mon Jan 20 16:41:12 2003
@@ -1,11 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<section id="imap.installation">
&reftitle.install;
<para>
To get these functions to work, you have to compile PHP with
<option role="configure">--with-imap[=DIR]</option>, where DIR is the
- c-client install prefix.
+ c-client install prefix. From our example above, you would use
+ <literal>--with-imap=/usr/local/imap-2000b</literal>. This location
+ depends on where you created this directory according to the
+ description above.
</para>
<note>
<simpara>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
