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

If the directory already exists, it will be re-used.

(cherry picked from commit e8eb972514)

Co-authored-by: TROUVERIE Joachim <joachim.trouverie@linoame.fr>
This commit is contained in:
Miss Islington (bot) 2018-02-20 20:25:37 -08:00 committed by Mariatta
parent eed3c7af4e
commit 98a86cbb9b
1 changed files with 3 additions and 4 deletions

View File

@ -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