[Emacs-diffs] master 47089e0: Clarify documentation of pos-visible-in-window-p

[Eli Zaretskii]

branch: master
commit 47089e0cc85906831f5d078d460a581ad70d963a
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Clarify documentation of pos-visible-in-window-p
    
    * src/window.c (Fpos_visible_in_window_p): Clarify the meaning of
    t for POS.  See
    http://lists.gnu.org/archive/html/emacs-devel/2015-09/msg01040.html
    for the original report.
    
    * doc/lispref/windows.texi (Window Start and End): Clarify the
    meaning of t for the POSITION argument of pos-visible-in-window-p.
---
 doc/lispref/windows.texi |    2 +-
 src/window.c             |    5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 00161b2..881d364 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -3179,7 +3179,7 @@ Locations that are partially obscured are not considered 
visible unless
 @var{partially} is address@hidden  The argument @var{position} defaults
 to the current position of point in @var{window}; @var{window}, to the
 selected window.  If @var{position} is @code{t}, that means to check the
-last visible position in @var{window}.
+first visible position of the last visible screen line in @var{window}.
 
 This function considers only vertical scrolling.  If @var{position} is
 out of view only because @var{window} has been scrolled horizontally,
diff --git a/src/window.c b/src/window.c
index 42a2ca6..0f35066 100644
--- a/src/window.c
+++ b/src/window.c
@@ -1686,8 +1686,9 @@ Return nil if that position is scrolled vertically out of 
view.  If a
 character is only partially visible, nil is returned, unless the
 optional argument PARTIALLY is non-nil.  If POS is only out of view
 because of horizontal scrolling, return non-nil.  If POS is t, it
-specifies the position of the last visible glyph in WINDOW.  POS
-defaults to point in WINDOW; WINDOW defaults to the selected window.
+specifies the position of the first glyph displayed on the last visible
+screen line in WINDOW.  POS defaults to point in WINDOW; WINDOW defaults
+to the selected window.
 
 If POS is visible, return t if PARTIALLY is nil; if PARTIALLY is non-nil,
 the return value is a list of 2 or 6 elements (X Y [RTOP RBOT ROWH VPOS]),