From: Chong Yidong <cyd@gnu.org>
Date: Sun, 11 Mar 2012 16:16:50 +0000 (+0800)
Subject: Further doc fix for save-window-excursion.
X-Git-Tag: emacs-pretest-24.0.05~102
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d3760c4b0ad02dd26225f6886611940ab281bd27;p=emacs.git

Further doc fix for save-window-excursion.
---

diff --git a/lisp/subr.el b/lisp/subr.el
index 866535ce882..e0b099dd16b 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3027,11 +3027,11 @@ the buffer list."
 
 (defmacro save-window-excursion (&rest body)
   "Execute BODY, then restore previous window configuration.
-Return the value of the last form in BODY.
-Restore which buffer appears in which window, where display
-starts, and the value of point and mark for each window, as well
-as the choice of selected window, and which buffer is current.
-The value of point in the current buffer is not restored.
+This macro saves the window configuration on the selected frame,
+executes BODY, then calls `set-window-configuration' to restore
+the saved window configuration.  The return value is the last
+form in BODY.  The window configuration is also restored if BODY
+exits nonlocally.
 
 BEWARE: Most uses of this macro introduce bugs.
 E.g. it should not be used to try and prevent some code from opening