[darcs-users] darcs-2 help behavior

[Trent W. Buck]

Matthias Kilian <kili at outback.escape.de> writes:

> - Therefore, the complaint in the first URL you mentioned has a point
>   (--help, or -? should produce *short* output). I'm not even sure
>   wether the advanced options should be printed by darcs at all
>   (this stuff belongs into the manpage).

+1.

The current help output is too long.  Advanced help should be moved to
something like darcs help --advanced foo or darcs foo --full-help, or
ommitted entirely.

(Obviously the normal --help output would mention that this extended
resource existed, and refer the user to it.)

> - Usage output (be it via --help, -?, --gimmeaclue) should be written to
>   stdout, not to stderr -- AFAIK this isn't an issue for darcs, but I
>   hate it *so much* if I've to type something like
>
> 	foo --help 2>&1 | more
>
>   for some `foo' tool that I mention it here ;-)

+1.  BTDTBTTS.