[3.10] gh-72073: Add Windows case in pathlib.rename (GH-93002) (GH-93029)

GH-72073

https://docs.python.org/3.12/library/pathlib.htmlGH-pathlib.Path.rename
(cherry picked from commit f51ed04c663417f88e10eeb21dad23250358bafa)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Automerge-Triggered-By: GH:brettcannon

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index f036d8119243a6dc0f97393ee82260bcb86edc8e..004f671b033aea0ebd9535f9437b27dbea48c63b 100644 (file)
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1018,8 +1018,9 @@ call fails (for example because the path doesn't exist).
 
    Rename this file or directory to the given *target*, and return a new Path
    instance pointing to *target*.  On Unix, if *target* exists and is a file,
-   it will be replaced silently if the user has permission.  *target* can be
-   either a string or another path object::
+   it will be replaced silently if the user has permission.
+   On Windows, if *target* exists, :exc:`FileExistsError` will be raised.
+   *target* can be either a string or another path object::
 
       >>> p = Path('foo')
       >>> p.open('w').write('some text')