[Emacs-diffs] /srv/bzr/emacs/trunk r107213: * lisp/files.el (rename-uniquely): Doc fix. (Bug#3806)

[Glenn Morris]

------------------------------------------------------------
revno: 107213
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Thu 2012-02-09 15:27:54 -0500
message:
  * lisp/files.el (rename-uniquely): Doc fix.  (Bug#3806)
modified:
  lisp/ChangeLog
  lisp/files.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2012-02-09 07:59:13 +0000
+++ b/lisp/ChangeLog    2012-02-09 20:27:54 +0000
@@ -1,5 +1,7 @@
 2012-02-09  Glenn Morris  <address@hidden>
 
+       * files.el (rename-uniquely): Doc fix.  (Bug#3806)
+
        * progmodes/cc-guess.el (c-guess-offset-threshold, c-guess-region-max):
        Add :version tags.
 

=== modified file 'lisp/files.el'
--- a/lisp/files.el     2012-02-04 22:04:12 +0000
+++ b/lisp/files.el     2012-02-09 20:27:54 +0000
@@ -4863,7 +4863,13 @@
 (defun rename-uniquely ()
   "Rename current buffer to a similar name not already taken.
 This function is useful for creating multiple shell process buffers
-or multiple mail buffers, etc."
+or multiple mail buffers, etc.
+
+Note that some commands, in particular those based on `compilation-mode'
+\(`compile', `grep', etc.) will reuse the current buffer if it has the
+appropriate mode even if it has been renamed.  So as well as renaming
+the buffer, you also need to switch buffers before running another
+instance of such commands."
   (interactive)
   (save-match-data
     (let ((base-name (buffer-name)))