bpo-24356: Specify which Python binary will be used with venv (GH-6589)

diff --git a/Doc/library/venv.rst b/Doc/library/venv.rst
index 035fac41c52c6deb449f7ba80280429cfc0db652..def926b08526907a80659dc29c38b4039e506285 100644 (file)
--- a/Doc/library/venv.rst
+++ b/Doc/library/venv.rst
@@ -17,12 +17,18 @@
 
 The :mod:`venv` module provides support for creating lightweight "virtual
 environments" with their own site directories, optionally isolated from system
-site directories.  Each virtual environment has its own Python binary (allowing
-creation of environments with various Python versions) and can have its own
-independent set of installed Python packages in its site directories.
+site directories.  Each virtual environment has its own Python binary (which
+matches the version of the binary that was used to create this environment) and
+can have its own independent set of installed Python packages in its site
+directories.
 
 See :pep:`405` for more information about Python virtual environments.
 
+.. seealso::
+
+   `Python Packaging User Guide: Creating and using virtual environments
+   <https://packaging.python.org/installing/#creating-virtual-environments>`__
+
 .. note::
    The ``pyvenv`` script has been deprecated as of Python 3.6 in favor of using
    ``python3 -m venv`` to help prevent any potential confusion as to which

diff --git a/Doc/using/venv-create.inc b/Doc/using/venv-create.inc
index 4c7795ad801964fe945f58771efb36763d67ec3c..272090d083a5e24a58735583bed8449160a6bc8b 100644 (file)
--- a/Doc/using/venv-create.inc
+++ b/Doc/using/venv-create.inc
@@ -20,11 +20,6 @@ directory is specified, it will be re-used.
 .. versionchanged:: 3.5
    The use of ``venv`` is now recommended for creating virtual environments.
 
-.. seealso::
-
-   `Python Packaging User Guide: Creating and using virtual environments
-   <https://packaging.python.org/installing/#creating-virtual-environments>`__
-
 .. highlight:: none
 
 On Windows, invoke the ``venv`` command as follows::