summaryrefslogtreecommitdiff
path: root/docs/glossary.rst
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2016-04-12 06:43:38 -0700
committerSteve Piercy <web@stevepiercy.com>2016-04-12 06:43:38 -0700
commitd67566acebf890a603fad0e9069d5e131dfb5b31 (patch)
tree78e5994d2119b45461ea7c1ba924b8d000d7ac62 /docs/glossary.rst
parent654821decedd4f70e6de22e177b216f18524e609 (diff)
downloadpyramid-d67566acebf890a603fad0e9069d5e131dfb5b31.tar.gz
pyramid-d67566acebf890a603fad0e9069d5e131dfb5b31.tar.bz2
pyramid-d67566acebf890a603fad0e9069d5e131dfb5b31.zip
one does not simply "create a virtualenv". one should "create a virtual environment".
- Fixes #2483
Diffstat (limited to 'docs/glossary.rst')
-rw-r--r--docs/glossary.rst18
1 files changed, 13 insertions, 5 deletions
diff --git a/docs/glossary.rst b/docs/glossary.rst
index fd32ed796..4c17c0f0b 100644
--- a/docs/glossary.rst
+++ b/docs/glossary.rst
@@ -155,9 +155,9 @@ Glossary
request before it returns a :term:`context` resource.
virtualenv
- A term referring both to an isolated Python environment,
- or `the leading tool <http://www.virtualenv.org>`_ that allows one to
- create such environments.
+ The `virtualenv tool <https://virtualenv.pypa.io/en/latest/>`_ that allows
+ one to create virtual environments. In Python 3.3 and greater,
+ :term:`venv` is the preferred tool.
Note: whenever you encounter commands prefixed with ``$VENV`` (Unix)
or ``%VENV`` (Windows), know that that is the environment variable whose
@@ -1012,8 +1012,8 @@ Glossary
console script
A script written to the ``bin`` (on UNIX, or ``Scripts`` on Windows)
- directory of a Python installation or :term:`virtualenv` as the result of
- running ``setup.py install`` or ``setup.py develop``.
+ directory of a Python installation or :term:`virtual environment` as the
+ result of running ``pip install`` or ``pip install -e .``.
introspector
An object with the methods described by
@@ -1110,6 +1110,14 @@ Glossary
but it is deprecated in 3.6 in favor of ``python3 -m venv`` which is
backward compatible.
+ virtual environment
+ An isolated Python environment that allows packages to be installed for
+ use by a particular application, rather than being installed system wide.
+
venv
The `Python Packaging Authority's <https://www.pypa.io/>`_ recommended
tool for creating virtual environments.
+
+ Note: whenever you encounter commands prefixed with ``$VENV`` (Unix)
+ or ``%VENV`` (Windows), know that that is the environment variable whose
+ value is the root of the virtual environment in question.