[PATCH] expand and clarify help for update

[Doug Philips]

On or about Friday, October 31, 2008, at 02:50PM, Dirkjan Ochtman indited:
>Matt Mackall wrote:
>> So here's a simple proposal: add a -v switch to help topics to allow
>> showing otherwise omitted sections of the help. Perhaps lines in help
>> prefixed with '%' or some other character get removed without -v and
>> displayed (without %) with -v.
>
>I was thinking maybe we could insert a line with '---' on it and split 
>on that. Having to insert a character on each line seems rather tedious.

Doesn't that presume that all the extra info has to be separated "at the end"?
Or did you mean? something such as:

blah blah blah normal help
---
extra help/explanation here
---
blah blah blah more normal help.
---
more extra help/explanation here
---

Trying to get the vertical white space formatting to look good would be slightly more annoying with '---' whereas trying to get horizontal white space formatting would be more annoying with a per-line line-prefix...

Of course there is always the possibility that verbose help could be completely separate... :)
% hg help --fascicle update
% hg help --treatise update

-Doug