[PATCH 04 of 14] docs/usage: rework section 'follow current branch in file view'

[Thomas De Schampheleire]

# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire at gmail.com>
# Date 1428173075 -7200
#      Sat Apr 04 20:44:35 2015 +0200
# Node ID 0c12cb6b263ac75561f36928a74c6ee28a2c48e9
# Parent  20588378897c574fcd4dc2fe051542d339cda325
docs/usage: rework section 'follow current branch in file view'

diff --git a/docs/usage/general.rst b/docs/usage/general.rst
--- a/docs/usage/general.rst
+++ b/docs/usage/general.rst
@@ -27,13 +27,16 @@
 Kallithea and deletes a repository, you can easily restore such an action by
 renaming the repository directory, removing the ``rm__<date>`` prefix.
 
-Follow current branch in file view
-----------------------------------
+File view: follow current branch
+--------------------------------
 
-In file view when this checkbox is checked the << and >> arrows will jump
-to changesets within the same branch currently being viewed. So for example
-if someone is viewing files in the ``beta`` branch and marks the `follow current branch`
-checkbox the << and >> buttons will only show revisions for the `'beta`` branch.
+In the file view, left and right arrows allow to jump to the previous and next
+revision. Depending on the way revisions were created in the repository, this
+could jump to a different branch.  When the checkbox ``Follow current branch``
+is checked, these arrows will only jump to revisions on the same branch as the
+currently visible revision.  So for example, if someone is viewing files in the
+``beta`` branch and marks the `Follow current branch` checkbox, the < and >
+arrows will only show revisions on the ``beta`` branch.
 
 
 Compare view from changelog