* lisp/window.el (switch-to-buffer): Re-add the warning that was lost in the

code rewrite.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index a6fdf7e..85e7624 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2012-11-19  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+       * window.el (switch-to-buffer): Re-add the warning that was lost in the
+       code rewrite.
+
 2012-11-18  Paul Eggert  <eggert@cs.ucla.edu>
 
        More minor time fixes.

diff --git a/lisp/window.el b/lisp/window.el
index d378ea5..52909fa 100644 (file)
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -5870,7 +5870,12 @@ the selected window or never appeared in it before, or if
   :version "24.3")
 
 (defun switch-to-buffer (buffer-or-name &optional norecord force-same-window)
-  "Switch to buffer BUFFER-OR-NAME in the selected window.
+  "Display buffer BUFFER-OR-NAME in the selected window.
+
+WARNING: This is NOT the way to work on another buffer temporarily
+within a Lisp program!  Use `set-buffer' instead.  That avoids
+messing with the window-buffer correspondences.
+
 If the selected window cannot display the specified
 buffer (e.g. if it is a minibuffer window or strongly dedicated
 to another buffer), call `pop-to-buffer' to select the buffer in