diff -r f477ce0d2345 Doc/library/pathlib.rst
--- a/Doc/library/pathlib.rst	Tue Jun 07 11:25:43 2016 +0200
+++ b/Doc/library/pathlib.rst	Tue Jun 07 19:18:38 2016 -0600
@@ -887,8 +887,10 @@
 
 .. 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')