Re: [PATCH] doc: remove explanation of "--" from man pages

2017-11-21 Thread Junio C Hamano
Kevin Daudt writes: > Although I agree that common options don't need to be explained > everytime again, this change might make '--' even more obscure. To be > honest, I didn't even know about gitcli(7), let alone most new users. > > In the #git irc channel we often have to explain what '--' mean

Re: [PATCH] doc: remove explanation of "--" from man pages

2017-11-21 Thread Kevin Daudt
On Tue, Nov 21, 2017 at 04:12:02PM -0500, Robert P. J. Day wrote: > "man gitcli" already explains the purpose of the "--" syntax, so there > is no value to a small subset of Git commands explaining that in their > man pages. > > Signed-off-by: Robert P. J. Day > > --- > > i tried this once be

[PATCH] doc: remove explanation of "--" from man pages

2017-11-21 Thread Robert P. J. Day
"man gitcli" already explains the purpose of the "--" syntax, so there is no value to a small subset of Git commands explaining that in their man pages. Signed-off-by: Robert P. J. Day --- i tried this once before, and i'm going to try to push it through again ... it's pointless and inconsist