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

[Steve Dower]

https://github.com/python/cpython/commit/83b449d754f4da3be107b508392ef5180f105c8b
commit: 83b449d754f4da3be107b508392ef5180f105c8b
branch: 3.7
author: Steve Dower <steve.dower at microsoft.com>
committer: GitHub <noreply at github.com>
date: 2018-07-28T17:48:29+01:00
summary:

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

files:
M Doc/library/venv.rst
M Doc/using/venv-create.inc

diff --git a/Doc/library/venv.rst b/Doc/library/venv.rst
index 035fac41c52c..def926b08526 100644
--- 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 4c7795ad8019..272090d083a5 100644
--- 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::