summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
Diffstat (limited to 'Doc')
-rw-r--r--Doc/using/scripts.rst2
-rw-r--r--Doc/whatsnew/3.3.rst23
2 files changed, 18 insertions, 7 deletions
diff --git a/Doc/using/scripts.rst b/Doc/using/scripts.rst
index ed4d868..2c87416 100644
--- a/Doc/using/scripts.rst
+++ b/Doc/using/scripts.rst
@@ -3,6 +3,8 @@
Additional Tools and Scripts
============================
+.. _scripts-pyvenv:
+
pyvenv - Creating virtual environments
--------------------------------------
diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
index f7a928a..2e8d341 100644
--- a/Doc/whatsnew/3.3.rst
+++ b/Doc/whatsnew/3.3.rst
@@ -94,13 +94,22 @@ Please read on for a comprehensive list of user-facing changes.
PEP 405: Virtual Environments
=============================
-- inspired by ``virtualenv``, a tool widely used by the community
-- change to the interpreter to avoid hacks
-
-The :mod:`venv` module and ``pyvenv`` script (inspired by ``virtualenv``, a
-tool widely used by the community).
-
-.. also mention the interpreter changes that avoid the hacks used in virtualenv
+:pep:`405` - Python Virtual Environments
+ PEP written by Carl Meyer, implemented by Carl Meyer and Vinay Sajip.
+
+Virtual environments help create separate Python setups while sharing a
+system-wide base install, for ease of maintenance. Virtual environments
+have their own set of private site packages (i.e. locally-installed
+libraries), and are optionally segregated from the system-wide site
+packages. Their concept and implementation are inspired by the popular
+``virtualenv`` third-party package, but benefit from tighter integration
+with the interpreter core.
+
+This PEP adds the :mod:`venv` module for programmatic access, and the
+:ref:`pyvenv <scripts-pyvenv>` script for command-line access and
+administration. The Python interpreter becomes aware of a ``pvenv.cfg``
+file whose existence signals the base of a virtual environment's directory
+tree.
PEP 420: Namespace Packages