Issue #27180: Clarify Path.rename() behavior on Unix systems

berkerpeksag · berkerpeksag · commit 2b8792137bf5 · 2016-07-14T07:44:59.000+03:00
Patch by Evelyn Mitchell.
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
@@ -891,8 +891,9 @@ call fails (for example because the path doesn't exist):
 
 .. method:: Path.rename(target)
 
-   Rename this file or directory to the given *target*.  *target* can be
-   either a string or another path object::
+   Rename this file or directory to the given *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::
 
       >>> p = Path('foo')
       >>> p.open('w').write('some text')
