diff mercurial/commands.py @ 13952:1416b9118540 stable

identify/help: say what the command does first, mention bookmarks

--- a/mercurial/commands.py	Fri Apr 15 23:45:41 2011 -0500
+++ b/mercurial/commands.py	Tue Apr 19 00:41:47 2011 +0300
@@ -2244,17 +2244,17 @@
              num=None, id=None, branch=None, tags=None, bookmarks=None):
     """identify the working copy or specified revision
 
-    With no revision, print a summary of the current state of the
+    Print a summary identifiying the repository state at REV
+    using one or two parent hash identifiers, followed by a
+    "+" if there are uncommitted changes in the working directory,
+    the branch name (omitted if default) and a list of tags, bookmarks.
+
+    When REV is not given, print a summary of the current state of the
     repository.
 
     Specifying a path to a repository root or Mercurial bundle will
     cause lookup to operate on that repository/bundle.
 
-    This summary identifies the repository state using one or two
-    parent hash identifiers, followed by a "+" if there are
-    uncommitted changes in the working directory, a list of tags for
-    this revision and a branch name for non-default branches.
-
     Returns 0 if successful.
     """