emacs-31 4721a44e8ab: ; * doc/lispref/buffers.texi (Buffer File Name): Clarify (bug#81340).

branch: emacs-31
commit 4721a44e8ab2bac275611403118d3101dda8d382
Author: Eli Zaretskii <[email protected]>
Commit: Eli Zaretskii <[email protected]>

    ; * doc/lispref/buffers.texi (Buffer File Name): Clarify (bug#81340).
---
 doc/lispref/buffers.texi | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 054efba9ae1..33fab9e89bc 100644
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -391,7 +391,7 @@ the buffer name are distinct and can be set independently.
 @xref{Visiting Files}.
 
 @defun buffer-file-name &optional buffer
-This function returns the absolute file name of the file that
+This function returns the fully-expanded absolute file name of the file that
 @var{buffer} is visiting.  If @var{buffer} is not visiting any file,
 @code{buffer-file-name} returns @code{nil}.  If @var{buffer} is not
 supplied, it defaults to the current buffer.
@@ -405,10 +405,11 @@ supplied, it defaults to the current buffer.
 @end defun
 
 @defvar buffer-file-name
-This buffer-local variable contains the name of the file being visited
+This buffer-local variable contains the absolute name of the file being visited
 in the current buffer, or @code{nil} if it is not visiting a file.  It
 is a permanent local variable, unaffected by
-@code{kill-all-local-variables}.
+@code{kill-all-local-variables}.  The value is identical to the one
+which the @code{buffer-file-name} function returns.
 
 @example
 @group