changeset 66743:e0df9e6c3f65

Add `dedicated' arg to get-lru-window and get-largest-window.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Mon, 07 Nov 2005 21:15:17 +0000
parents f8d550ae3b06
children 3fbf09f9769f
files etc/NEWS lispref/windows.texi
diffstat 2 files changed, 11 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/etc/NEWS	Mon Nov 07 11:55:20 2005 +0000
+++ b/etc/NEWS	Mon Nov 07 21:15:17 2005 +0000
@@ -4481,6 +4481,11 @@
 *** The new function `window-tree' returns a frame's window tree.
 
 +++
+*** The functions `get-lru-window' and `get-largest-window' take an optional
+argument `dedicated'.  If non-nil, those functions do not ignore
+dedicated windows.
+
++++
 ** Customizable fringe bitmaps
 
 *** New function `define-fringe-bitmap' can now be used to create new
--- a/lispref/windows.texi	Mon Nov 07 11:55:20 2005 +0000
+++ b/lispref/windows.texi	Mon Nov 07 21:15:17 2005 +0000
@@ -488,7 +488,7 @@
   The following functions choose one of the windows on the screen,
 offering various criteria for the choice.
 
-@defun get-lru-window &optional frame
+@defun get-lru-window &optional frame dedicated
 This function returns the window least recently ``used'' (that is,
 selected).  If any full-width windows are present, it only considers
 these.  The selected window is always the most recently used window.
@@ -496,7 +496,8 @@
 The selected window can be the least recently used window if it is the
 only window.  A newly created window becomes the least recently used
 window until it is selected.  A minibuffer window is never a
-candidate.  Dedicated windows are never candidates, and if all
+candidate.  Dedicated windows are never candidates unless the
+@var{dedicated} argument is non-@code{nil}, so if all
 existing windows are dedicated, the value is @code{nil}.
 
 The argument @var{frame} controls which windows are considered.
@@ -515,11 +516,12 @@
 @end itemize
 @end defun
 
-@defun get-largest-window &optional frame
+@defun get-largest-window &optional frame dedicated
 This function returns the window with the largest area (height times
 width).  If there are no side-by-side windows, then this is the window
 with the most lines.  A minibuffer window is never a candidate.
-Dedicated windows are never candidates, and if all existing windows
+Dedicated windows are never candidates unless the
+@var{dedicated} argument is non-@code{nil}, so if all existing windows
 are dedicated, the value is @code{nil}.
 
 If there are two candidate windows of the same size, this function