* lisp/files.el (rename-uniquely): Doc fix. (Bug#3806)

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 254e1226a07aaed54cf09b3eec90c69eb1a39b52..7a3f15d42f7db3b34198b0f37d28915416c6b1a6 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2012-02-09  Glenn Morris  <rgm@gnu.org>
 
+       * files.el (rename-uniquely): Doc fix.  (Bug#3806)
+
        * progmodes/cc-guess.el (c-guess-offset-threshold, c-guess-region-max):
        Add :version tags.
 

diff --git a/lisp/files.el b/lisp/files.el
index 8a65bc5f81f5caae9617d436c19e74c58870f6d0..7bb4409822339e6561ac94c1cf4dc7a2e8fbe7df 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -4863,7 +4863,13 @@ like `write-region' does."
 (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)))