From c6ca316009dab4f365b7c01657c5e32a3728bce3 Mon Sep 17 00:00:00 2001
From: Ruslan Osmanov <osmanov@php.net>
Date: Wed, 19 Oct 2011 15:46:05 +0000
Subject: [PATCH] Fix: installation instructions link Add: installation
 instructions for Gentoo

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@318225 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/eio/configure.xml | 63 +++++++++++++++++++++++++++++++++++--
 reference/eio/setup.xml     |  5 +--
 2 files changed, 64 insertions(+), 4 deletions(-)

diff --git a/reference/eio/configure.xml b/reference/eio/configure.xml
index f4037bd865..f652c83d64 100644
--- a/reference/eio/configure.xml
+++ b/reference/eio/configure.xml
@@ -17,7 +17,7 @@
  </para>
 
  <para><option role="configure">--with-eio-shm-prm</option>
- option sets shared memory segment permissions. Default: 0600
+ option sets shared memory segment permissions. Default: 0660
  </para>
 
  <para>
@@ -30,9 +30,68 @@
  </para>
 
  <warning><simpara>Be sure that you gave read
- and write permissions for the Web server user or group(according to the file
+ and write permissions for the Web server user/group(according to the file
    system setup). Otherwise, the internal event loop will fail.</simpara></warning>
 
+
+ <para>On <emphasis>Gentoo</emphasis> you may experience problems
+ compiling(<emphasis>`make`</emphasis>) the code. If so, you've likely got output 
+ similar to the following:
+<screen>
+ <![CDATA[
+$ make 
+/bin/sh /home/ruslan/projects/pecl/svn/eio/libtool --mode=compile cc -Wall -g
+-ggdb -O0 -DEIO_DEBUG -I. -I/home/ruslan/projects/pecl/svn/eio -DPHP_ATOM_INC
+-I/home/ruslan/projects/pecl/svn/eio/include
+-I/home/ruslan/projects/pecl/svn/eio/main -I/home/ruslan/projects/pecl/svn/eio
+-I/usr/lib64/php5.3/include/php -I/usr/lib64/php5.3/include/php/main
+-I/usr/lib64/php5.3/include/php/TSRM -I/usr/lib64/php5.3/include/php/Zend
+-I/usr/lib64/php5.3/include/php/ext
+-I/usr/lib64/php5.3/include/php/ext/date/lib -I/usr/local/include
+-DHAVE_CONFIG_H  -Wall -g -ggdb -O0 -DEIO_DEBUG   -c
+/home/ruslan/projects/pecl/svn/eio/eio.c -o eio.lo 
+/home/ruslan/projects/pecl/svn/eio/libtool: line 481: CDPATH: command not
+found
+libtool: Version mismatch error.  This is libtool 2.4, but the
+libtool: definition of this LT_INIT comes from an older release.
+libtool: You should recreate aclocal.m4 with macros from libtool 2.4
+libtool: and run autoconf again.
+make: *** [eio.lo] Error 63
+ ]]>
+ </screen>
+
+The following fixes it:
+<screen>
+ <![CDATA[
+$ phpize --clean ; phpize
+$ aclocal 
+$ libtoolize --force 
+$ autoreconf
+$ ./configure --with-eio # further optional parameters ...
+$ make && make test
+$ su - 
+# make install
+ ]]>
+ </screen>
+ </para>
+
+ <note xmlns="http://docbook.org/ns/docbook">
+  <para>
+  Always check for actual <emphasis>configure</emphasis> parameters, since
+  documentation could be sometimes outdated. E.g.:
+<screen>
+ <![CDATA[
+ $ ./configure --help | grep eio 
+ --enable-eio-debug   Enable eio debug support
+ --with-eio           Include eio support
+ --with-eio-shm-key   eio shared memory segment key default /tmp/php-eio-shm
+ --with-eio-shm-prm   eio shared memory segment permissions default = 0660
+ ]]>
+ </screen>
+
+  </para>
+ </note>
+
 </section>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/eio/setup.xml b/reference/eio/setup.xml
index 8b5b09476e..8a7cac1272 100644
--- a/reference/eio/setup.xml
+++ b/reference/eio/setup.xml
@@ -25,13 +25,14 @@ $ make
  </section>
 
  <!--{{{ Installation -->
- <section xml:id="eio.installation">
+ <!--<section xml:id="eio.installation">
   &reftitle.install;
   <para>
    &pecl.info;
    <link xlink:href="&url.pecl.package;eio">&url.pecl.package;eio</link>.
   </para>
- </section>
+ </section>-->
+ &reference.eio.configure;
    <!--}}}-->
 
   <!--{{{ Configuration-->