Skip to content

Commit 5c4afdf

Browse files
bpo-28356: Document os.rename() behavior on Windows for differing volumes (GH-27376)
(cherry picked from commit e098137) Co-authored-by: Ryan Ozawa <[email protected]>
1 parent b374481 commit 5c4afdf

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

Doc/library/os.rst

+2
Original file line numberDiff line numberDiff line change
@@ -2302,6 +2302,8 @@ features:
23022302
will fail with an :exc:`OSError` subclass in a number of cases:
23032303

23042304
On Windows, if *dst* exists a :exc:`FileExistsError` is always raised.
2305+
The operation may fail if *src* and *dst* are on different filesystems. Use
2306+
:func:`shutil.move` to support moves to a different filesystem.
23052307

23062308
On Unix, if *src* is a file and *dst* is a directory or vice-versa, an
23072309
:exc:`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised

0 commit comments

Comments
 (0)