From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 2 May 2022 14:51:07 +0000 (-0700)
Subject: gh-84714: Add behavior if dst file exists (GH-91867)
X-Git-Tag: v3.10.5~119
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bba721d0fa7832fd9dbdde44ba39f19755513303;p=thirdparty%2FPython%2Fcpython.git

gh-84714: Add behavior if dst file exists (GH-91867)

(cherry picked from commit 9166ace805d915c8a918cd89fff0e58b65e3327c)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
---

diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 8ce0e80ec812..403df45b3966 100644
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -160,7 +160,8 @@ Directory and files operations
    Copies the file *src* to the file or directory *dst*.  *src* and *dst*
    should be :term:`path-like objects <path-like object>` or strings.  If
    *dst* specifies a directory, the file will be copied into *dst* using the
-   base filename from *src*.  Returns the path to the newly created file.
+   base filename from *src*. If *dst* specifies a file that already exists,
+   it will be replaced. Returns the path to the newly created file.
 
    If *follow_symlinks* is false, and *src* is a symbolic link,
    *dst* will be created as a symbolic link.  If *follow_symlinks*