Mention which window gets selected when deleting the selected window.

* windows.texi (Deleting Windows): Mention which window gets selected
when deleting the selected window.

2 files changed, 10 insertions, 2 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index f822b4bebdf..fa5aac6e9ec 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-10-11  Martin Rudalics  <rudalics@gmx.at>
+
+        * windows.texi (Deleting Windows): Mention which window gets
+        selected when deleting the selected window.
+
 2011-10-09  Martin Rudalics  <rudalics@gmx.at>
 
         * buffers.texi (The Buffer List): Describe how bury-buffer deals
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 41ccbaafd49..9dd03027ee2 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -1608,7 +1608,9 @@ This function removes @var{window} from display and returns @code{nil}.
 The argument @var{window} can denote any window and defaults to the
 selected one.  An error is signaled if @var{window} is the only window
 on its frame.  Hence @var{window} must have at least one sibling window
-(@pxref{Windows and Frames}) in order to get deleted.
+(@pxref{Windows and Frames}) in order to get deleted.  If @var{window}
+is the selected window on its frame, this function selects the most
+recently selected live window on that frame instead.
 
 If the variable @code{ignore-window-parameters} (@pxref{Window
 Parameters}) is non-@code{nil}, this function ignores all parameters of
@@ -1629,7 +1631,8 @@ combination.
 @deffn Command delete-other-windows &optional window
 This function makes @var{window} fill its frame and returns @code{nil}.
 The argument @var{window} can denote an arbitrary window and defaults to
-the selected one.
+the selected one.  Upon exit, @var{window} will be the selected window
+on its frame.
 
 If the variable @code{ignore-window-parameters} (@pxref{Window
 Parameters}) is non-@code{nil}, this function ignores all parameters of