mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-31 20:02:42 +00:00
Code Issues Releases Activity

(Size of Window): The relationship between window and frame heights is

Browse Source 
not so simple.  (Bug#4535)
Mention window-full-height-p.
This commit is contained in:
Glenn Morris 2009-10-10 23:43:03 +00:00
parent 6d6a5b7e51
commit 0c5413c811
2 changed files with 22 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/lispref/ChangeLog
View File

@ -1,3 +1,9 @@
2009-10-10 Glenn Morris <rgm@gnu.org>
* windows.texi (Size of Window): The relationship between window and
frame heights is not so simple. (Bug#4535)
Mention window-full-height-p.
2009-10-07 Stefan Monnier <monnier@iro.umontreal.ca>
* positions.texi (Text Lines): Remove goto-line, since it shouldn't be

22
doc/lispref/windows.texi
View File

@ -1,7 +1,8 @@
@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001,
@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
@c Free Software Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@setfilename ../../info/windows
@node Windows, Frames, Buffers, Top
@ -1945,11 +1946,14 @@ characters that separates side-by-side windows.
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 and header line, if any. If @var{window} fills its entire
frame except for the echo area, this is typically one less than the
value of @code{frame-height} on that frame. The default for
@var{window} is the selected window.
This function returns the number of lines in @var{window} (by default
the selected window), including any mode line and header line.
The result is almost always less than the value of @code{frame-height}
for the associated frame, because the latter also includes any echo
area. Depending on the toolkit in use, the frame height can also
include the menu bar and tool bar (@pxref{Size and Position}).
Therefore in general it is not straightforward to compare window and
frame heights (see @code{window-full-height-p} below).
@example
@group
@ -1972,6 +1976,12 @@ 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-full-height-p &optional window
This function returns non-@code{nil} if @var{window} is as tall as the
frame that contains it. The default for @var{window} is the selected
window.
@end defun
@defun window-width &optional window
This function returns the number of columns in @var{window}. The
default for @var{window} is the selected window.