summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrett Cannon <brett@python.org>2014-02-06 14:22:51 (GMT)
committerBrett Cannon <brett@python.org>2014-02-06 14:22:51 (GMT)
commitf811bbfe6c41d90dd1ad1c68d05a84541ecdf162 (patch)
tree8870590cb4f214755b82d3bf3fac513078073793
parent94e44a935b3dc1e67a6a3357f64324ee0c81d40c (diff)
downloadcpython-f811bbfe6c41d90dd1ad1c68d05a84541ecdf162.zip
cpython-f811bbfe6c41d90dd1ad1c68d05a84541ecdf162.tar.gz
cpython-f811bbfe6c41d90dd1ad1c68d05a84541ecdf162.tar.bz2
Issue #6386: When executing a script that's a symlink, the directory
where the symlink resolves to is added to sys.path, not the directory containing the symlink itself. Thanks to Sanko Resic for an initial attempt at the patch.
-rw-r--r--Doc/tutorial/modules.rst10
-rw-r--r--Misc/NEWS7
2 files changed, 15 insertions, 2 deletions
diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst
index 94a66ac..fd361ae 100644
--- a/Doc/tutorial/modules.rst
+++ b/Doc/tutorial/modules.rst
@@ -165,10 +165,16 @@ a built-in module with that name. If not found, it then searches for a file
named :file:`spam.py` in a list of directories given by the variable
:data:`sys.path`. :data:`sys.path` is initialized from these locations:
-* the directory containing the input script (or the current directory).
+* The directory containing the input script (or the current directory when no
+ file is specified).
* :envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the
shell variable :envvar:`PATH`).
-* the installation-dependent default.
+* The installation-dependent default.
+
+.. note::
+ On file systems which support symlinks, the directory containing the input
+ script is calculated after the symlink is followed. In other words the
+ directory containing the symlink is **not** added to the module search path.
After initialization, Python programs can modify :data:`sys.path`. The
directory containing the script being run is placed at the beginning of the
diff --git a/Misc/NEWS b/Misc/NEWS
index 5403a6a..c963c83 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -163,6 +163,13 @@ Build
- Issue #20465: Update SQLite shipped with OS X installer to 3.8.3.
+Documentation
+-------------
+
+- Issue #6386: Clarify in the tutorial that specifying a symlink to execute
+ means the directory containing the executed script and not the symlink is
+ added to sys.path.
+
What's New in Python 3.4.0 Beta 3?
==================================