[Emacs-diffs] Changes to emacs/lispref/windows.texi,v

[Kim F. Storm]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Kim F. Storm <kfstorm>  06/09/20 10:14:19

Index: windows.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/windows.texi,v
retrieving revision 1.100
retrieving revision 1.101
diff -u -b -r1.100 -r1.101
--- windows.texi        9 Sep 2006 22:36:01 -0000       1.100
+++ windows.texi        20 Sep 2006 10:14:19 -0000      1.101
@@ -1355,6 +1355,9 @@
 @var{position} defaults to the current position of point in
 @var{window}; @var{window}, to the selected window.
 
+If @var{position} is @code{t}, the last visible position in
address@hidden is checked.
+
 The @code{pos-visible-in-window-p} function considers only vertical
 scrolling.  If @var{position} is out of view only because @var{window}
 has been scrolled horizontally, @code{pos-visible-in-window-p} returns
@@ -1368,7 +1371,7 @@
 corner of the window; otherwise it returns an extended list of the
 form @code{(@var{x} @var{y} @var{rtop} @var{rbot} @var{rowh}
 @var{vpos})}, where the @var{rtop} and @var{rbot} specify the number
-of invisible pixels at the top and bottom of the row at
+of off-window pixels at the top and bottom of the row at
 @var{position}, @var{rowh} specifies the visible height of that row,
 and @var{vpos} specifies the vertical position (zero-based row number)
 of that row.
@@ -1385,6 +1388,30 @@
 @end example
 @end defun
 
address@hidden window-line-height &optional line window
+This function returns information about text line @var{line} in @var{window}.
+If @var{line} is one of @code{header-line} or @code{mode-line},
address@hidden returns information about the corresponding
+line of the window.  Otherwise, @var{line} is a text line number
+starting from 0.  A negative number counts from the end of the window.
+The argument @var{line} defaults to the current line in @var{window};
address@hidden, to the selected window.
+
+If the display is not up-to-date, @code{window-line-height} returns
address@hidden  In that case, @code{pos-visible-in-window-p} may be used
+to obtain related information.
+
+If there is no line corresponding to the specified @var{line},
address@hidden returns @code{nil}.  Otherwise, it returns
+a list @code{(@var{height} @var{vpos} @var{ypos} @var{offbot})},
+where @var{height} is the height in pixels of the visible part of the
+line, @var{vpos} and @var{ypos} are the vertical position in lines and
+pixels of the line relative to the top of the first text line, and
address@hidden is the number of off-window pixels at the bottom of the
+text line.  If there are off-window pixels at the top of the (first)
+text line, @var{ypos} is negative.
address@hidden defun
+
 @node Textual Scrolling
 @section Textual Scrolling
 @cindex textual scrolling