Document a workaround for a gentoo-specific bug

Thanks to infectormp for reporting the bugs,
and testing the workaround.

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/source/installation.rst b/doc/source/installation.rst
index 3240b7a..74d5d4f 100644
--- a/doc/source/installation.rst
+++ b/doc/source/installation.rst
@@ -46,6 +46,33 @@ prefer:
 Be careful, on some distribution, there are separate configurations for
 cli/fmp/cgi/… be sure to edit the right one.
 
+If you're using `Gentoo <https://gentoo.org>`__, you might encounter the
+following error:
+
+::
+
+  $ make                                                                                                                                         
+  $ /bin/sh /root/snuffleupagus-0.5.0/src/libtool --mode=compile cc  -I. -I/root/snuffleupagus-0.5.0/src -DPHP_ATOM_INC -I/root/snuffleupagus-0.5.0/src/include -I/root/snuffleupagus-0.5.0/src/main -I/root/snuffleupagus-0.5.0/src -I/usr/lib64/php7.3/include/php -I/usr/lib64/php7.3/include/php/main -I/usr/lib64/php7.3/include/php/TSRM -I/usr/lib64/php7.3/include/php/Zend -I/usr/lib64/php7.3/include/php/ext -I/usr/lib64/php7.3/include/php/ext/date/lib  -DHAVE_CONFIG_H  -g -O2 -Wall -Wextra -Wno-unused-parameter -Wformat=2 -Wformat-security -D_FORTIFY_SOURCE=2 -fstack-protector   -c /root/snuffleupagus-0.5.0/src/snuffleupagus.c -o snuffleupagus.lo 
+  libtool: Version mismatch error.  This is libtool 2.4.6, 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.6
+  libtool: and run autoconf again.
+  make: *** [Makefile:193: snuffleupagus.lo] Error 63
+  $
+
+This is a `documented php bug <https://bugs.php.net/bug.php?id=58979>`__,
+solvable via:
+
+
+::
+
+  rm -f aclocal.m4
+  phpize
+  aclocal && libtoolize --force && autoreconf
+  ./configure --enable-snuffleupagus
+  make
+
+
 Upgrading
 ---------