Document new option 'delete-frame-choose-selected' (Bug#80397)

* doc/lispref/frames.texi (Deleting Frames): Document new option
'delete-frame-choose-selected'.
* etc/NEWS: Mark 'delete-frame-choose-selected', 'split-frame'
and 'merge-frames' as documented.
This commit is contained in:
Martin Rudalics 2026-06-24 10:09:47 +02:00
parent f0bfa33039
commit 884d7a198c
2 changed files with 14 additions and 2 deletions

View file

@ -2991,6 +2991,18 @@ for example, deleting a frame during a drag-and-drop operation
the @code{delete-frame} call in a @code{condition-case} form.
@end defun
When the selected frame gets deleted Emacs has to select another frame
instead. The following option lets you choose which one.
@defopt delete-frame-choose-selected
This variable specifies which frame to select after deleting the
selected frame. The default value @code{mru} means @code{delete-frame}
should try to select the most recently used frame as returned by
@code{get-mru-frame} (@pxref{Input Focus}) on the same terminal. The
value @code{nil} means that @code{delete-frame} will try to select the
oldest visible frame on the same terminal as the deleted one.
@end defvar
@node Finding All Frames
@section Finding All Frames

View file

@ -519,7 +519,7 @@ same terminal as the selected frame. Child frames can be excluded. A
single frame can be excluded, for example, the selected frame.
'get-mru-frame' returns the single most recently used frame.
---
+++
*** After deleting, 'delete-frame' now selects the most recently used frame.
Previously, after deleting a specified frame, 'delete-frame' would
select the oldest visible frame on the same terminal. To revert to the
@ -550,7 +550,7 @@ the corresponding frame parameters 'width', 'height', 'left' and 'top'.
'set-frame-size-and-position-pixelwise' is similar but has a more
restricted set of values for specifying size and position.
---
+++
*** New commands 'split-frame' and 'merge-frames'.
'split-frame' moves a specified number of windows from an existing frame
to a newly-created frame. 'merge-frames' merges all windows from two