+INSTALLATION OF EVENT PECL EXTENSION
+Tested under GNU/Linux only. But likely will work on others too. The following
+also concerns GNU/Linux. If you find it useful to publish instructions for
+other platforms, please drop me a note.
+Event extension supports `libevent 2.0` or greater. It expects at least
+<libevent_core.so> library to be installed. For extra functions
+<libevent_extra.so>) is required. However, since `libevent 2.0` both should
+come with the libevent distribution.
+Note that <libevent.so> exists for historical reasons. Currently it contains
+the contents of both <libevent_core.so> and <libevent_extra.so>. But using
+<libevent.so> is not reliable as it may go away in future releases.
+Most OS distributions have `libevent` package in their repositories:
+*Debian*, *Ubuntu* and similar:
+ # apt-get install libevent-dev
+ # emerge dev-libs/libevent
+ (`ssl` USE-flag may be needed)
+In a pinch the source code is always available on `libevent`'s homepage:
+Just run the following as `root`:
+ # pecl install package.xml
+Clone the project or download it as archive. In the package directory run:
+ $ ./configure --with-event-core --with-event-extra --enable-event-debug
+In <php.ini>, or some other configuration like
+Event is a PECL extension providing interface to `libevent` C library.
+The `libevent` API provides a mechanism to execute a callback function when a
+specific event occurs on a file descriptor or after a timeout has been reached.
+Furthermore, libevent also support callbacks due to *signals* or regular
+`libevent` is meant to replace the event loop found in event driven network
+servers. An application just needs to call `event_dispatch()` and then add or
+remove events dynamically without having to change the event loop.
+For details refer to `libevent`'s homepage: <http://libevent.org/>.
+For installation instructions see file named <INSTALL.md>.
+Ruslan Osmanov <firstname.lastname@example.org>
+ Copyright (c) 2013 Ruslan Osmanov <email@example.com>
+ This project is subject to version 3.01 of the PHP license, that is bundled
+ with this package in the file LICENSE, and is available through the
+ world-wide-web at the following url: http://www.php.net/license/3_01.txt If you
+ did not receive a copy of the PHP license and are unable to obtain it through
+ the world-wide-web, please send a note to firstname.lastname@example.org so we can mail you a
+vim: ft=markdown ts=4 sts=4 sw=4