[Python-checkins] r50950 - python/trunk/Doc/lib/libposixpath.tex

[andrew.kuchling]

Author: andrew.kuchling
Date: Sat Jul 29 21:50:37 2006
New Revision: 50950

Modified:
   python/trunk/Doc/lib/libposixpath.tex
Log:
[Patch #1068277] Clarify that os.path.exists() can return False depending on permissions.  Fred approved committing this patch in December 2004!

Modified: python/trunk/Doc/lib/libposixpath.tex
==============================================================================
--- python/trunk/Doc/lib/libposixpath.tex	(original)
+++ python/trunk/Doc/lib/libposixpath.tex	Sat Jul 29 21:50:37 2006
@@ -42,8 +42,11 @@
 \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}