gh-132416: document behavior of Path.symlink_to() when link or/and target already exist

alex-semenyuk · alex-semenyuk · commit f66156efc22b · 2025-04-19T00:57:36.000+05:00
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
@@ -1534,6 +1534,7 @@ Creating files and directories
    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 link or/and the target already exist, :exc:`FileExistsError` is raised.
 
    ::
 
