appeasement

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/narr/install.rst b/docs/narr/install.rst
index e8482a289..32f331550 100644
--- a/docs/narr/install.rst
+++ b/docs/narr/install.rst
@@ -243,6 +243,17 @@ Once you've got setuptools or distribute installed, you should install the
 :term:`virtualenv` package.  To install the :term:`virtualenv` package into
 your setuptools-enabled Python interpreter, use the ``easy_install`` command.
 
+.. warning::
+
+   Even though Python 3.3 and better comes with ``pyvenv`` out of the box,
+   which is similar to ``virtualenv``, we suggest using ``virtualenv`` instead.
+   ``virtualenv`` works on well Python 3.3.  This isn't a recommendation made
+   for technical reasons, it's one made because it's not possible for the
+   authors of this guide to explain setup using multiple virtual environment
+   systems.  ``pyenv`` will work fine.  However, if you use ``pyvenv`` instead,
+   you'll need to understand how to install software such as ``distribute``
+   into the virtual environment manually, which this guide does not cover.
+
 .. code-block:: text
 
    $ easy_install virtualenv