From 545092b063e235bb81706a296ed18618d4293b87 Mon Sep 17 00:00:00 2001
From: Steve Holden <steve@holdenweb.com>
Date: Tue, 6 Aug 2002 16:07:07 +0000
Subject: [PATCH] Add comment about os.path.walk()'s behavior with symbolic
 links.

---
 Doc/lib/libposixpath.tex | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 4bbb5b6e569..d19544732b0 100644
--- a/Doc/lib/libposixpath.tex
+++ b/Doc/lib/libposixpath.tex
@@ -214,4 +214,9 @@ influence the set of directories visited below \var{dirname}, e.g., to
 avoid visiting certain parts of the tree.  (The object referred to by
 \var{names} must be modified in place, using \keyword{del} or slice
 assignment.)
+
+Note that symbolic links to directories are not treated as subdirectories,
+and that \var{walk} therefore will not visit them. To visit linked
+directories you must identify them with \var{os.path.islink(file)} and
+\var{os.path.isdir(file)}, and invoke \function{walk()} as necessary.
 \end{funcdesc}