traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Bug #1343671: clarify docs for os.removedirs

This commit is contained in:
Georg Brandl 2005-12-17 17:31:03 +00:00
parent c1d2f7b6ad
commit 69cb3cde1a
1 changed files with 9 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Doc/lib/libos.tex
View File

@ -931,11 +931,15 @@ Availability: Macintosh, \UNIX, Windows.
\index{directory!deleting}
Removes directories recursively. Works like
\function{rmdir()} except that, if the leaf directory is
successfully removed, directories corresponding to rightmost path
segments will be pruned way until either the whole path is consumed or
an error is raised (which is ignored, because it generally means that
a parent directory is not empty). Throws an \exception{error}
exception if the leaf directory could not be successfully removed.
successfully removed, \function{removedirs()}
tries to successively remove every parent directory mentioned in
\var{path} until an error is raised (which is ignored, because
it generally means that a parent directory is not empty).
For example, \samp{os.removedirs('foo/bar/baz')} will first remove
the directory \samp{'foo/bar/baz'}, and then remove \samp{'foo/bar'}
and \samp{'foo'} if they are empty.
Raises \exception{OSError} if the leaf directory could not be
successfully removed.
\versionadded{1.5.2}
\end{funcdesc}