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

[FUJIWARA Katsunori]

At Wed, 11 Jul 2012 16:23:31 +0200,
Martin Schröder wrote:
> 
> 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)?

Thank you for your comments, Pierre-Yves and Martin !

I'll post re-written one with "detail" pluralized.

----------------------------------------------------------------------
[FUJIWARA Katsunori]                             foozy at lares.dti.ne.jp