From: Antoine Pitrou <solipsis@pitrou.net>
Date: Mon, 20 Aug 2012 23:08:17 +0000 (+0200)
Subject: Improve the pyvenv entry
X-Git-Tag: v3.3.0rc1~52
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a5e5797e487941e0a0f2d9041094bce01294e2f9;p=python

Improve the pyvenv entry
---

diff --git a/Doc/using/scripts.rst b/Doc/using/scripts.rst
index ed4d868658..2c87416f1c 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 f7a928adae..2e8d341541 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