emacs-31 884d7a198c9: Document new option 'delete-frame-choose-selected' (Bug#80397)

branch: emacs-31
commit 884d7a198c9eff1cf0a9cc6e2a021f7d82cb57c6
Author: Martin Rudalics <[email protected]>
Commit: Martin Rudalics <[email protected]>

    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.
---
 doc/lispref/frames.texi | 12 ++++++++++++
 etc/NEWS                |  4 ++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 56acd7c6ee9..571f38ed95c 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -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
diff --git a/etc/NEWS b/etc/NEWS
index 6b2abe30aaa..11128422af9 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -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