From: Andrew M. Kuchling <amk@amk.ca>
Date: Sat, 29 Jul 2006 19:50:37 +0000 (+0000)
Subject: [Patch #1068277] Clarify that os.path.exists() can return False depending on permissi... 
X-Git-Tag: v2.5b3~71
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9964fdb466d7338c37e30b302d42bb0df697d234;p=python

[Patch #1068277] Clarify that os.path.exists() can return False depending on permissions.  Fred approved committing this patch in December 2004!
---

diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 9f0de1f14f..b9cdea1c58 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}