summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libos.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2003-04-25 14:50:06 (GMT)
committerFred Drake <fdrake@acm.org>2003-04-25 14:50:06 (GMT)
commit2194a4eedef22a8319e5dea6de409fd582db4b97 (patch)
tree6253e262e7403d492131a284e1d2a94771629e6e /Doc/lib/libos.tex
parent1448d4719ca5db5580de461944a8d5da20c30888 (diff)
downloadcpython-2194a4eedef22a8319e5dea6de409fd582db4b97.zip
cpython-2194a4eedef22a8319e5dea6de409fd582db4b97.tar.gz
cpython-2194a4eedef22a8319e5dea6de409fd582db4b97.tar.bz2
markup adjustments
Diffstat (limited to 'Doc/lib/libos.tex')
-rw-r--r--Doc/lib/libos.tex9
1 files changed, 4 insertions, 5 deletions
diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index e0a43eb..760d13a 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -1050,10 +1050,9 @@ which is used to set the access and modified times, respectively.
Availability: Macintosh, \UNIX, Windows.
\end{funcdesc}
-\begin{funcdesc}{walk}{top\optional{, topdown=True}}
+\begin{funcdesc}{walk}{top\optional{, topdown\code{=True}}}
\index{directory!walking}
\index{directory!traversal}
-
\function{walk()} generates the file names in a directory tree.
For each directory in the tree rooted at directory \var{top} (including
\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
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
-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})}.
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}
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
doesn't either.
\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
(infinite loops are hard to avoid when following symbolic links).
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.
\end{notice}