From: Richard M. Stallman <rms@gnu.org>
Date: Tue, 18 Jul 1995 22:10:51 +0000 (+0000)
Subject: Explain how redisplay updates window-start.
X-Git-Tag: emacs-19.34~3263
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ea951766c562af6f2ab08016ab83bd18ffbc6168;p=emacs.git

Explain how redisplay updates window-start.
---

diff --git a/lispref/windows.texi b/lispref/windows.texi
index 27925e9be8c..fe6db12f2b4 100644
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -1003,8 +1003,14 @@ When you create a window, or display a different buffer in it, the
 display-start position is set to a display-start position recently used
 for the same buffer, or 1 if the buffer doesn't have any.
 
-For a realistic example, see the description of @code{count-lines} in
-@ref{Text Lines}.
+Redisplay updates the window-start position (if you have not specified
+it explicitly since the previous redisplay) so that point appears on the
+screen.  Nothing except redisplay automatically changes the window-start
+position; if you move point, do not expect the window-start position to
+change in response until after the next redisplay.
+
+For a realistic example of using @code{window-start}, see the
+description of @code{count-lines} in @ref{Text Lines}.
 @end defun
 
 @defun window-end &optional window