[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110785: Clarify documentation of scroll-step, per bug #12801.

[Eli Zaretskii]

------------------------------------------------------------
revno: 110785
fixes bug: http://debbugs.gnu.org/12801
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Mon 2012-11-05 20:01:20 +0200
message:
  Clarify documentation of scroll-step, per bug #12801.
  
   doc/emacs/display.texi (Auto Scrolling): Clarify that scroll-step is
   ignored when scroll-conservatively is set to a non-zero value.
modified:
  doc/emacs/ChangeLog
  doc/emacs/display.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-11-05 14:13:26 +0000
+++ b/doc/emacs/ChangeLog       2012-11-05 18:01:20 +0000
@@ -1,3 +1,9 @@
+2012-11-05  Eli Zaretskii  <address@hidden>
+
+       * display.texi (Auto Scrolling): Clarify that scroll-step is
+       ignored when scroll-conservatively is set to a non-zero value.
+       (Bug#12801)
+
 2012-11-05  Chong Yidong  <address@hidden>
 
        * dired.texi (Dired Updating): Doc fix (Bug#11744).

=== modified file 'doc/emacs/display.texi'
--- a/doc/emacs/display.texi    2012-10-05 05:57:24 +0000
+++ b/doc/emacs/display.texi    2012-11-05 18:01:20 +0000
@@ -221,20 +221,27 @@
 if you set @code{scroll-conservatively} to a small number @var{n},
 then if you move point just a little off the screen (less than @var{n}
 lines), Emacs scrolls the text just far enough to bring point back on
-screen.  By default, @code{scroll-conservatively} address@hidden  If you
-set @code{scroll-conservatively} to a large number (larger than 100),
-Emacs will never center point as result of scrolling, even if point
-moves far away from the text previously displayed in the window.  With
-such a large value, Emacs will always scroll text just enough for
+screen.  If doing so fails to make point visible, Emacs centers point
+in the window.  By default, @code{scroll-conservatively} address@hidden
+If you set @code{scroll-conservatively} to a large number (larger than
+100), Emacs will never center point as result of scrolling, even if
+point moves far away from the text previously displayed in the window.
+With such a large value, Emacs will always scroll text just enough for
 bringing point into view, so point will end up at the top or bottom of
 the window, depending on the scroll direction.
 
 @vindex scroll-step
-  The variable @code{scroll-step} determines how many lines to scroll
-the window when point moves off the screen.  If moving by that number
-of lines fails to bring point back into view, point is centered
-instead.  The default value is zero, which causes point to always be
-centered after scrolling.
+  An alternative way of controlling how Emacs scrolls text is by
+customizing the variable @code{scroll-step}.  Its value determines how
+many lines to scroll the window when point moves off the screen.  If
+moving by that number of lines fails to bring point back into view,
+point is centered instead.  The default value is zero, which causes
+point to always be centered after scrolling.
+
+  Since both @code{scroll-conservatively} and @code{scroll-step}
+control automatic scrolling in contradicting ways, you should set only
+one of them.  If you customize both, the value of
address@hidden takes precedence.
 
 @cindex aggressive scrolling
 @vindex scroll-up-aggressively