diff options
author | Glenn Morris <rgm@gnu.org> | 2020-04-15 07:50:15 -0700 |
---|---|---|
committer | Glenn Morris <rgm@gnu.org> | 2020-04-15 07:50:15 -0700 |
commit | 97e48510ad4fec9ca5f576a750018a231523f7a6 (patch) | |
tree | 06f50ebc5da12038bc4851b44946462a498ac755 /doc/lispref/windows.texi | |
parent | afa542c914379538f986f1428f176ffe42f62609 (diff) | |
parent | a5f7c269075180e4531f0a784201a09b49731a27 (diff) | |
download | emacs-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.texi | 39 |
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 |