[darcs-users] Re: recap of put options

[David Roundy]

On Sun, Feb 20, 2005 at 09:41:55PM +0100, Peter Hercek wrote:
> I would still like to advocate for the help message modification which
>  is printed when one executes darcs --help. I think the message should
>  group the commands based on what scenario they are going to be used in.
>  (Last time my mail client removed multiple spaces. Fot that I'm sorry.)
>  I also tried to squeeze the descriptions into 80 columns limit.

Reorganizing the output of darcs --help is a bit of a pain, since it is
automatically generated from the list of commands.  I want it to remain
auto-generated, since that ensures that it remains in sync with what
commands are actually available.

It's easy enough to reorder the commands without any coding, but adding
headers will be a bit more work.  If someone wants to put in that effort,
I definitely approve.

As far as rewording given descriptions, patches are welcome, preferably
modifying individual help messages, if you're making substative changes (as
I may not agree with all your changes).  You don't need to know haskell,
you can search the sources for "command_help" to see where they're defined.
Keep in mind that the same short description is used for darcs --help as
for the first line of darcs COMMAND --help.
-- 
David Roundy
http://www.darcs.net