summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/install.rst11
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