From: Richard M. Stallman <rms@gnu.org>
Date: Sat, 8 Jun 2002 18:33:56 +0000 (+0000)
Subject: Explain why set-window-hscroll may appear to fail to work.
X-Git-Tag: ttn-vms-21-2-B4~14736
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=515a9a0f466acd4cd36c5a960d8525721e65c9fc;p=emacs.git

Explain why set-window-hscroll may appear to fail to work.
---

diff --git a/lispref/windows.texi b/lispref/windows.texi
index 88949cf8458..00404f8c96e 100644
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -1612,6 +1612,14 @@ This function sets the number of columns from the left margin that
 @var{columns} should be zero or positive; if not, it is taken as zero.
 Fractional values of @var{columns} are not supported at present.
 
+Note that @code{set-window-hscroll} may appear not to work if you test
+it by evaluating a call with @kbd{M-:} in a simple way.  What happens
+is that the function sets the horizontal scroll value and returns, but
+then redisplay adjusts the horizontal scrolling to make point visible,
+and this overrides what the function did.  You can observe the
+function's effect if you call it while point is sufficiently far from
+the left margin that it will remain visible.
+
 The value returned is @var{columns}.
 
 @example