[Emacs-diffs] /srv/bzr/emacs/trunk r103497: file-truename doc fix for bug#2341.

[Glenn Morris]

------------------------------------------------------------
revno: 103497
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Thu 2011-03-03 00:10:52 -0800
message:
  file-truename doc fix for bug#2341.
  
  * lisp/files.el (file-truename): Doc fix.
  
  * doc/lispref/files.texi (Truenames): Minor clarification.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  lisp/ChangeLog
  lisp/files.el

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-03-01 03:05:28 +0000
+++ b/doc/lispref/ChangeLog     2011-03-03 08:10:52 +0000
@@ -1,3 +1,7 @@
+2011-03-03  Glenn Morris  <address@hidden>
+
+       * files.texi (Truenames): Minor clarification.  (Bug#2341)
+
 2011-03-01  Glenn Morris  <address@hidden>
 
        * variables.texi (Directory Local Variables):

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2011-02-19 19:40:59 +0000
+++ b/doc/lispref/files.texi    2011-03-03 08:10:52 +0000
@@ -1041,7 +1041,8 @@
 
 @defun file-truename filename
 The function @code{file-truename} returns the truename of the file
address@hidden  The argument must be an absolute file name.
address@hidden  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

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-03-03 07:33:35 +0000
+++ b/lisp/ChangeLog    2011-03-03 08:10:52 +0000
@@ -1,3 +1,7 @@
+2011-03-03  Glenn Morris  <address@hidden>
+
+       * files.el (file-truename): Doc fix.  (Bug#2341)
+
 2011-03-03  Bob Rogers  <address@hidden>
 
        * vc/vc-dir.el (vc-dir-mode-map): Bind vc-dir-find-file to e. (Bug#7349)

=== modified file 'lisp/files.el'
--- a/lisp/files.el     2011-03-01 04:26:38 +0000
+++ b/lisp/files.el     2011-03-03 08:10:52 +0000
@@ -983,7 +983,8 @@
       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.