gh-132416: document behavior of os.symlink when dst already exists

alex-semenyuk · alex-semenyuk · commit 18050ff7a032 · 2025-04-23T01:24:15.000+05:00
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
@@ -3509,6 +3509,7 @@ features:
    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-Windows platforms, *target_is_directory* is ignored.
+   If the *dst* already exists, :exc:`FileExistsError` is raised.
 
    This function can support :ref:`paths relative to directory descriptors
    <dir_fd>`.
