diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2023-01-09 13:52:22 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-01-09 13:52:22 -0800 |
| commit | 5c4afdf8bdcbd63f9833ca1223066d767f177001 (patch) | |
| tree | afaa8a7215f8ef7b529993c1083600854a1ac989 | |
| parent | b3744816163c8cb7e6b2603831d5731ef15a6281 (diff) | |
| download | cpython-git-5c4afdf8bdcbd63f9833ca1223066d767f177001.tar.gz | |
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>
| -rw-r--r-- | Doc/library/os.rst | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 7a5efcf5d7..e5fc63afdc 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 |