Why use venv/bin/pip instead of source bin/activate then pip? - Closes #2610

Steve Piercy

2016-09-25 dc73eae8e974878e516e444c192e28703f81c5b8

Why use venv/bin/pip instead of source bin/activate then pip?
- Closes #2610

(cherry picked from commit 21f2b61)

 docs/narr/install.rst

@@ -192,6 +192,24 @@

      $ $VENV/bin/pip install "pyramid==\ |release|\ "

.. index::
   single: $VENV/bin/pip vs. source bin/activate

.. _venv-bin-pip-vs-source-bin-activate:

.. note:: Why use ``$VENV/bin/pip`` instead of ``source bin/activate``, then
   ``pip``?

   Although the latter method requires fewer key strokes to issue commands once
   invoked, there are numerous reasons why one should avoid using ``activate``
   within a virtual environment. Michael F. Lamb (datagrok) presents a summary
   in `Virtualenv's bin/activate is Doing It Wrong
   <https://gist.github.com/datagrok/2199506>`_, and proposes alternatives,
   followed by comments from other developers.

   However, we prefer to keep things simple. ``$VENV/bin/pip`` is already
   UNIX-y. The few extra key strokes are worth avoiding the mess altogether.


.. index::
   single: installing on Windows
@@ -228,6 +246,9 @@

      c:\\> %VENV%\\Scripts\\pip install "pyramid==\ |release|\ "

.. note:: See the note above for :ref:`Why use $VENV/bin/pip instead of source
   bin/activate, then pip <venv-bin-pip-vs-source-bin-activate>`.


What Gets Installed
-------------------

 docs/quick_tour.rst

@@ -59,7 +59,9 @@

.. seealso:: See also:
    :ref:`Quick Tutorial section on Requirements <qtut_requirements>`,
    :ref:`installing_unix`, :ref:`Before You Install <installing_chapter>`, and
    :ref:`installing_unix`, :ref:`Before You Install <installing_chapter>`,
    :ref:`Why use $VENV/bin/pip instead of source bin/activate, then pip
    <venv-bin-pip-vs-source-bin-activate>`, and
    :ref:`Installing Pyramid on a Windows System <installing_windows>`.



 docs/quick_tutorial/requirements.rst

@@ -179,6 +179,9 @@
    # Windows
    c:\> %VENV%\Scripts\pip install --upgrade pip setuptools

.. seealso:: See also :ref:`Why use $VENV/bin/pip instead of source
   bin/activate, then pip <venv-bin-pip-vs-source-bin-activate>`.


.. _install-pyramid: