From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 02 Oct 2017 00:29:37 GMT
Subject: Re: "man git-checkout", man page is inconsistent between SYNOPSIS and details
Message-ID: <xmqqtvzis87i.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <alpine.LFD.2.21.1710010603340.17338@localhost.localdomain>

"Robert P. J. Day" <rpjday@crashcourse.ca> 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] [<tree-ish>] [--] [<paths>...]
>   DESCRIPTION
>        git checkout [-p|--patch] [<tree-ish>] [--] <pathspec>...

Yes, and a short-version of my answer is that they both are wrong
;-)