[darcs-users] darcs patch

David Roundy droundy at abridgegame.org
Tue May 11 11:18:11 UTC 2004


On Sun, May 09, 2004 at 05:00:57PM -0700, adam at megacz.com wrote:
> People like CVS because they understand diff and patch, and they know
> what most of the cvs commands translate into in terms of diff/patch,
> since the translation is simple.
> 
> In an ideal world, we could assume that all users will RTFM.
> Unfortunately, that isn't true, and is especially untrue of power
> users.  This patch adds an extended help option (--extended-help) that
> describes the mapping from (nonobvious) darcs commands to operations
> on the three fundamental storage elements (WORKING, CURRENT, and
> PATCHES), in terms of the patch calculi operators.
> 
> I briefly considered spreading these longer descriptions across the
> command-specific help pages, but grouping them together quickly gives
> people the big picture, and helps with inverse queries such as "I want
> to do XYZ to WORKING/CURRENT/PATCHES; what is the name of the command
> (or sequence of commands) darcs uses for that?"

Thanks! Looks good to me.  It would be nice to at the minimum add this to
the man page (since it is already almost man-page-formatted).

Adding better explanations to the help pages of individual commands, of
course, would also be helpful.
-- 
David Roundy
http://www.abridgegame.org




More information about the darcs-users mailing list