* files.el (find-file-visit-truename): Doc clarification (bug#14697).

2 files changed, 7 insertions, 3 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 8a911501f0f..5169fde1a88 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2014-02-08  Lars Ingebrigtsen  <larsi@gnus.org>
 
+        * files.el (find-file-visit-truename): Doc clarification (bug#14697).
+
         * isearch.el (isearch-hide-immediately): Doc clarification
         (bug#14723).
 
diff --git a/lisp/files.el b/lisp/files.el
index a8b2a204094..3697467b3bd 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -159,9 +159,11 @@ under another name, you get the existing buffer instead of a new buffer."
   :group 'find-file)
 
 (defcustom find-file-visit-truename nil
-  "Non-nil means visit a file under its truename.
-The truename of a file is found by chasing all links
-both at the file level and at the levels of the containing directories."
+  "Non-nil means visiting a file uses its truename as the visited-file name.
+That is, the buffer visiting the file has the truename as the
+value of `buffer-file-name'.  The truename of a file is found by
+chasing all links both at the file level and at the levels of the
+containing directories."
   :type 'boolean
   :group 'find-file)
 (put 'find-file-visit-truename 'safe-local-variable 'booleanp)