(with-selected-window): Doc fix.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 5b661fd3b10695d544936a8ba0fce7f83623e7b4..c72237eec3615af78825bbb3a4ff11fd96f0f6ad 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2004-07-12  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * subr.el (with-selected-window): Doc fix.
+
 2004-07-11  Luc Teirlinck  <teirllm@auburn.edu>
 
        * subr.el (get-buffer-window-list): Doc fix.

diff --git a/lisp/subr.el b/lisp/subr.el
index f2c643b669004b371dca5543acbc0ae76112422e..9dd1e4152120054df5a0bf3df25524976f668ad3 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -1799,6 +1799,12 @@ See also `with-temp-buffer'."
   "Execute the forms in BODY with WINDOW as the selected window.
 The value returned is the value of the last form in BODY.
 This does not alter the buffer list ordering.
+This function saves and restores the selected window, as well as
+the selected window in each frame.  If the previously selected
+window of some frame is no longer live at the end of BODY, that
+frame's selected window is left alone.  If the selected window is
+no longer live, then whatever window is selected at the end of
+BODY remains selected.
 See also `with-temp-buffer'."
   (declare (indent 1) (debug t))
   ;; Most of this code is a copy of save-selected-window.