summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>2001-07-12 08:46:28 +0000
committerRichard M. Stallman <rms@gnu.org>2001-07-12 08:46:28 +0000
commit41448f63443985b8efb28424725b01e638de9608 (patch)
tree0b411285525c5b10ff3a871d9d09e4550e0fe8e1
parent9540ec3fb474d488b2b280a4712dd449d8be13d2 (diff)
downloademacs-41448f63443985b8efb28424725b01e638de9608.tar.gz
Explain window-end never scrolls the window.
-rw-r--r--lispref/windows.texi13
1 files changed, 10 insertions, 3 deletions
diff --git a/lispref/windows.texi b/lispref/windows.texi
index 85655d8bb28..bb5c88f0c23 100644
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -1144,10 +1144,17 @@ If the last redisplay of @var{window} was preempted, and did not finish,
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