(Textual Scrolling): Doc 3 values for scroll-preserve-screen-position.

diff --git a/lispref/windows.texi b/lispref/windows.texi
index 5a58c31f39a5a1d0cfc2b87e4c694c54e2242490..ec372d98aa81ad607853c682637d824d726374b3 100644 (file)
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -1523,9 +1523,12 @@ does not work with @code{scroll-margin}.  The default value is zero.
 @end defopt
 
 @defopt scroll-preserve-screen-position
-If this option is non-@code{nil}, the scroll functions move point so
-that the vertical position of the cursor is unchanged, when that is
-possible.
+If this option is @code{t}, scrolling which would move the current
+point position out of the window chooses the new position of point
+so that the vertical position of the cursor is unchanged, if possible.
+
+If it is non-@code{nil} and not @code{t}, then the scrolling functions
+always preserve the vertical position of point, if possible.
 @end defopt
 
 @defopt next-screen-context-lines