| Index: bootstrap/virtualenv/docs/installation.rst
|
| diff --git a/bootstrap/virtualenv/docs/installation.rst b/bootstrap/virtualenv/docs/installation.rst
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..3006d76179d361b7b4d5a5671349db669baecf0a
|
| --- /dev/null
|
| +++ b/bootstrap/virtualenv/docs/installation.rst
|
| @@ -0,0 +1,58 @@
|
| +Installation
|
| +============
|
| +
|
| +.. warning::
|
| +
|
| + We advise installing virtualenv-1.9 or greater. Prior to version 1.9, the
|
| + pip included in virtualenv did not download from PyPI over SSL.
|
| +
|
| +.. warning::
|
| +
|
| + When using pip to install virtualenv, we advise using pip 1.3 or greater.
|
| + Prior to version 1.3, pip did not download from PyPI over SSL.
|
| +
|
| +.. warning::
|
| +
|
| + We advise against using easy_install to install virtualenv when using
|
| + setuptools < 0.9.7, because easy_install didn't download from PyPI over SSL
|
| + and was broken in some subtle ways.
|
| +
|
| +To install globally with `pip` (if you have pip 1.3 or greater installed globally):
|
| +
|
| +::
|
| +
|
| + $ [sudo] pip install virtualenv
|
| +
|
| +Or to get the latest unreleased dev version:
|
| +
|
| +::
|
| +
|
| + $ [sudo] pip install https://github.com/pypa/virtualenv/tarball/develop
|
| +
|
| +
|
| +To install version X.X globally from source:
|
| +
|
| +::
|
| +
|
| + $ curl -O https://pypi.python.org/packages/source/v/virtualenv/virtualenv-X.X.tar.gz
|
| + $ tar xvfz virtualenv-X.X.tar.gz
|
| + $ cd virtualenv-X.X
|
| + $ [sudo] python setup.py install
|
| +
|
| +
|
| +To *use* locally from source:
|
| +
|
| +::
|
| +
|
| + $ curl -O https://pypi.python.org/packages/source/v/virtualenv/virtualenv-X.X.tar.gz
|
| + $ tar xvfz virtualenv-X.X.tar.gz
|
| + $ cd virtualenv-X.X
|
| + $ python virtualenv.py myVE
|
| +
|
| +.. note::
|
| +
|
| + The ``virtualenv.py`` script is *not* supported if run without the
|
| + necessary pip/setuptools/virtualenv distributions available locally. All
|
| + of the installation methods above include a ``virtualenv_support``
|
| + directory alongside ``virtualenv.py`` which contains a complete set of
|
| + pip and setuptools distributions, and so are fully supported.
|
|
|