mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

markup adjustments

Browse source
This commit is contained in:
Fred Drake 2003-04-25 14:50:06 +00:00
parent 1448d4719c
commit 2194a4eede
1 changed files with 4 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/lib/libos.tex
View file

@ -1050,10 +1050,9 @@ which is used to set the access and modified times, respectively.
Availability: Macintosh, \UNIX, Windows. Availability: Macintosh, \UNIX, Windows.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{walk}{top\optional{, topdown=True}} \begin{funcdesc}{walk}{top\optional{, topdown\code{=True}}}
\index{directory!walking} \index{directory!walking}
\index{directory!traversal} \index{directory!traversal}
\function{walk()} generates the file names in a directory tree. \function{walk()} generates the file names in a directory tree.
For each directory in the tree rooted at directory \var{top} (including For each directory in the tree rooted at directory \var{top} (including
\var{top} itself), it yields a 3-tuple \var{top} itself), it yields a 3-tuple
@ -1064,7 +1063,7 @@ a list of the names of the subdirectories in \var{dirpath}
(excluding \code{'.'} and \code{'..'}). \var{filenames} is a list of (excluding \code{'.'} and \code{'..'}). \var{filenames} is a list of
the names of the non-directory files in \var{dirpath}. Note that the the names of the non-directory files in \var{dirpath}. Note that the
names in the lists contain no path components. To get a full names in the lists contain no path components. To get a full
path (which begins with \var{top)) to a file or directory in path (which begins with \var{top}) to a file or directory in
\var{dirpath}, do \code{os.path.join(\var{dirpath}, \var{name})}. \var{dirpath}, do \code{os.path.join(\var{dirpath}, \var{name})}.
If optional argument \var{topdown} is true or not specified, the triple If optional argument \var{topdown} is true or not specified, the triple
@ -1085,7 +1084,7 @@ false is ineffective, because in bottom-up mode the directories in
\begin{notice} \begin{notice}
If you pass a relative pathname, don't change the current working If you pass a relative pathname, don't change the current working
directory between resumptions of \function{walk}. \function{walk} directory between resumptions of \function{walk()}. \function{walk()}
never changes the current directory, and assumes that its caller never changes the current directory, and assumes that its caller
doesn't either. doesn't either.
\end{notice} \end{notice}
@ -1095,7 +1094,7 @@ On systems that support symbolic links, links to subdirectories appear
in \var{dirnames} lists, but \function{walk()} will not visit them in \var{dirnames} lists, but \function{walk()} will not visit them
(infinite loops are hard to avoid when following symbolic links). (infinite loops are hard to avoid when following symbolic links).
To visit linked directories, you can identify them with To visit linked directories, you can identify them with
\code{os.path.islink(\var{path})}, and invoke \function{walk(\var{path})} \code{os.path.islink(\var{path})}, and invoke \code{walk(\var{path})}
on each directly. on each directly.
\end{notice} \end{notice}