summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorJason R. Coombs <jaraco@jaraco.com>2013-05-28 03:26:36 (GMT)
committerJason R. Coombs <jaraco@jaraco.com>2013-05-28 03:26:36 (GMT)
commit8f1a8e32b101ce365147b30c0feb3f31a14a60b6 (patch)
tree48ca95ddc0f44bdd67e14e2e221debfec5ebf511 /Doc
parent667a03b292e881f1ab0d0dba181868200d2abaf9 (diff)
parent3a09286790c58522195eadc3eaa4a21e8da89ea1 (diff)
downloadcpython-8f1a8e32b101ce365147b30c0feb3f31a14a60b6.zip
cpython-8f1a8e32b101ce365147b30c0feb3f31a14a60b6.tar.gz
cpython-8f1a8e32b101ce365147b30c0feb3f31a14a60b6.tar.bz2
Merge with 3.3
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/os.rst8
1 files changed, 5 insertions, 3 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 137fd42..16bec77 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2024,9 +2024,10 @@ features:
Create a symbolic link pointing to *source* named *link_name*.
On Windows, a symlink represents either a file or a directory, and does not
- morph to the target dynamically. If *target_is_directory* is set to ``True``,
- the symlink will be created as a directory symlink, otherwise as a file symlink
- (the default). On non-Window platforms, *target_is_directory* is ignored.
+ morph to the target dynamically. If the target is present, the type of the
+ symlink will be created to match. Otherwise, the symlink will be created
+ as a directory if *target_is_directory* is ``True`` or a file symlink (the
+ default) otherwise. On non-Window platforms, *target_is_directory* is ignored.
Symbolic link support was introduced in Windows 6.0 (Vista). :func:`symlink`
will raise a :exc:`NotImplementedError` on Windows versions earlier than 6.0.
@@ -2042,6 +2043,7 @@ features:
to the administrator level. Either obtaining the privilege or running your
application as an administrator are ways to successfully create symlinks.
+
:exc:`OSError` is raised when the function is called by an unprivileged
user.