From 9964fdb466d7338c37e30b302d42bb0df697d234 Mon Sep 17 00:00:00 2001
From: "Andrew M. Kuchling" <amk@amk.ca>
Date: Sat, 29 Jul 2006 19:50:37 +0000
Subject: [PATCH] [Patch #1068277] Clarify that os.path.exists() can return
 False depending on permissions.  Fred approved committing this patch in
 December 2004!

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

diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 9f0de1f14f5..b9cdea1c58a 100644
--- a/Doc/lib/libposixpath.tex
+++ b/Doc/lib/libposixpath.tex
@@ -42,8 +42,11 @@ half of the pair returned by \code{split(\var{path})}.
 \end{funcdesc}
 
 \begin{funcdesc}{exists}{path}
-Return \code{True} if \var{path} refers to an existing path.
-Returns \code{False} for broken symbolic links.
+Return \code{True} if \var{path} refers to an existing path.  Returns
+\code{False} for broken symbolic links. On some platforms, this
+function may return \code{False} if permission is not granted to
+execute \function{os.stat()} on the requested file, even if the
+\var{path} physically exists.
 \end{funcdesc}
 
 \begin{funcdesc}{lexists}{path}