Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Issue #24617: Merge os.mkdir() doc from 3.5

This commit is contained in:
Martin Panter 2016-06-10 08:40:02 +00:00
parent 596357de23 63b91e5403
commit b7bdfcff97
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Doc/library/os.rst
View File

@ -1656,9 +1656,15 @@ features:
Create a directory named *path* with numeric mode *mode*. Create a directory named *path* with numeric mode *mode*.
If the directory already exists, :exc:`FileExistsError` is raised.
.. _mkdir_modebits:
On some systems, *mode* is ignored. Where it is used, the current umask On some systems, *mode* is ignored. Where it is used, the current umask
value is first masked out. If the directory already exists, value is first masked out. If bits other than the last 9 (i.e. the last 3
:exc:`FileExistsError` is raised. digits of the octal representation of the *mode*) are set, their meaning is
platform-dependent. On some platforms, they are ignored and you should call
:func:`chmod` explicitly to set them.
This function can also support :ref:`paths relative to directory descriptors This function can also support :ref:`paths relative to directory descriptors
<dir_fd>`. <dir_fd>`.
@ -1679,8 +1685,8 @@ features:
Recursive directory creation function. Like :func:`mkdir`, but makes all Recursive directory creation function. Like :func:`mkdir`, but makes all
intermediate-level directories needed to contain the leaf directory. intermediate-level directories needed to contain the leaf directory.
The default *mode* is ``0o777`` (octal). On some systems, *mode* is The *mode* parameter is passed to :func:`mkdir`; see :ref:`the mkdir()
ignored. Where it is used, the current umask value is first masked out. description <mkdir_modebits>` for how it is interpreted.
If *exist_ok* is ``False`` (the default), an :exc:`OSError` is raised if the If *exist_ok* is ``False`` (the default), an :exc:`OSError` is raised if the
target directory already exists. target directory already exists.