Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(1)

Side by Side Diff: Doc/library/os.rst

Issue 12277: Missing comma in os.walk docs
Patch Set: Created 9 years ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 :mod:`os` --- Miscellaneous operating system interfaces 1 :mod:`os` --- Miscellaneous operating system interfaces
2 ======================================================= 2 =======================================================
3 3
4 .. module:: os 4 .. module:: os
5 :synopsis: Miscellaneous operating system interfaces. 5 :synopsis: Miscellaneous operating system interfaces.
6 6
7 7
8 This module provides a portable way of using operating system dependent 8 This module provides a portable way of using operating system dependent
9 functionality. If you just want to read or write a file see :func:`open`, if 9 functionality. If you just want to read or write a file see :func:`open`, if
10 you want to manipulate paths, see the :mod:`os.path` module, and if you want to 10 you want to manipulate paths, see the :mod:`os.path` module, and if you want to
(...skipping 1986 matching lines...) Expand 10 before | Expand all | Expand 10 after
1997 1997
1998 When *topdown* is ``True``, the caller can modify the *dirnames* list in-plac e 1998 When *topdown* is ``True``, the caller can modify the *dirnames* list in-plac e
1999 (perhaps using :keyword:`del` or slice assignment), and :func:`walk` will onl y 1999 (perhaps using :keyword:`del` or slice assignment), and :func:`walk` will onl y
2000 recurse into the subdirectories whose names remain in *dirnames*; this can be 2000 recurse into the subdirectories whose names remain in *dirnames*; this can be
2001 used to prune the search, impose a specific order of visiting, or even to inf orm 2001 used to prune the search, impose a specific order of visiting, or even to inf orm
2002 :func:`walk` about directories the caller creates or renames before it resume s 2002 :func:`walk` about directories the caller creates or renames before it resume s
2003 :func:`walk` again. Modifying *dirnames* when *topdown* is ``False`` is 2003 :func:`walk` again. Modifying *dirnames* when *topdown* is ``False`` is
2004 ineffective, because in bottom-up mode the directories in *dirnames* are 2004 ineffective, because in bottom-up mode the directories in *dirnames* are
2005 generated before *dirpath* itself is generated. 2005 generated before *dirpath* itself is generated.
2006 2006
2007 By default errors from the :func:`listdir` call are ignored. If optional 2007 By default, errors from the :func:`listdir` call are ignored. If optional
2008 argument *onerror* is specified, it should be a function; it will be called w ith 2008 argument *onerror* is specified, it should be a function; it will be called w ith
2009 one argument, an :exc:`OSError` instance. It can report the error to continu e 2009 one argument, an :exc:`OSError` instance. It can report the error to continu e
2010 with the walk, or raise the exception to abort the walk. Note that the filen ame 2010 with the walk, or raise the exception to abort the walk. Note that the filen ame
2011 is available as the ``filename`` attribute of the exception object. 2011 is available as the ``filename`` attribute of the exception object.
2012 2012
2013 By default, :func:`walk` will not walk down into symbolic links that resolve to 2013 By default, :func:`walk` will not walk down into symbolic links that resolve to
2014 directories. Set *followlinks* to ``True`` to visit directories pointed to by 2014 directories. Set *followlinks* to ``True`` to visit directories pointed to by
2015 symlinks, on systems that support them. 2015 symlinks, on systems that support them.
2016 2016
2017 .. note:: 2017 .. note::
(...skipping 844 matching lines...) Expand 10 before | Expand all | Expand 10 after
2862 2862
2863 .. function:: urandom(n) 2863 .. function:: urandom(n)
2864 2864
2865 Return a string of *n* random bytes suitable for cryptographic use. 2865 Return a string of *n* random bytes suitable for cryptographic use.
2866 2866
2867 This function returns random bytes from an OS-specific randomness source. Th e 2867 This function returns random bytes from an OS-specific randomness source. Th e
2868 returned data should be unpredictable enough for cryptographic applications, 2868 returned data should be unpredictable enough for cryptographic applications,
2869 though its exact quality depends on the OS implementation. On a UNIX-like 2869 though its exact quality depends on the OS implementation. On a UNIX-like
2870 system this will query /dev/urandom, and on Windows it will use CryptGenRando m. 2870 system this will query /dev/urandom, and on Windows it will use CryptGenRando m.
2871 If a randomness source is not found, :exc:`NotImplementedError` will be raise d. 2871 If a randomness source is not found, :exc:`NotImplementedError` will be raise d.
OLDNEW
« no previous file with comments | « no previous file | no next file » | no next file with comments »

RSS Feeds Recent Issues | This issue
This is Rietveld 894c83f36cb7+