summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2023-01-09 21:52:22 (GMT)
committerGitHub <noreply@github.com>2023-01-09 21:52:22 (GMT)
commit5c4afdf8bdcbd63f9833ca1223066d767f177001 (patch)
treeafaa8a7215f8ef7b529993c1083600854a1ac989 /Doc
parentb3744816163c8cb7e6b2603831d5731ef15a6281 (diff)
downloadcpython-5c4afdf8bdcbd63f9833ca1223066d767f177001.zip
cpython-5c4afdf8bdcbd63f9833ca1223066d767f177001.tar.gz
cpython-5c4afdf8bdcbd63f9833ca1223066d767f177001.tar.bz2
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
(cherry picked from commit e098137cd3250af05f19380590b8dec79dc5942f) Co-authored-by: Ryan Ozawa <ryan.ozawa21@gmail.com>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/os.rst2
1 files changed, 2 insertions, 0 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 7a5efcf..e5fc63a 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