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

2013-03-11 Thread Matthieu Moy
Kevin Bracey ke...@bracey.fi 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

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

2013-03-11 Thread Junio C Hamano
Matthieu Moy matthieu@grenoble-inp.fr writes: Kevin Bracey ke...@bracey.fi 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

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

2013-03-11 Thread Philip Oakley
From: Junio C Hamano gits...@pobox.com Sent: Monday, March 11, 2013 7:02 PM Matthieu Moy matthieu@grenoble-inp.fr writes: Kevin Bracey ke...@bracey.fi writes: Two significant usability flaws here: - If using man, man git to side-step git help is obvious. But if trying to use

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

2013-03-11 Thread Junio C Hamano
Philip Oakley philipoak...@iee.org writes: From: Junio C Hamano gits...@pobox.com Matthieu Moy matthieu@grenoble-inp.fr 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

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 command

[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:

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 git

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

2013-03-10 Thread Junio C Hamano
Kevin Bracey ke...@bracey.fi 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