summaryrefslogtreecommitdiff
path: root/doc/lispref/windows.texi
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2020-04-15 07:50:15 -0700
committerGlenn Morris <rgm@gnu.org>2020-04-15 07:50:15 -0700
commit97e48510ad4fec9ca5f576a750018a231523f7a6 (patch)
tree06f50ebc5da12038bc4851b44946462a498ac755 /doc/lispref/windows.texi
parentafa542c914379538f986f1428f176ffe42f62609 (diff)
parenta5f7c269075180e4531f0a784201a09b49731a27 (diff)
downloademacs-97e48510ad4fec9ca5f576a750018a231523f7a6.tar.gz
emacs-97e48510ad4fec9ca5f576a750018a231523f7a6.tar.bz2
emacs-97e48510ad4fec9ca5f576a750018a231523f7a6.zip
Merge from origin/emacs-27
a5f7c26907 (origin/emacs-27) * admin/authors.el: Add an author alias. d87a4d1f4e Limit RLIMIT_NOFILE to FD_SETSIZE on macOS e5ca8e5e73 Fix Elisp manual entry on 'set-window-configuration' 485f24223f ; Update ChangeLog.3 8f200254fb ; Update etc/AUTHORS c7adc851ad * admin/authors.el: Add missing author aliases. 4acdd7fe58 Fix edge case errors in filename-matching regexps 5f36e21fe5 Clarify the doc string of 'yank' 13301d4266 New function erc-track-switch-buffer-other-window 38f7538d8f New function erc-switch-to-buffer-other-window # Conflicts: # etc/NEWS
Diffstat (limited to 'doc/lispref/windows.texi')
-rw-r--r--doc/lispref/windows.texi39
1 files changed, 20 insertions, 19 deletions
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index af2f3acd467..5ec23a9c876 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -5871,25 +5871,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