On Thu, Oct 27, 2005 at 10:13:17PM -0500, Donald J Bindner wrote:
> Since you're talking about a new release, I was recently looking
> over the user manual, and it occurred to me that the ordering of
> the lines in the "Command overview" table could be improved.
> 
> It seems that grouping the commands that are similar will help
> people keep them staight.
> 
> Affects     patches    working directory
> =======     =======    =================
> record      yes        no
> unrecord    yes        no
> rollback    yes        no
> -------     -------    -----------------
> revert      no         yes
> unrevert    no         yes
> -------     -------    -----------------
> apply       yes        yes
> pull        yes        yes
> unpull      yes        yes
> -------     -------    -----------------
> push(6.1)   no         no
> send(6.2)   no         no
> put(6.3)    no         no
> -------     -------    -----------------
> 
> Obviously the grouping I'm going for here is
>  - commands that only affect the patches
>  - commands that only affect the working directory
>  - commands that affect both
>  - commands that affect neither

I think perhaps the current order is intended to loosely place the most
common commands first.  But it isn't really successful, so unless someone
objects, I'll accept a patch to modify the manual to reflect your
ordering.
-- 
David Roundy
http://www.darcs.net

_______________________________________________
darcs-users mailing list
[email protected]
http://www.abridgegame.org/mailman/listinfo/darcs-users

Reply via email to