Doc fixes for save-window-excursion.

* lisp/subr.el (save-window-excursion): Doc fix.

* doc/lispref/windows.texi (Window Configurations): save-window-excursion is
now a macro.

* doc/lispref/display.texi (Temporary Displays): with-output-to-temp-buffer is
now a macro.

Fixes: debbugs:9979

2 files changed, 7 insertions, 6 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 49d67384920..b1afb033404 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2012-03-11  Chong Yidong  <cyd@gnu.org>
 
+        * subr.el (save-window-excursion): Doc fix (Bug#9979).
+
         * dabbrev.el (dabbrev--find-expansion): Update progress reporter
         when finished (Bug#10963).
 
diff --git a/lisp/subr.el b/lisp/subr.el
index 00a030c744c..866535ce882 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -3026,13 +3026,12 @@ the buffer list."
            (set-buffer ,old-buffer))))))
 
 (defmacro save-window-excursion (&rest body)
-  "Execute BODY, preserving window sizes and contents.
+  "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.
-Also restore the choice of selected window.
-Also restore which buffer is current.
-Does not restore the value of point in current buffer.
+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.
 
 BEWARE: Most uses of this macro introduce bugs.
 E.g. it should not be used to try and prevent some code from opening