changeset 38380:99b267c1ccbd

Explain window-end never scrolls the window.
author Richard M. Stallman <rms@gnu.org>
date Thu, 12 Jul 2001 08:46:28 +0000
parents dd827746979d
children 377e83704c76
files lispref/windows.texi
diffstat 1 files changed, 10 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/windows.texi	Thu Jul 12 07:18:18 2001 +0000
+++ b/lispref/windows.texi	Thu Jul 12 08:46:28 2001 +0000
@@ -1144,10 +1144,17 @@
 Emacs does not know the position of the end of display in that window.
 In that case, this function returns @code{nil}.
 
-If @var{update} is non-@code{nil}, @code{window-end} always returns
-an up-to-date value for where the window ends.  If the saved value is
-valid, @code{window-end} returns that; otherwise it computes the correct
+If @var{update} is non-@code{nil}, @code{window-end} always returns an
+up-to-date value for where the window ends, based on the current
+@code{window-start} value.  If the saved value is valid,
+@code{window-end} returns that; otherwise it computes the correct
 value by scanning the buffer text.
+
+Even if @var{update} is non-@code{nil}, @code{window-end} does not
+attempt to scroll the display if point has moved off the screen, the
+way real redisplay would do.  It does not alter the
+@code{window-start} value.  In effect, it reports where the displayed
+text will end if scrolling is not required.
 @end defun
 
 @defun set-window-start window position &optional noforce