comparison lispref/files.texi @ 52003:0509fad02151

(Truenames): Add LIMIT arg to file-chase-links.

52002:26d4153f70a1

@defun file-truename filename
The function @code{file-truename} returns the truename of the file
@var{filename}.  The argument must be an absolute file name.
@end defun

@defun file-chase-links filename
This function follows symbolic links, starting with @var{filename},
until it finds a file name which is not the name of a symbolic link.
Then it returns that file name.
@end defun

  To illustrate the difference between @code{file-chase-links} and
@code{file-truename}, suppose that @file{/usr/foo} is a symbolic link to
the directory @file{/home/foo}, and @file{/home/foo/hello} is an

52003:0509fad02151

@defun file-truename filename
The function @code{file-truename} returns the truename of the file
@var{filename}.  The argument must be an absolute file name.
@end defun

@defun file-chase-links filename &optional limit
This function follows symbolic links, starting with @var{filename},
until it finds a file name which is not the name of a symbolic link.
Then it returns that file name.  If you specify a number for
@var{limit}, then after chasing through that many links, the function
just returns what it as even if that is still a symbolic link.
@end defun

  To illustrate the difference between @code{file-chase-links} and
@code{file-truename}, suppose that @file{/usr/foo} is a symbolic link to
the directory @file{/home/foo}, and @file{/home/foo/hello} is an