From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 9 Jan 2023 21:52:22 +0000 (-0800) Subject: bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376) X-Git-Tag: v3.10.10~55 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5c4afdf8bdcbd63f9833ca1223066d767f177001;p=thirdparty%2FPython%2Fcpython.git bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376) (cherry picked from commit e098137cd3250af05f19380590b8dec79dc5942f) Co-authored-by: Ryan Ozawa --- diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 7a5efcf5d79b..e5fc63afdcf5 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -2302,6 +2302,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