[darcs-users] darcs patch: Put blank lines between command groups i... (and 2 more)

[Trent W. Buck]

Petr Rockai <me at mornfall.net> writes:

> Fri Jun 19 13:40:35 CEST 2009  Petr Rockai <me at mornfall.net>
>   * Put blank lines between command groups in "darcs help".

I approve of this one.

> Fri Jun 19 13:41:48 CEST 2009  Petr Rockai <me at mornfall.net>
>   * Make "darcs clone" a hidden alias for "darcs get".

...for people coming from "git clone" or "hg clone".

> Fri Jun 19 13:40:55 CEST 2009  Petr Rockai <me at mornfall.net>
>   * Cut down descriptions, so that darcs help does not wrap on an 80-column TTY.
>
> - "Replace a patch with a better version before it leaves your repository."
> + "Replace a patch with a better version before it leaves your branch."

I've tried to avoid using "branch" in documentation, because then you
have to explain that it's merely a synonym for "repository".  Due to the
need for terseness in the short descriptions, I'd prefer "repo" here.

>  markconflicts_description =
> - "Mark any unresolved conflicts in working copy, for manual resolution."
> + "Mark unresolved conflicts in working copy, for manual resolution."

Suits me, though "copy" should be "tree" for consistency (with the rest
of the documentation).

>  setpref_description =
> -    "Set the value of a preference (" ++ orClauses valid_prefs ++ ")."
> +    "Set a preference value (" ++ orClauses valid_prefs ++ ")."

Might as well get rid of "value" altogher: "Set a preference (...)."