[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