From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Wed, 21 Feb 2018 04:25:37 +0000 (-0800) Subject: bpo-32540: Update venv documentation (GH-5736) X-Git-Tag: v3.7.0b2~50 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=98a86cbb9bed94a232263698041acd2775da3dad;p=python 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 --- diff --git a/Doc/using/venv-create.inc b/Doc/using/venv-create.inc index 4292592ba7..4c7795ad80 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