summaryrefslogtreecommitdiffstats
path: root/Modules/clinic
diff options
context:
space:
mode:
authoramaajemyfren <32741226+amaajemyfren@users.noreply.github.com>2022-12-21 17:48:25 (GMT)
committerGitHub <noreply@github.com>2022-12-21 17:48:25 (GMT)
commitbbf4a66a18cc0fa9121e1bbc90d75d10f5b3a389 (patch)
tree7a5f89beefc38379066c609bf72845037fbefa9b /Modules/clinic
parentd713c54ac8a2eba0616a5a07714696d935f1062e (diff)
downloadcpython-bbf4a66a18cc0fa9121e1bbc90d75d10f5b3a389.zip
cpython-bbf4a66a18cc0fa9121e1bbc90d75d10f5b3a389.tar.gz
cpython-bbf4a66a18cc0fa9121e1bbc90d75d10f5b3a389.tar.bz2
GH-69564: Clarify use of octal format of mode argument in help(os.chmod) (#20621)
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Diffstat (limited to 'Modules/clinic')
-rw-r--r--Modules/clinic/posixmodule.c.h13
1 files changed, 12 insertions, 1 deletions
diff --git a/Modules/clinic/posixmodule.c.h b/Modules/clinic/posixmodule.c.h
index 8625100..d4722cc 100644
--- a/Modules/clinic/posixmodule.c.h
+++ b/Modules/clinic/posixmodule.c.h
@@ -501,6 +501,9 @@ PyDoc_STRVAR(os_chmod__doc__,
" If this functionality is unavailable, using it raises an exception.\n"
" mode\n"
" Operating-system mode bitfield.\n"
+" Be careful when using number literals for *mode*. The conventional UNIX notation for\n"
+" numeric modes uses an octal base, which needs to be indicated with a ``0o`` prefix in\n"
+" Python.\n"
" dir_fd\n"
" If not None, it should be a file descriptor open to a directory,\n"
" and path should be relative; path will then be relative to that\n"
@@ -602,6 +605,14 @@ PyDoc_STRVAR(os_fchmod__doc__,
"\n"
"Change the access permissions of the file given by file descriptor fd.\n"
"\n"
+" fd\n"
+" The file descriptor of the file to be modified.\n"
+" mode\n"
+" Operating-system mode bitfield.\n"
+" Be careful when using number literals for *mode*. The conventional UNIX notation for\n"
+" numeric modes uses an octal base, which needs to be indicated with a ``0o`` prefix in\n"
+" Python.\n"
+"\n"
"Equivalent to os.chmod(fd, mode).");
#define OS_FCHMOD_METHODDEF \
@@ -11549,4 +11560,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=04fd23c89ab41f75 input=a9049054013a1b77]*/
+/*[clinic end generated code: output=41eab6c3523792a9 input=a9049054013a1b77]*/