[3.11] gh-96288: Add a sentence to `os.mkdir`'s docstring. (GH-96271). (#98065)

(cherry picked from commit 1523c9e9d4)

Co-authored-by: Hagai Helman Tov <hagai.helman@gmail.com>
This commit is contained in:
Jelle Zijlstra 2022-10-07 21:00:00 -07:00 committed by GitHub
parent 52dab90500
commit 15732114b8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 6 additions and 4 deletions

View File

@ -1360,7 +1360,8 @@ PyDoc_STRVAR(os_mkdir__doc__,
"dir_fd may not be implemented on your platform.\n"
" If it is unavailable, using it will raise a NotImplementedError.\n"
"\n"
"The mode argument is ignored on Windows.");
"The mode argument is ignored on Windows. Where it is used, the current umask\n"
"value is first masked out.");
#define OS_MKDIR_METHODDEF \
{"mkdir", _PyCFunction_CAST(os_mkdir), METH_FASTCALL|METH_KEYWORDS, os_mkdir__doc__},
@ -9378,4 +9379,4 @@ exit:
#ifndef OS_WAITSTATUS_TO_EXITCODE_METHODDEF
#define OS_WAITSTATUS_TO_EXITCODE_METHODDEF
#endif /* !defined(OS_WAITSTATUS_TO_EXITCODE_METHODDEF) */
/*[clinic end generated code: output=836be9d51f01140e input=a9049054013a1b77]*/
/*[clinic end generated code: output=8dd784bf1e41b881 input=a9049054013a1b77]*/

View File

@ -4560,12 +4560,13 @@ If dir_fd is not None, it should be a file descriptor open to a directory,
dir_fd may not be implemented on your platform.
If it is unavailable, using it will raise a NotImplementedError.
The mode argument is ignored on Windows.
The mode argument is ignored on Windows. Where it is used, the current umask
value is first masked out.
[clinic start generated code]*/
static PyObject *
os_mkdir_impl(PyObject *module, path_t *path, int mode, int dir_fd)
/*[clinic end generated code: output=a70446903abe821f input=e965f68377e9b1ce]*/
/*[clinic end generated code: output=a70446903abe821f input=a61722e1576fab03]*/
{
int result;
#ifdef HAVE_MKDIRAT