file-truename doc fix for bug#2341.

* lisp/files.el (file-truename): Doc fix.

* doc/lispref/files.texi (Truenames): Minor clarification.
This commit is contained in:
Glenn Morris 2011-03-03 00:10:52 -08:00
parent b612ffc94d
commit 06083aa12d
4 changed files with 12 additions and 2 deletions

View file

@ -1,3 +1,7 @@
2011-03-03 Glenn Morris <rgm@gnu.org>
* files.texi (Truenames): Minor clarification. (Bug#2341)
2011-03-01 Glenn Morris <rgm@gnu.org>
* variables.texi (Directory Local Variables):

View file

@ -1041,7 +1041,8 @@ because they eliminate symbolic links as a cause of name variation.
@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.
@var{filename}. If the argument is not an absolute file name,
this function first expands it against @code{default-directory}.
This function does not expand environment variables. Only
@code{substitute-in-file-name} does that. @xref{Definition of

View file

@ -1,3 +1,7 @@
2011-03-03 Glenn Morris <rgm@gnu.org>
* files.el (file-truename): Doc fix. (Bug#2341)
2011-03-03 Bob Rogers <rogers-emacs@rgrjr.dyndns.org>
* vc/vc-dir.el (vc-dir-mode-map): Bind vc-dir-find-file to e. (Bug#7349)

View file

@ -983,7 +983,8 @@ accessible."
nil)))
(defun file-truename (filename &optional counter prev-dirs)
"Return the truename of FILENAME, which should be absolute.
"Return the truename of FILENAME.
If FILENAME is not absolute, first expands it against `default-directory'.
The truename of a file name is found by chasing symbolic links
both at the level of the file and at the level of the directories
containing it, until no links are left at any level.