From: Ryan Ozawa <ryan.ozawa21@gmail.com>
Date: Mon, 9 Jan 2023 21:43:09 +0000 (-0800)
Subject: bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
X-Git-Tag: v3.12.0a4~8
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e098137cd3250af05f19380590b8dec79dc5942f;p=thirdparty%2FPython%2Fcpython.git

bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index b06f9bbcd831..fb091176767f 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2467,6 +2467,8 @@ features:
    will fail with an :exc:`OSError` subclass in a number of cases:
 
    On Windows, if *dst* exists a :exc:`FileExistsError` is always raised.
+   The operation may fail if *src* and *dst* are on different filesystems. Use
+   :func:`shutil.move` to support moves to a different filesystem.
 
    On Unix, if *src* is a file and *dst* is a directory or vice-versa, an
    :exc:`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised