From ae4a78b0a8f1c280eee19018d7988063a34d1821 Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Tue, 19 Jul 2011 08:03:02 +0800 Subject: Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob --- Doc/library/shutil.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 1a878d5..1f194a0 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -161,8 +161,10 @@ Directory and files operations Recursively move a file or directory to another location. - If the destination is on the current filesystem, then simply use rename. - Otherwise, copy src (with :func:`copy2`) to the dst and then remove src. + Uses :func:`os.rename` to perform the move. If it fails, for reasons such as + when *src* and *dst* are on different filesystems or in case of windows where + rename is not supported when *dst* exists, fallback to copying *src* (with + :func:`copy2`) to the *dst* and then remove *src*. .. exception:: Error -- cgit v0.12