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

(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 20:59:48 -07:00 committed by GitHub
parent f50e3a7fea
commit 2090eeb46d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 6 additions and 4 deletions

View file

@ -1328,7 +1328,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)(void(*)(void))os_mkdir, METH_FASTCALL|METH_KEYWORDS, os_mkdir__doc__},
@ -9291,4 +9292,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=ddc35c3177c3b3ed input=a9049054013a1b77]*/
/*[clinic end generated code: output=f8cdbd04ea0e3502 input=a9049054013a1b77]*/

View file

@ -4494,12 +4494,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