[Emacs-diffs] Changes to emacs/doc/lispref/windows.texi,v

[Martin Rudalics]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Martin Rudalics <m061211>       08/10/18 18:07:09

Index: windows.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/windows.texi,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- windows.texi        18 Oct 2008 16:33:17 -0000      1.8
+++ windows.texi        18 Oct 2008 18:07:09 -0000      1.9
@@ -400,7 +400,9 @@
 space.  If all windows in some frame are showing @var{buffer-or-name}
 (including the case where there is only one window), then the frame
 winds up with a single window showing another buffer chosen with
address@hidden  @xref{The Buffer List}.
address@hidden  @xref{The Buffer List}.  If, however, that window
+is dedicated and there are other frames left, the window's frame is
+deleted.
 
 The argument @var{frame} controls which frames to operate on.  This
 function does not use it in quite the same way as the other functions
@@ -893,12 +895,18 @@
 @end defun
 
 @deffn Command replace-buffer-in-windows buffer-or-name
-This function replaces @var{buffer-or-name} with some other buffer in all
-windows displaying it.  It chooses the other buffer with
+This function replaces @var{buffer-or-name} with some other buffer in
+all windows displaying it.  It chooses the other buffer with
 @code{other-buffer}.  In the usual applications of this function, you
 don't care which other buffer is used; you just want to make sure that
 @var{buffer-or-name} is no longer displayed.
 
+If a window displaying @var{buffer-or-name} is dedicated and the window
+is not the only window on its frame, that window is deleted.  If the
+window is the only window on its frame and there are other frames left,
+the window's frame is deleted too.  If there are no other frames left,
+some other buffer is displayed in that window.
+
 This function returns @code{nil}.
 @end deffn
 
@@ -1178,9 +1186,19 @@
 @cindex dedicated window
 A window can be marked as ``dedicated'' to its buffer.  Then
 @code{display-buffer} will not try to use that window to display any
-other buffer.
+other buffer.  @code{set-window-buffer} will throw an error when asked
+to display another buffer in it.  Both, @code{get-lru-window} and
address@hidden do not consider dedicated windows as
+candidates when their @var{dedicated} argument is address@hidden
+
+When @code{delete-windows-on} deletes a dedicated window and that window
+is the only window on its frame, it will delete that frame as well when
+there are other frames left.  @code{replace-buffer-in-windows} deletes
+any dedicated window showing its buffer argument.  When such a window is
+the only window on its frame, that frame is deleted too when there are
+other frames left.
 
address@hidden window-dedicated-p window
address@hidden window-dedicated-p &optional window
 This function returns address@hidden if @var{window} is marked as
 dedicated; otherwise @code{nil}.
 @end defun