Issue #27180: Clarify Path.rename() behavior on Unix systems
Patch by Evelyn Mitchell.
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index f803fb6..57a6a84 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -891,8 +891,9 @@
.. 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')