From b3910238f46c7093304354adea3870dc25afb68f Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Mon, 7 Nov 2005 21:15:17 +0000 Subject: [PATCH] Add `dedicated' arg to get-lru-window and get-largest-window. --- etc/NEWS | 5 +++++ lispref/windows.texi | 10 ++++++---- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/etc/NEWS b/etc/NEWS index ef4b8529e9e..b39a2350309 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -4480,6 +4480,11 @@ and scroll-bar settings. +++ *** 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 diff --git a/lispref/windows.texi b/lispref/windows.texi index 0ca7d69c9f9..56ec80b9a24 100644 --- a/lispref/windows.texi +++ b/lispref/windows.texi @@ -488,7 +488,7 @@ selected window and current buffer. It is just like 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 @@ these. The selected window is always the most recently used window. 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 @@ If it is a frame, consider windows on that frame. @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 -- 2.39.2