Mercurial > emacs

changeset 105546:2ee9eaa0490b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(Size and Position): Clarify what is included in the frame height. (Bug#4535)
author Glenn Morris <rgm@gnu.org>
date Sun, 11 Oct 2009 00:07:05 +0000
parents c9f6575e6f19
children eff4c06fb1e2
files doc/lispref/ChangeLog doc/lispref/frames.texi
diffstat 2 files changed, 18 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- 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  <rgm@gnu.org>
+
+	* frames.texi (Size and Position): Clarify what is included in the frame
+	height.  (Bug#4535)
+
 2009-10-10  Glenn Morris  <rgm@gnu.org>
 
 	* windows.texi (Size of Window): The relationship between window and
--- 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