[PATCH] help: indicate help omitting if help document is not fully displayed

[Martin Schröder]

Am 11.07.2012 16:21, schrieb Pierre-Yves David:
> On Wed, Jul 11, 2012 at 11:16:11PM +0900, FUJIWARA Katsunori wrote:
>> # HG changeset patch
>> # User FUJIWARA Katsunori <foozy at lares.dti.ne.jp>
>> # Date 1342015589 -32400
>> # Node ID c9dc22b313bf3ed8d8f81709568cf31230b1b8db
>> # Parent  2e13c1bd34dc6afda8fc7cfa22a8cd658276724f
>> help: indicate help omitting if help document is not fully displayed
>>
>> Before this patch, there is no information about whether help document
>> is fully displayed or not.
>>
>> So, some users seem to misunderstand "-v" for "hg help" just as "the
>> option to show list of global options" by their experience on "hg help
>> -v" for some commands not containing verbose containers in their help
>> document.
>>
>> Omitted help document is never seen by such users, and this may cause
>> wrong or insufficient understanding about Mercurial.
>>
>> This patch indicates help omitting, if help document is not fully
>> displayed. This allows users to know whether there is any omitted
>> information or not exactly, and can trigger "hg help -v" invocation by
>> users.
> 
> feature +1

I like that one, too. Maybe the sentence should be "use :hg:`help -v %s`
to show details." (with detail pluralized)?