[Python-checkins] r86931 - python/branches/py3k/Doc/library/os.rst
georg.brandl
python-checkins at python.org
Thu Dec 2 10:06:13 CET 2010
Author: georg.brandl
Date: Thu Dec 2 10:06:12 2010
New Revision: 86931
Log:
Fix-up documentation of makedirs().
Modified:
python/branches/py3k/Doc/library/os.rst
Modified: python/branches/py3k/Doc/library/os.rst
==============================================================================
--- python/branches/py3k/Doc/library/os.rst (original)
+++ python/branches/py3k/Doc/library/os.rst Thu Dec 2 10:06:12 2010
@@ -1143,7 +1143,7 @@
Availability: Unix, Windows.
-.. function:: makedirs(path[, mode][, exist_ok=False])
+.. function:: makedirs(path, mode=0o777, exist_ok=False)
.. index::
single: directory; creating
@@ -1151,17 +1151,17 @@
Recursive directory creation function. Like :func:`mkdir`, but makes all
intermediate-level directories needed to contain the leaf directory. If
- the target directory with the same mode as we specified already exists,
+ the target directory with the same mode as specified already exists,
raises an :exc:`OSError` exception if *exist_ok* is False, otherwise no
exception is raised. If the directory cannot be created in other cases,
raises an :exc:`OSError` exception. The default *mode* is ``0o777`` (octal).
- 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.
.. note::
- :func:`makedirs` will become confused if the path elements to create include
- :data:`os.pardir`.
+ :func:`makedirs` will become confused if the path elements to create
+ include :data:`pardir`.
This function handles UNC paths correctly.
More information about the Python-checkins
mailing list