From 2b8792137bf5e02ee4263822f818b31b68830f4b Mon Sep 17 00:00:00 2001 From: Berker Peksag Date: Thu, 14 Jul 2016 07:44:59 +0300 Subject: Issue #27180: Clarify Path.rename() behavior on Unix systems Patch by Evelyn Mitchell. --- Doc/library/pathlib.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) 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 @@ 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') -- cgit v0.12