[PATCH] expand and clarify help for update

[Adrian Buehlmann]

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

Ok, I'll try a "jelly" dissection of that post (in response to mpm's
"jelly food for thought" example).

> 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.

That's a very long winded way to say: that patch is crap (eh, what did Giorgios
say?)

> 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.

So everything I added is either a corner case or scares people or both, to the
effect that no one will read it. Hum.

So what's exactly nice about it? That I've tried?

> 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.

Hmm. Ok, so 'hg help update' is for getting an idea about what the _purpose_
of update is.

Where do I have to look if I want more than just an idea
of what the purpose is? (hopefully not the code or experimenting...)

And really, what other commands can we use _instead_ of update?

(now, *this* seems rather uninteresting, if I want to know what 'update' does)