changeset 42819:401375284bf0

Clarify how window-height relates to other things. Describe window-body-height.
author Richard M. Stallman <rms@gnu.org>
date Fri, 18 Jan 2002 05:44:13 +0000
parents 55ed8ccce828
children 6477316b4dd9
files lispref/windows.texi
diffstat 1 files changed, 11 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/windows.texi	Fri Jan 18 05:42:23 2002 +0000
+++ b/lispref/windows.texi	Fri Jan 18 05:44:13 2002 +0000
@@ -1647,10 +1647,11 @@
   The following three functions return size information about a window:
 
 @defun window-height &optional window
-This function returns the number of lines in @var{window}, including its
-mode line.  If @var{window} fills its entire frame, this is typically
-one less than the value of @code{frame-height} on that frame (since the
-last line is always reserved for the minibuffer).
+This function returns the number of lines in @var{window}, including
+its mode line and header line, if any.  If @var{window} fills its
+entire frame except for the echo area, and there is no tool bar, this
+is typically one less than the value of @code{frame-height} on that
+frame.
 
 If @var{window} is @code{nil}, the function uses the selected window.
 
@@ -1670,6 +1671,12 @@
 @end example
 @end defun
 
+@tindex window-body-height
+@defun window-body-height &optional window
+Like @code{window-height} but the value does not include the 
+mode line (if any) or the header line (if any).
+@end defun
+
 @defun window-width &optional window
 This function returns the number of columns in @var{window}.  If
 @var{window} fills its entire frame, this is the same as the value of