summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorRyan Ozawa <ryan.ozawa21@gmail.com>2023-01-09 21:43:09 (GMT)
committerGitHub <noreply@github.com>2023-01-09 21:43:09 (GMT)
commite098137cd3250af05f19380590b8dec79dc5942f (patch)
treef199a2849ced88c47fd8b9b6203edfd84b4ebf05 /Doc
parent61762b93871419b34f02d83cee5ca0d94d4a2903 (diff)
downloadcpython-e098137cd3250af05f19380590b8dec79dc5942f.zip
cpython-e098137cd3250af05f19380590b8dec79dc5942f.tar.gz
cpython-e098137cd3250af05f19380590b8dec79dc5942f.tar.bz2
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
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 b06f9bb..fb09117 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