gh-96288: Add a sentence to `os.mkdir`'s docstring. (#96271)

This commit is contained in:
Hagai Helman Tov 2022-10-08 01:06:16 +03:00 committed by GitHub
parent 0f111f53c1
commit 1523c9e9d4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 6 additions and 4 deletions

View File

@ -1849,7 +1849,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__},
@ -11367,4 +11368,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=dd43d388b442c96d input=a9049054013a1b77]*/
/*[clinic end generated code: output=471ab8f2ad3d46b0 input=a9049054013a1b77]*/

View File

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