; * src/window.c (Fset_window_start): Mention the effect on vscroll.

diff --git a/src/window.c b/src/window.c
index 32e486f9f95a8bc2103c1a67aa5a5c29f551f8a2..cbb2a9e0e1c578b2dd250cac4b1aa9f8b055c6bd 100644 (file)
--- a/src/window.c
+++ b/src/window.c
@@ -1861,7 +1861,13 @@ point not visible in the window.
 For reliable setting of WINDOW start position, make sure point is
 at a position that will be visible when that start is in effect,
 otherwise there's a chance POS will be disregarded, e.g., if point
-winds up in a partially-visible line.  */)
+winds up in a partially-visible line.
+
+The setting of the WINDOW's start position takes effect during the
+next redisplay cycle, not immediately.  If NOFORCE is nil or
+omitted, forcing the display of WINDOW to start at POS cancels
+any setting of WINDOW's vertical scroll (\"vscroll\") amount
+set by `set-window-vscroll' and by scrolling functions.  */)
   (Lisp_Object window, Lisp_Object pos, Lisp_Object noforce)
 {
   register struct window *w = decode_live_window (window);