[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/files.texi
From: |
Richard M. Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/files.texi |
Date: |
Tue, 24 Jun 2003 14:16:37 -0400 |
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