# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1023561236 0
# Node ID 85f61bf6ce1d8c4f085197a1f0da552bd6196683
# Parent  19d02f244e7da21432af9e84514232bcaf48713d
Explain why set-window-hscroll may appear to fail to work.

diff -r 19d02f244e7d -r 85f61bf6ce1d lispref/windows.texi
--- a/lispref/windows.texi	Sat Jun 08 18:30:02 2002 +0000
+++ b/lispref/windows.texi	Sat Jun 08 18:33:56 2002 +0000
@@ -1612,6 +1612,14 @@
 @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