Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-11 Thread Kevin Bracey
On 11/03/2013 05:03, Junio C Hamano wrote: Hmm, I feel more confused than convinced after reading the above three times. Perhaps that is because I am too used to the way how "git" potty itself behaves, especially the part that "git help git" is the way to ask "git" (the first token on the comman

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-11 Thread Junio C Hamano
"Philip Oakley" writes: > From: "Junio C Hamano" >> Matthieu Moy writes: >> >>> See 'git help git' for general help about Git. >>> >>> to the output of "git help"? >> ... >> That sounds like a good direction to go in. > > My earlier attempt, and Junio's reply > http://thread.gmane.org/gmane.c

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-11 Thread Philip Oakley
From: "Junio C Hamano" Sent: Monday, March 11, 2013 7:02 PM Matthieu Moy writes: Kevin Bracey writes: Two significant usability flaws here: - If using man, "man git" to side-step "git help" is obvious. But if trying to use help.format=web, how to get the root html page? My techniq

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-11 Thread Junio C Hamano
Matthieu Moy writes: > Kevin Bracey writes: > >> Two significant usability flaws here: >> - If using man, "man git" to side-step "git help" is obvious. But if >>trying to use help.format=web, how to get the root html page? My >>technique was "git help XXX" and click the "git(1) suite" l

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-11 Thread Matthieu Moy
Kevin Bracey writes: > Two significant usability flaws here: > - If using man, "man git" to side-step "git help" is obvious. But if >trying to use help.format=web, how to get the root html page? My >technique was "git help XXX" and click the "git(1) suite" link at the >bottom. "git h

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-10 Thread Junio C Hamano
Kevin Bracey writes: > Previously, the command "help" and the option "-h" behaved differently > depending on whether a command was specified or not. Old user interface: > > Commands with no defaults show usage: "git" "git CMD" > To specifically request usage:"git help" "git

Re: [PATCH/RFC] Make help behaviour more consistent

2013-03-10 Thread Philip Oakley
On 10/03/13 17:48, Kevin Bracey wrote: Previously, the command "help" and the option "-h" behaved differently depending on whether a command was specified or not. Old user interface: Commands with no defaults show usage: "git" "git CMD" To specifically request usage:"git help"

[PATCH/RFC] Make help behaviour more consistent

2013-03-10 Thread Kevin Bracey
Previously, the command "help" and the option "-h" behaved differently depending on whether a command was specified or not. Old user interface: Commands with no defaults show usage: "git" "git CMD" To specifically request usage:"git help" "git CMD -h" To get a manual page: