(with-selected-frame): Mention that the selected frame is restored.

Fixes: debbugs:9980

2 files changed, 6 insertions, 2 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 430ac16841e..d0ab5d2f2f9 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2012-01-07  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+        * subr.el (with-selected-frame): Mention that the selected frame
+        is restored (bug#9980).
+
         * ibuffer.el (ibuffer-mode): List the bindings in the corrent map
         (bug#9759).
 
diff --git a/lisp/subr.el b/lisp/subr.el
index 15665e4ee24..14f9192405c 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -2983,8 +2983,9 @@ the buffer list ordering."
   "Execute the forms in BODY with FRAME as the selected frame.
 The value returned is the value of the last form in BODY.
 
-This macro neither changes the order of recently selected windows
-nor the buffer list."
+This macro saves and restores the selected frame, and changes the
+order of neither the recently selected windows nor the buffers in
+the buffer list."
   (declare (indent 1) (debug t))
   (let ((old-frame (make-symbol "old-frame"))
         (old-buffer (make-symbol "old-buffer")))