[PATCH 1 of 1] churn: improve description

Cédric Duval cedricduval at free.fr
Tue Jun 16 15:30:23 CDT 2009


# HG changeset patch
# User Cédric Duval <cedricduval at free.fr>
# Date 1245183886 -7200
# Node ID 9811ec3a38d798595d7d17265ed3e15fed102734
# Parent  c66e324d396131094030ac77fefb0721bf5e3929
churn: improve description

diff --git a/hgext/churn.py b/hgext/churn.py
--- a/hgext/churn.py
+++ b/hgext/churn.py
@@ -92,11 +92,12 @@
 
 
 def churn(ui, repo, *pats, **opts):
-    '''graph count of revisions grouped by template
+    '''graph count of revisions grouped by properties
 
-    Will graph count of changed lines or revisions grouped by template
-    or alternatively by date, if dateformat is used. In this case it
-    will override template.
+    This command will display a histogram representing a count of
+    changed lines or revisions, grouped by properties from a given
+    template. If the --dateformat option is used, the results will
+    instead be grouped by date.
 
     By default statistics are counted for number of changed lines.
 
@@ -114,12 +115,13 @@
       # display count of lines changed in every year
       hg churn -f '%Y' -s
 
-    The map file format used to specify aliases is fairly simple:
-
+    It is possible to map alternate email addresses to a main address
+    by providing a file using the following format:
+    
     <alias email> <actual email>
 
-    By default .hgchurn in the working directory root will be used, if
-    it exists. Use the --aliases option to override this.
+    Such a file may be specified with the --aliases option, otherwise a
+    .hgchurn file will be looked for in the working directory root.
     '''
     def pad(s, l):
         return (s + " " * l)[:l]



More information about the Mercurial-devel mailing list