# HG changeset patch # User Glenn Morris # Date 1255219625 0 # Node ID 2ee9eaa0490b7f1f03616f59cde78ba32537abed # Parent c9f6575e6f192b8f6b99c7b0394538cfcf6f4c4a (Size and Position): Clarify what is included in the frame height. (Bug#4535) diff -r c9f6575e6f19 -r 2ee9eaa0490b doc/lispref/ChangeLog --- a/doc/lispref/ChangeLog Sun Oct 11 00:01:11 2009 +0000 +++ b/doc/lispref/ChangeLog Sun Oct 11 00:07:05 2009 +0000 @@ -1,3 +1,8 @@ +2009-10-11 Glenn Morris + + * frames.texi (Size and Position): Clarify what is included in the frame + height. (Bug#4535) + 2009-10-10 Glenn Morris * windows.texi (Size of Window): The relationship between window and diff -r c9f6575e6f19 -r 2ee9eaa0490b doc/lispref/frames.texi --- a/doc/lispref/frames.texi Sun Oct 11 00:01:11 2009 +0000 +++ b/doc/lispref/frames.texi Sun Oct 11 00:07:05 2009 +0000 @@ -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/frames @node Frames, Positions, Windows, Top @@ -980,12 +981,17 @@ @defunx frame-pixel-width &optional frame These functions return the height and width of the main display area of @var{frame}, measured in pixels. If you don't supply @var{frame}, -they use the selected frame. - -These values include the internal borders, and windows' scroll bars -and fringes (which belong to individual windows, not to the frame -itself), but do not include menu bars or tool bars (except when using -X without an X toolkit). +they use the selected frame. For a text-only terminal, the results are +in characters rather than pixels. + +These values include the internal borders, and windows' scroll bars and +fringes (which belong to individual windows, not to the frame itself). +The exact value of the heights depends on the window-system and toolkit +in use. With Gtk+, the height does not include any tool bar or menu +bar. With the Motif or Lucid toolkits, it includes the tool bar but +not the menu bar. In a graphical version with no toolkit, it includes +both the tool bar and menu bar. For a text-only terminal, the result +includes the menu bar. @end defun @defun frame-char-height &optional frame