From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Wed, 14 Nov 2012 11:18:35 +0000 (+0000)
Subject: Issue #16378: Updated docstrings to reflect the defaults present in the code.
X-Git-Tag: v3.3.1rc1~637
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=87ed599b8a4afffbcb63677b19865b06e05032cf;p=python

Issue #16378: Updated docstrings to reflect the defaults present in the code.
---

diff --git a/Lib/venv/__init__.py b/Lib/venv/__init__.py
index 3c0d7af903..3920747931 100644
--- a/Lib/venv/__init__.py
+++ b/Lib/venv/__init__.py
@@ -54,9 +54,11 @@ class EnvBuilder:
     behaviour when called upon to create a virtual environment.
 
     By default, the builder makes the system (global) site-packages dir
-    available to the created environment.
+    *un*available to the created environment.
 
-    By default, the creation process uses symlinks wherever possible.
+    If invoked using the Python -m option, the default is to use copying
+    on Windows platforms but symlinks elsewhere. If instantiated some
+    other way, the default is to *not* use symlinks.
 
     :param system_site_packages: If True, the system (global) site-packages
                                  dir is available to created environments.
@@ -322,8 +324,9 @@ def create(env_dir, system_site_packages=False, clear=False, symlinks=False):
     """
     Create a virtual environment in a directory.
 
-    By default, makes the system (global) site-packages dir available to
-    the created environment.
+    By default, makes the system (global) site-packages dir *un*available to
+    the created environment, and uses copying rather than symlinking for files
+    obtained from the source Python installation.
 
     :param env_dir: The target directory to create an environment in.
     :param system_site_packages: If True, the system (global) site-packages