# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1056478597 0
# Node ID 24b62b8f3def3ee14e7b5a42dcfe81bb426a0e93
# Parent  a14e8c97cfb9cdc047592f5f33c0a156fdefb01a
Fix minor Texinfo usage.
(file-exists-p): Explain handling of directories, symlinks, etc.

diff -r a14e8c97cfb9 -r 24b62b8f3def lispref/files.texi
--- a/lispref/files.texi	Tue Jun 24 18:15:25 2003 +0000
+++ b/lispref/files.texi	Tue Jun 24 18:16:37 2003 +0000
@@ -717,15 +717,21 @@
   These functions test for permission to access a file in specific ways.
 
 @defun file-exists-p filename
-This function returns @code{t} if a file named @var{filename} appears to
-exist.  This does not mean you can necessarily read the file, only that
-you can find out its attributes.  (On Unix and GNU/Linux, this is true
-if the file exists and you have execute permission on the containing
-directories, regardless of the protection of the file itself.)
+This function returns @code{t} if a file named @var{filename} appears
+to exist.  This does not mean you can necessarily read the file, only
+that you can find out its attributes.  (On Unix and GNU/Linux, this is
+true if the file exists and you have execute permission on the
+containing directories, regardless of the protection of the file
+itself.)
 
 If the file does not exist, or if fascist access control policies
 prevent you from finding the attributes of the file, this function
 returns @code{nil}.
+
+Directories are files, so @code{file-exists-p} returns @code{t} when
+given a directory name.  However, symbolic links are treated
+specially; @code{file-exists-p} returns @code{t} for a symbolic link
+name only if the target file exists.
 @end defun
 
 @defun file-readable-p filename
@@ -1476,7 +1482,7 @@
 This function returns @var{filename}'s final ``extension,'' if any,
 after applying @code{file-name-sans-versions} to remove any
 version/backup part.  It returns @code{nil} for extensionless file
-names such as @file{foo}.  If @var{period} is non-nil, then the
+names such as @file{foo}.  If @var{period} is non-@code{nil}, then the
 returned value includes the period that delimits the extension, and if
 @var{filename} has no extension, the value is @code{""}.  If the last
 component of a file name begins with a @samp{.}, that @samp{.} doesn't