[Emacs-diffs] Changes to emacs/lispref/files.texi

[Richard M. Stallman]

Index: emacs/lispref/files.texi
diff -c emacs/lispref/files.texi:1.50 emacs/lispref/files.texi:1.51
*** emacs/lispref/files.texi:1.50       Fri Jun 13 04:39:58 2003
--- emacs/lispref/files.texi    Tue Jun 24 14:16:37 2003
***************
*** 717,731 ****
    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.)
  
  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}.
  @end defun
  
  @defun file-readable-p filename
--- 717,737 ----
    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.)
  
  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,1482 ****
  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
  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
--- 1482,1488 ----
  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 address@hidden, 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