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> 2009-10-07 Stefan Monnier <monnier@iro.umontreal.ca>
* positions.texi (Text Lines): Remove goto-line, since it shouldn't be * 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 -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual. @c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001, @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. @c See the file elisp.texi for copying conditions.
@setfilename ../../info/windows @setfilename ../../info/windows
@node Windows, Frames, Buffers, Top @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: The following three functions return size information about a window:
@defun window-height &optional window @defun window-height &optional window
This function returns the number of lines in @var{window}, including its This function returns the number of lines in @var{window} (by default
mode line and header line, if any. If @var{window} fills its entire the selected window), including any mode line and header line.
frame except for the echo area, this is typically one less than the The result is almost always less than the value of @code{frame-height}
value of @code{frame-height} on that frame. The default for for the associated frame, because the latter also includes any echo
@var{window} is the selected window. 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 @example
@group @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). mode line (if any) or the header line (if any).
@end defun @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 @defun window-width &optional window
This function returns the number of columns in @var{window}. The This function returns the number of columns in @var{window}. The
default for @var{window} is the selected window. default for @var{window} is the selected window.