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

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 201128b97571bafa7db350fb6c74bd5bfd5de734..4b4521c4323fd9c984dd4f383550189acfd21567 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,11 @@
+2012-03-11  Chong Yidong  <cyd@gnu.org>
+
+       * windows.texi (Window Configurations): save-window-excursion is
+       now a macro.
+
+       * display.texi (Temporary Displays): with-output-to-temp-buffer is
+       now a macro.
+
 2012-03-10  Eli Zaretskii  <eliz@gnu.org>
 
        * strings.texi (String Basics):

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 281ddda9ceca943cf5a6c1f7d9e1cf33b34f7a85..c70418be52b940c59b50e5a46f0564e8b230d2f0 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1031,7 +1031,7 @@ You can use a display table to substitute other text for the ellipsis
 buffer and then present it to the user for perusal rather than for
 editing.  Many help commands use this feature.
 
-@defspec with-output-to-temp-buffer buffer-name forms@dots{}
+@defmac with-output-to-temp-buffer buffer-name forms@dots{}
 This function executes @var{forms} while arranging to insert any output
 they print into the buffer named @var{buffer-name}, which is first
 created if necessary, and put into Help mode.  Finally, the buffer is
@@ -1083,7 +1083,7 @@ The value of the last form in @var{forms} is returned.
 ---------- Buffer: foo ----------
 @end group
 @end example
-@end defspec
+@end defmac
 
 @defopt temp-buffer-show-function
 If this variable is non-@code{nil}, @code{with-output-to-temp-buffer}

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 07be7fa907932794bdd8f38f15480b434e1faafd..b541b2419c8983be5e34d24aec28b7061d1e4c82 100644 (file)
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -3142,7 +3142,7 @@ as @code{save-window-excursion}:
 @end example
 @end defun
 
-@defspec save-window-excursion forms@dots{}
+@defmac save-window-excursion forms@dots{}
 This special form records the window configuration, executes @var{forms}
 in sequence, then restores the earlier window configuration.  The window
 configuration includes, for each window, the value of point and the
@@ -3179,7 +3179,7 @@ For example:
      ;; @r{The screen is now split again.}
 @end group
 @end example
-@end defspec
+@end defmac
 
 @defun window-configuration-p object
 This function returns @code{t} if @var{object} is a window configuration.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 49d673849207378e5aba82694acff37eb280411a..b1afb03340446a2ee7631c29b787867b06d0d98e 100644 (file)
--- 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 00a030c744ced791dc76e4d239f863d7b4d10c76..866535ce882827a38f9e745a4fbd9a680c5bc2ff 100644 (file)
--- 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