remove directory mode check from makedirs (closes #21082)

1 files changed, 9 insertions, 5 deletions

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index abacd24..d168963 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1188,11 +1188,8 @@ Files and Directories
    The default *mode* is ``0o777`` (octal).  On some systems, *mode* is
    ignored.  Where it is used, the current umask value is first masked out.
 
-   If *exists_ok* is ``False`` (the default), an :exc:`OSError` is raised if
-   the target directory already exists.  If *exists_ok* is ``True`` an
-   :exc:`OSError` is still raised if the umask-masked *mode* is different from
-   the existing mode, on systems where the mode is used.  :exc:`OSError` will
-   also be raised if the directory creation fails.
+   If *exist_ok* is ``False`` (the default), an :exc:`OSError` is raised if the
+   target directory already exists.
 
    .. note::
 
@@ -1204,6 +1201,13 @@ Files and Directories
    .. versionadded:: 3.2
       The *exist_ok* parameter.
 
+   .. versionchanged:: 3.2.5
+
+      Before Python 3.2.5, if *exist_ok* was ``True`` and the directory existed,
+      :func:`makedirs` would still raise an error if *mode* did not match the
+      mode of the existing directory. Since this behavior was impossible to
+      implement safely, it was removed in Python 3.2.6. See :issue:`21082`.
+
 
 .. function:: pathconf(path, name)