diff -r 6d278f426417 Doc/tutorial/modules.rst --- a/Doc/tutorial/modules.rst Fri Jul 05 18:05:29 2013 -1000 +++ b/Doc/tutorial/modules.rst Sat Jul 06 18:03:27 2013 +0200 @@ -165,11 +165,18 @@ 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. * :envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the shell variable :envvar:`PATH`). * the installation-dependent default. +.. note:: + + On filesystems supporting symlinks, the actual script file directory is + searched although the script may be invoked via a symlink to it. The + directory containing the symlink (if different than the actual script + file directory) is *not* added to :data:`sys.path`. + After initialization, Python programs can modify :data:`sys.path`. The directory containing the script being run is placed at the beginning of the search path, ahead of the standard library path. This means that scripts in that