From d2561ae6813e8c3cb4841edb12fa8391d45ba602 Mon Sep 17 00:00:00 2001
From: "Paul J. Davis"
Date: Tue, 11 May 2010 17:30:51 -0400
Subject: [PATCH] Fixed a snafu in the installation instructions.
libev != libevent.
Also added a note about getting the most recent greenlets module.
---
doc/htdocs/installation.html | 15 +++++++++++----
doc/site/installation.rst | 21 ++++++++++++++-------
2 files changed, 25 insertions(+), 11 deletions(-)
diff --git a/doc/htdocs/installation.html b/doc/htdocs/installation.html
index fcacef43..e6313d33 100644
--- a/doc/htdocs/installation.html
+++ b/doc/htdocs/installation.html
@@ -105,13 +105,20 @@ request processing. Check out the
want to consider one of the alternate worker types.
To install eventlet:
-$ easy_install -U eventlet
+$ easy_install -U greenlet # Required for both
+$ easy_install -U eventlet # For eventlet workers
+$ easy_install -U gevent # For gevent workers
-Replace eventlet with gevent to use to the gevent based workers.
Note
-
If you encounter errors when compiling the extensions for Eventlet or
-Gevent you most likely need to install a newer version of libev.
+
If installing greenlet fails you probably need to install
+the Python headers. These headers are available in most package
+managers. On Ubuntu the package name for apt-get is
+python-dev.
+
Gevent also requires that libevent 1.4.x or 2.0.4 is installed.
+This could be a more recent version than what is available in your
+package manager. If Gevent fails to build even with libevent
+installed, this is the most likely reason.
diff --git a/doc/site/installation.rst b/doc/site/installation.rst
index 548375a8..8cc7b178 100644
--- a/doc/site/installation.rst
+++ b/doc/site/installation.rst
@@ -63,14 +63,21 @@ want to consider one of the alternate worker types.
To install eventlet::
- $ easy_install -U eventlet
-
-Replace ``eventlet`` with ``gevent`` to use to the ``gevent`` based workers.
+ $ easy_install -U greenlet # Required for both
+ $ easy_install -U eventlet # For eventlet workers
+ $ easy_install -U gevent # For gevent workers
.. note::
- If you encounter errors when compiling the extensions for Eventlet_ or
- Gevent_ you most likely need to install a newer version of libev_.
-
+ If installing ``greenlet`` fails you probably need to install
+ the Python headers. These headers are available in most package
+ managers. On Ubuntu the package name for ``apt-get`` is
+ ``python-dev``.
+
+ Gevent_ also requires that ``libevent`` 1.4.x or 2.0.4 is installed.
+ This could be a more recent version than what is available in your
+ package manager. If Gevent_ fails to build even with ``libevent``
+ installed, this is the most likely reason.
+
Installing on Ubuntu/Debian systems
-----------------------------------
@@ -99,4 +106,4 @@ Fingerprint::
.. _Gevent: http://gevent.org
.. _libev: http://software.schmorp.de/pkg/libev.html
.. _Ubuntu: http://www.ubuntu.com/
-.. _PPA: https://launchpad.net/~bchesneau/+archive/gunicorn
\ No newline at end of file
+.. _PPA: https://launchpad.net/~bchesneau/+archive/gunicorn