gh-98240: Updated Path.rename docs, when it is atomic (GH-98245)

(cherry picked from commit 0023f51debeeeef483a6362ee12d67c4da086af3)

Co-authored-by: Mateusz <mateka@users.noreply.github.com>

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index e6db8caa16bb0c42bd4a05d048b435ffec480b26..e8bb00fc5743404e3f88c12ec9fb783a54bdeb29 100644 (file)
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1071,6 +1071,8 @@ call fails (for example because the path doesn't exist).
    relative to the current working directory, *not* the directory of the Path
    object.
 
+   It is implemented in terms of :func:`os.rename` and gives the same guarantees.
+
    .. versionchanged:: 3.8
       Added return value, return the new Path instance.