# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 994927588 0
# Node ID 99b267c1ccbd331800ef6f1d96c12e28b798d272
# Parent  dd827746979da1c967fda9e6c61557e649d078ef
Explain window-end never scrolls the window.

diff -r dd827746979d -r 99b267c1ccbd lispref/windows.texi
--- 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