From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 27 Apr 2022 22:20:53 +0000 (-0700)
Subject: gh-84459: Make wording more specific for Path.replace (GH-91853)
X-Git-Tag: v3.9.13~76
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=35a4eb299a535cf25a8c48a4a90550a45e898305;p=thirdparty%2FPython%2Fcpython.git

gh-84459: Make wording more specific for Path.replace (GH-91853)


GH-84459
(cherry picked from commit 161dff7e10eeb7eaf6d418b91e993aaf84770a5c)

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

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 8e553d404100..f8985a1f3ab9 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2207,7 +2207,7 @@ features:
 
 .. function:: replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)
 
-   Rename the file or directory *src* to *dst*.  If *dst* is a directory,
+   Rename the file or directory *src* to *dst*.  If *dst* is a non-empty directory,
    :exc:`OSError` will be raised.  If *dst* exists and is a file, it will
    be replaced silently if the user has permission.  The operation may fail
    if *src* and *dst* are on different filesystems.  If successful,
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 3a41b5454b86..30611abcb945 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1028,7 +1028,7 @@ call fails (for example because the path doesn't exist).
 
    Rename this file or directory to the given *target*, and return a new Path
    instance pointing to *target*.  If *target* points to an existing file or
-   directory, it will be unconditionally replaced.
+   empty directory, it will be unconditionally replaced.
 
    The target path may be absolute or relative. Relative paths are interpreted
    relative to the current working directory, *not* the directory of the Path