diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 54a5d3b98e8662..8e6232e3622dcf 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -3510,6 +3510,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 `.