From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 5 May 2022 05:57:49 +0000 (+0300)
Subject: ; * src/window.c (Fset_window_start): Mention the effect on vscroll.
X-Git-Tag: emacs-28.1.90~103
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3b9e60ba2fad4330682e6fdd15899f0f227a40d7;p=emacs.git

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

diff --git a/src/window.c b/src/window.c
index 32e486f9f95..cbb2a9e0e1c 100644
--- 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);