Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-10-01 Thread Junio C Hamano
"Robert P. J. Day" writes: > ok, i'm going to have to digest all that; pretty sure someone else > will need to change the man page to clarify the apparent inconsistency > i was referring to: > > SYNOPSIS >git checkout [-p|--patch] [] [--] [...] > DESCRIPTION >git checkout [-p|

Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-10-01 Thread Robert P. J. Day
On Sun, 1 Oct 2017, Junio C Hamano wrote: > "Robert P. J. Day" writes: > > > it's simply a matter of the forms not matching between the SYNOPSIS > > and the DESCRIPTION sections. am i making sense? > > I think the whole thing is wrong and the root cause is because the > (relatively newer) descr

Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-09-30 Thread Junio C Hamano
"Robert P. J. Day" writes: > it's simply a matter of the forms not matching between the SYNOPSIS > and the DESCRIPTION sections. am i making sense? I think the whole thing is wrong and the root cause is because the (relatively newer) description of the "--patch" mode lazily tried to piggy-back

Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-09-30 Thread Robert P. J. Day
On Sat, 30 Sep 2017, Kevin Daudt wrote: > On Sat, Sep 30, 2017 at 05:27:22AM -0400, Robert P. J. Day wrote: > > > > just noticed that in "man git-checkout", the SYNOPSIS contains > > the line: > > > > git checkout [-p|--patch] [] [--] [...] > > > > implying that is optional, but further down

Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-09-30 Thread Robert P. J. Day
On Sat, 30 Sep 2017, Kevin Daudt wrote: > On Sat, Sep 30, 2017 at 05:27:22AM -0400, Robert P. J. Day wrote: > > > > just noticed that in "man git-checkout", the SYNOPSIS contains the > > line: > > > > git checkout [-p|--patch] [] [--] [...] > > > > implying that is optional, but further down

Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-09-30 Thread Kevin Daudt
On Sat, Sep 30, 2017 at 05:27:22AM -0400, Robert P. J. Day wrote: > > just noticed that in "man git-checkout", the SYNOPSIS contains the > line: > > git checkout [-p|--patch] [] [--] [...] > > implying that is optional, but further down in the > DESCRIPTION, one reads: > > git checkout [

"man git-checkout", man page is inconsistent between SYNOPSIS and details

2017-09-30 Thread Robert P. J. Day
just noticed that in "man git-checkout", the SYNOPSIS contains the line: git checkout [-p|--patch] [] [--] [...] implying that is optional, but further down in the DESCRIPTION, one reads: git checkout [-p|--patch] [] [--] ... suggesting that is required. rday -- ===