Permalink
Browse files

Clarify reasons for preferring easy_install over pip.

  • Loading branch information...
1 parent a0e97ba commit 2292ae27dc0061f524a59a5e25b4578b0885d4b9 @tseaver tseaver committed Feb 17, 2014
Showing with 9 additions and 7 deletions.
  1. +9 −7 docs/quick_tutorial/requirements.rst
@@ -226,25 +226,27 @@ during this tutorial:
# Mac and Linux
$ $VENV/bin/easy_install nose webtest deform sqlalchemy \
pyramid_chameleon pyramid_debugtoolbar waitress \
- pyramid_jinja2 pyramid_tm zope.sqlalchemy
+ pyramid_tm zope.sqlalchemy
# Windows
c:\> %VENV%\Scripts\easy_install nose webtest deform sqlalchemy pyramid_chameleon
-
-
.. note::
Why ``easy_install`` and not ``pip``? Pyramid encourages use of namespace
- packages which, until recently, ``pip`` didn't permit. Also, Pyramid has
- some optional C extensions for performance. With ``easy_install``, Windows
- users can get these extensions without needing a C compiler.
+ packages, for which ``pip``'s support is less-than-optimal. Also, Pyramid's
+ dependencies use some optional C extensions for performance: with
+ ``easy_install``, Windows users can get these extensions without needing
+ a C compiler (``pip`` does not support installing binary Windows
+ distributions, except for ``wheels``, which are not yet available for
+ all dependencies).
.. seealso:: See also :ref:`installing_unix`. For instructions to set up your
Python environment for development using Windows or Python 2, see Pyramid's
:ref:`Before You Install <installing_chapter>`.
- See also Python 3's :mod:`venv module <python3:venv>`, the `setuptools` `installation instructions
+ See also Python 3's :mod:`venv module <python3:venv>`, the `setuptools
+ installation instructions
<https://pypi.python.org/pypi/setuptools/0.9.8#installation-instructions>`_,
and `easy_install help <https://pypi.python.org/pypi/setuptools/0.9.8#using-setuptools-and-easyinstall>`_.

0 comments on commit 2292ae2

Please sign in to comment.