[Python-checkins] bpo-32540: Update venv documentation (GH-5736)

[Mariatta]

https://github.com/python/cpython/commit/76c3f5eeb07aeb037da1ed6761dd9bd95e2c1d8d
commit: 76c3f5eeb07aeb037da1ed6761dd9bd95e2c1d8d
branch: 3.6
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Mariatta <Mariatta at users.noreply.github.com>
date: 2018-02-20T20:26:21-08:00
summary:

bpo-32540: Update venv documentation (GH-5736)

If the directory already exists, it will be re-used.
(cherry picked from commit e8eb972514cad6086b752754c1d34d703c04dd82)


Co-authored-by: TROUVERIE Joachim <joachim.trouverie at linoame.fr>

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

diff --git a/Doc/using/venv-create.inc b/Doc/using/venv-create.inc
index 4292592ba7a2..4c7795ad8019 100644
--- a/Doc/using/venv-create.inc
+++ b/Doc/using/venv-create.inc
@@ -9,7 +9,8 @@ with a ``home`` key pointing to the Python installation from which the command
 was run.  It also creates a ``bin`` (or ``Scripts`` on Windows) subdirectory
 containing a copy of the ``python`` binary (or binaries, in the case of
 Windows).  It also creates an (initially empty) ``lib/pythonX.Y/site-packages``
-subdirectory (on Windows, this is ``Lib\site-packages``).
+subdirectory (on Windows, this is ``Lib\site-packages``). If an existing
+directory is specified, it will be re-used.
 
 .. deprecated:: 3.6
    ``pyvenv`` was the recommended tool for creating virtual environments for
@@ -71,9 +72,7 @@ The command, if run with ``-h``, will show the available options::
 
 .. versionchanged:: 3.4
    In earlier versions, if the target directory already existed, an error was
-   raised, unless the ``--clear`` or ``--upgrade`` option was provided. Now,
-   if an existing directory is specified, its contents are removed and
-   the directory is processed as if it had been newly created.
+   raised, unless the ``--clear`` or ``--upgrade`` option was provided.
 
 The created ``pyvenv.cfg`` file also includes the
 ``include-system-site-packages`` key, set to ``true`` if ``venv`` is