[PATCH] expand and clarify help for update

[Giorgos Keramidas]

On Fri, 31 Oct 2008 18:50:42 +0100, Adrian Buehlmann <adrian at cadifra.com> wrote:
> On 30.10.2008 09:34, Dirkjan Ochtman wrote:
>> Adrian Buehlmann <adrian <at> cadifra.com> writes:
>>> # HG changeset patch
>>> # User Adrian Buehlmann <adrian <at> cadifra.com>
>>> # Date 1225322906 -3600
>>> # Node ID 94bae0c425ba312c560c7cbe889554ab5bfbbd30
>>> # Parent  1493d1e05ca3034a104afca2f49aec2783be3df6
>>> expand and clarify help for update
>>
>> Like Giorgios, I think it's nice what you're trying to do here, but I don't
>> think making it this long is very effective. Trying to describe every little
>> corner case of update's behavior just means people won't read it all or get
>> scared of using it. Let's instead give people an idea of what the purpose is
>> (and what other commands could be used instead) and what the options are.
>
> Funny thing is, Giorgios proposed a limit of 50 lines, which the text
> after applying my patch would not exceed.
>
> And Giorgios didn't even say my patch results in the help text being
> too long (so I fail to see why you cite him this way).

Yes, I didn't mean that _your_ text was too long.  I was just noting
that I wouldn't like the text to grow *much* longer...

I think I didn't write that clearly enough, and managed to confuse
Dirkjan.

I _like_ your version of the text :)

> Instead you falsely represent Giorgio's post to quickly rule out this
> thread.

I think this was partly because I'm stretched a bit thin between $work
and other stuff, and I don't always write as coherently as I'd like to.