# HG changeset patch
# User timeless <timeless@mozdev.org>
# Date 1450852607 0
# Node ID bbb61a8314c3935c882d9d1d65335757ecd0c0f3
# Parent  fb2c77ba577a8818f801a06329e6d8cc134520da
histedit: clarify modes

also fix terse command syntax

diff -r fb2c77ba577a -r bbb61a8314c3 hgext/histedit.py
--- a/hgext/histedit.py	Tue Dec 22 23:21:53 2015 +0000
+++ b/hgext/histedit.py	Wed Dec 23 06:36:47 2015 +0000
@@ -867,7 +867,7 @@
      ('f', 'force', False,
       _('force outgoing even for unrelated repositories')),
      ('r', 'rev', [], _('first revision to be edited'), _('REV'))],
-     _("[ANCESTOR] | --outgoing [URL]"))
+     _("[OPTIONS] ([ANCESTOR] | --outgoing [URL])"))
 def histedit(ui, repo, *freeargs, **opts):
     """interactively edit changeset history
 
@@ -887,15 +887,18 @@
 
     - `edit` to edit this changeset
 
-    The value from the "histedit.defaultrev" config option is used as a
-    revset to select the base revision when ANCESTOR is not specified.
-    The first revision returned by the revset is used. By default, this
-    selects the editable history that is unique to the ancestry of the
-    working directory.
+    There are a number of ways to select the root changset::
+
+    - Specify ANCESTOR directly
 
-    With --outgoing, this edits changesets not found in the
-    destination repository. If URL of the destination is omitted, the
-    'default-push' (or 'default') path will be used.
+    - Use --outgoing -- it will be the first linear changeset not
+      included in destination. (See :hg:"help default-push")
+
+    - Otherwise, the value from the "histedit.defaultrev" config option
+      is used as a revset to select the base revision when ANCESTOR is not
+      specified. The first revision returned by the revset is used. By
+      default, this selects the editable history that is unique to the
+      ancestry of the working directory.
 
     .. container:: verbose