summaryrefslogtreecommitdiffstats
path: root/Doc/library/os.rst
diff options
context:
space:
mode:
authorAntoine Pitrou <solipsis@pitrou.net>2012-01-24 08:05:18 (GMT)
committerAntoine Pitrou <solipsis@pitrou.net>2012-01-24 08:05:18 (GMT)
commit91ecea24f53b99aa190f6b17c2b51d95cb09d233 (patch)
tree223a4b5fa95e535f8fa16560cea1eaa748e8ef7d /Doc/library/os.rst
parent09406023a8c19febb3358008ddeabe4450c21b79 (diff)
parent5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023 (diff)
downloadcpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.zip
cpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.tar.gz
cpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.tar.bz2
Issue #13772: In os.symlink() under Windows, do not try to guess the link
target's type (file or directory). The detection was buggy and made the call non-atomic (therefore prone to race conditions).
Diffstat (limited to 'Doc/library/os.rst')
-rw-r--r--Doc/library/os.rst9
1 files changed, 3 insertions, 6 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 0c0d681..3c302a4 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2085,11 +2085,9 @@ Files and Directories
*target_is_directory*, which defaults to ``False``.
On Windows, a symlink represents a file or a directory, and does not morph to
- the target dynamically. For this reason, when creating a symlink on Windows,
- if the target is not already present, the symlink will default to being a
- file symlink. If *target_is_directory* is set to ``True``, the symlink will
- be created as a directory symlink. This parameter is ignored if the target
- exists (and the symlink is created with the same type as the target).
+ 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).
Symbolic link support was introduced in Windows 6.0 (Vista). :func:`symlink`
will raise a :exc:`NotImplementedError` on Windows versions earlier than 6.0.
@@ -2102,7 +2100,6 @@ Files and Directories
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.