[PATCH 1 of 1] churn: improve description

[Cedric Duval]

timeless wrote:
> 2009/6/16 Cédric Duval <cedricduval at free.fr>:
> >  def churn(ui, repo, *pats, **opts):
> > +    '''graph count of revisions grouped by properties

> i don't understand what this means :)

Yes, I was trying to make some sense out of it in order to formulate
a good translation, and I came to the conclusion that we may want to
tackle the English version first. :)

I think it may help a bit to replace graph count with histogram here
as well.

I'm not happy with "properties", but I don't think "template" was
speaking for itself either, the template is more a means to an end.

Perhaps simply sum up this one line header to describe what it does
roughly, and leave greater details on the various parameters to the
rest of the help text, eg. something along the lines of
"histogram of changes to the repository"?

> > +    This command will display a histogram representing a count of

> the number of?

> > +    changed lines or revisions, grouped by properties from a given

> according to a given?

> > +    template. If the --dateformat option is used, the results will
> > +    instead be grouped by date.

> ... will be grouped by date instead

> > @@ -114,12 +115,13 @@
> > +    Such a file may be specified with the --aliases option, otherwise a
> > +    .hgchurn file will be looked for in the working directory root.

> this could use work, but not from me tonight.

Thanks for your comments.
-- 
Cédric