Daniel Rall wrote:
> On Mon, 07 Nov 2005, Julian Foad wrote:
>
>>Daniel Rall wrote:
>>
>>>It's not obvious to me that style #2 can take multiple source
>>>arguments. How about something like:
>>>
>>> 2. move SRC [SRC2 SRC3 ...] DIR\n"
>>
>>No; that would be ugly and inconsistent with the rest of our help. Get
>>used to "..." meaning "possibly repeated" :-)
>
> In that case, why not change it across all help text?
You're not serious, are you? If you are, why would I want to make all help
text consistently ugly? (It's ugly because it's long-winded, unclear how many
sources are allowed, and arbitrary how many repeats you write in the help.)
See my old thread "PATCH: help text: presentation of optionally-repeated
arguments" <http://svn.haxx.se/dev/archive-2003-06/1642.shtml>.
There are times when verbosity is useful, such as in a tutorial section in the
book, but not here. The online help is a concise reference.
- Julian
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Nov 8 14:01:11 2005