[Python-checkins] [3.11] GH-95815: Document less specific error for os.remove (GH-99571) (#99641)

Mon Nov 21 06:05:26 EST 2022

https://github.com/python/cpython/commit/bb4c09158324e0369e5cc1f6a021ebe144703202
commit: bb4c09158324e0369e5cc1f6a021ebe144703202
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ronaldoussoren <ronaldoussoren at mac.com>
date: 2022年11月21日T12:04:55+01:00
summary:
[3.11] GH-95815: Document less specific error for os.remove (GH-99571) (#99641)
GH-95815: Document less specific error for os.remove (GH-99571)
os.remove can raise PermissionError instead of IsADirectoryError,
when the object to be removed is a directory (in particular on
macOS).
This reverts a change done in GH-14262.
(cherry picked from commit 1cae31d26ba621f6b1f0656ad3d69a0236338bad)
Co-authored-by: Ronald Oussoren <ronaldoussoren at mac.com>
Co-authored-by: Ronald Oussoren <ronaldoussoren at mac.com>
files:
M Doc/library/os.rst

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 74125aef0579..6df697d44607 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2326,7 +2326,7 @@ features:
 .. function:: remove(path, *, dir_fd=None)
 
 Remove (delete) the file *path*. If *path* is a directory, an
- :exc:`IsADirectoryError` is raised. Use :func:`rmdir` to remove directories.
+ :exc:`OSError` is raised. Use :func:`rmdir` to remove directories.
 If the file does not exist, a :exc:`FileNotFoundError` is raised.
 
 This function can support :ref:`paths relative to directory descriptors
