From: Richard M. Stallman <rms@gnu.org>
Date: Wed, 6 Aug 2003 01:12:25 +0000 (+0000)
Subject: (Buffer File Name): set-visited-file-name renames the buffer too.
X-Git-Tag: ttn-vms-21-2-B4~9159
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=4da34f1e740e52b6264a15dacf7442057cf941ca;p=emacs.git

(Buffer File Name): set-visited-file-name renames the buffer too.
---

diff --git a/lispref/buffers.texi b/lispref/buffers.texi
index 8bfbf755a29..d97ae101995 100644
--- a/lispref/buffers.texi
+++ b/lispref/buffers.texi
@@ -444,10 +444,13 @@ such buffer in the buffer list.
 If @var{filename} is a non-empty string, this function changes the
 name of the file visited in the current buffer to @var{filename}.  (If the
 buffer had no visited file, this gives it one.)  The @emph{next time}
-the buffer is saved it will go in the newly-specified file.  This
-command marks the buffer as modified, since it does not (as far as Emacs
-knows) match the contents of @var{filename}, even if it matched the
-former visited file.
+the buffer is saved it will go in the newly-specified file.
+
+This command marks the buffer as modified, since it does not (as far
+as Emacs knows) match the contents of @var{filename}, even if it
+matched the former visited file.  It also renames the buffer to
+correspond to the new file name, unless the new name is already in
+use.
 
 If @var{filename} is @code{nil} or the empty string, that stands for
 ``no visited file''.  In this case, @code{set-visited-file-name} marks