From 29368584d295aed3ec198c158f6503f370492c03 Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Sun, 22 Mar 2015 10:11:54 -0400 Subject: [PATCH] clarify behavior of shutil.move when destination exists (closes #22933) Patch by Mike Short. --- Doc/library/shutil.rst | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index e8974839ac..f350f5ea54 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -164,12 +164,9 @@ Directory and files operations Recursively move a file or directory (*src*) to another location (*dst*). - If the destination is a directory or a symlink to a directory, then *src* is - moved inside that directory. - - The destination directory must not already exist. If the destination already - exists but is not a directory, it may be overwritten depending on - :func:`os.rename` semantics. + If the destination is an existing directory, then *src* is moved inside that + directory. If the destination already exists but is not a directory, it may + be overwritten depending on :func:`os.rename` semantics. If the destination is on the current filesystem, then :func:`os.rename` is used. Otherwise, *src* is copied (using :func:`shutil.copy2`) to *dst* and -- 2.50.1