From 61472845d74b4ce7078c1b9f0bfadd26cd333a84 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=A0t=C4=9Bp=C3=A1n=20N=C4=9Bmec?= <stepnem@gmail.com>
Date: Mon, 14 Nov 2011 13:39:50 +0100
Subject: [PATCH] Clearly document the <C-d>/<C-u>/'scroll' behaviour.

---
 common/locale/en-US/buffer.xml  | 10 +++++-----
 common/locale/en-US/options.xml |  5 +++--
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/common/locale/en-US/buffer.xml b/common/locale/en-US/buffer.xml
index e3721d96..42462c72 100644
--- a/common/locale/en-US/buffer.xml
+++ b/common/locale/en-US/buffer.xml
@@ -203,8 +203,8 @@
     <description>
         <p>
             Scroll window downwards by the amount specified in the
-            <o>scroll</o> option. With <oa>count</oa>, scroll as if
-            <o>scroll</o> were set to <oa>count</oa>.
+            <o>scroll</o> option. With <oa>count</oa>, set the <o>scroll</o>
+            option to <oa>count</oa> before executing the command.
         </p>
     </description>
 </item>
@@ -215,9 +215,9 @@
     <spec><oa>count</oa>&lt;C-u></spec>
     <description>
         <p>
-            Scroll window upwards by the amount specified in the
-            <o>scroll</o> option. With <oa>count</oa>, scroll as if
-            <o>scroll</o> were set to <oa>count</oa>.
+            Scroll window upwards by the amount specified in the <o>scroll</o>
+            option. With <oa>count</oa>, set the <o>scroll</o> option to
+            <oa>count</oa> before executing the command.
         </p>
     </description>
 </item>
diff --git a/common/locale/en-US/options.xml b/common/locale/en-US/options.xml
index 3a1367c2..1fffc67c 100644
--- a/common/locale/en-US/options.xml
+++ b/common/locale/en-US/options.xml
@@ -1466,8 +1466,9 @@
             Number of lines to scroll with <k name="C-u"/> and <k name="C-d"/>
             commands. The number of lines scrolled defaults to half the window
             size. When a <oa>count</oa> is specified to the <k name="C-u"/> or
-            <k name="C-d"/> commands, that value is used instead. When the
-            value is <em>0</em>, it defaults to half the window height.
+            <k name="C-d"/> commands, set this option to <oa>count</oa> before
+            executing the command. Setting this to <em>0</em> restores the
+            default behaviour.
         </p>
     </description>
 </item>