[PATCH 05 of 14] docs/usage: reword and extend section on changelog

[Thomas De Schampheleire]

# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire at gmail.com>
# Date 1428174827 -7200
#      Sat Apr 04 21:13:47 2015 +0200
# Node ID f490e9de73ac48f9945fc49d862556d0a5034c1e
# Parent  0c12cb6b263ac75561f36928a74c6ee28a2c48e9
docs/usage: reword and extend section on changelog

diff --git a/docs/usage/general.rst b/docs/usage/general.rst
--- a/docs/usage/general.rst
+++ b/docs/usage/general.rst
@@ -39,19 +39,36 @@
 arrows will only show revisions on the ``beta`` branch.
 
 
-Compare view from changelog
----------------------------
+Changelog features
+------------------
 
-Checkboxes in the compare view allow users to view a combined compare
-view. You can only show the range between the first and last checkbox
-(no cherry pick).  Clicking more than one checkbox will activate a
-link at the top saying ``Show selected changesets <from-rev> ->
-<to-rev>``. Clicking this will activate the compare view. In this view
-it is also possible to switch to combined compare.
+The core feature of a repository's ``changelog`` page is to show the revisions
+in a repository. However, there are several other features available from the
+changelog.
 
-Compare view is also available from the journal on pushes having more than
-one changeset.
+Branch filter
+  By default, the changelog shows revisions from all branches in the
+  repository. Use the branch filter to restrict to a given branch.
 
+Viewing a changeset
+  A particular changeset can be opened by clicking on either the changeset
+  hash or the commit message, or by ticking the checkbox and clicking the
+  ``Show selected changeset`` button at the top.
+
+Viewing all changes between two changesets
+  To get a list of all changesets between two selected changesets, along with
+  the changes in each one of them, tick the checkboxes of the first and
+  last changeset in the desired range and click the ``Show selected changesets``
+  button at the top. You can only show the range between the first and last
+  checkbox (no cherry-picking).
+
+  From that page, you can proceed to viewing the overall delta between the
+  selected changesets, by clicking the ``Compare revisions`` button.
+
+Creating a pull request
+  You can create a new pull request for the changes of a particular changeset
+  (and its ancestors) by selecting it and clicking the ``Open new pull request
+  for selected changesets`` button.
 
 Non changeable repository urls
 ------------------------------