diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 13bbd9d61e947b..7484b7505cf940 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -3893,6 +3893,8 @@ features: 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 `.