emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

emacs-27 e5ca8e5: Fix Elisp manual entry on 'set-window-configuration'


From: Martin Rudalics
Subject: emacs-27 e5ca8e5: Fix Elisp manual entry on 'set-window-configuration'
Date: Wed, 15 Apr 2020 04:19:24 -0400 (EDT)

branch: emacs-27
commit e5ca8e5e73acbe9147203d1365365626fc35441e
Author: Martin Rudalics <address@hidden>
Commit: Martin Rudalics <address@hidden>

    Fix Elisp manual entry on 'set-window-configuration'
    
    * doc/lispref/windows.texi (Window Configurations): Fix
    description of 'set-window-configuration'.
---
 doc/lispref/windows.texi | 39 ++++++++++++++++++++-------------------
 1 file changed, 20 insertions(+), 19 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index c9301c9..a19f123 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -5861,25 +5861,26 @@ which window parameters (if any) are saved by this 
function.
 
 @defun set-window-configuration configuration
 This function restores the configuration of windows and buffers as
-specified by @var{configuration}, for the frame that @var{configuration}
-was created for.
-
-The argument @var{configuration} must be a value that was previously
-returned by @code{current-window-configuration}.  The configuration is
-restored in the frame from which @var{configuration} was made, whether
-that frame is selected or not.  In some rare cases this may trigger
-execution of the @code{window-size-change-functions} (@pxref{Window
-Hooks}) even if the size of windows did not change at all.  The
-@code{window-configuration-change-hook} functions will be called if and
-only if at least one window was added to or deleted from the frame.
-
-If the frame from which @var{configuration} was saved is dead, all this
-function does is restore the three variables @code{window-min-height},
-@code{window-min-width} and @code{minibuffer-scroll-window}.  In this
-case, the function returns @code{nil}.  Otherwise, it returns @code{t}.
-
-Here is a way of using this function to get the same effect
-as @code{save-window-excursion}:
+specified by @var{configuration}, for the frame that
+@var{configuration} was created for, regardless of whether that frame
+is selected or not.  The argument @var{configuration} must be a value
+that was previously returned by @code{current-window-configuration}
+for that frame.
+
+If the frame from which @var{configuration} was saved is dead, all
+this function does is to restore the value of the variable
+@code{minibuffer-scroll-window} and to adjust the value returned by
+@code{minibuffer-selected-window}.  In this case, the function returns
+@code{nil}.  Otherwise, it returns @code{t}.
+
+If the buffer of a window of @var{configuration} has been killed since
+@var{configuration} was made, that window is, as a rule, removed from
+the restored configuration.  However, if that window is the last
+window remaining in the restored configuration, another live buffer is
+shown in it.
+
+Here is a way of using this function to get the same effect as
+@code{save-window-excursion}:
 
 @example
 @group



reply via email to

[Prev in Thread] Current Thread [Next in Thread]