Re: [PATCH v2] gitcli: tweak "man gitcli" for clarity
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Nov 23, 2017, 02:22 UTC
- Message-ID
- <xmqqtvxlraxx.fsf@gitster.mtv.corp.google.com>
- In-Reply-To
- <20171123000346.GA8718@sigill>
Jeff King <peff@peff.net> writes:
Show 14 quoted lines
> I read the rest of the thread, and I think the question here is not > about Git's behavior, but about parsing this sentence. > > Without a "--" Git can sometimes do what you want. Or it may error out, > if what you asked for is ambiguous. And that sentence is trying to cover > those cases separately, and the "can" only applies to the ambiguous > case. > > It's pretty clear to me as it is, but maybe we can write it differently. > Like: > > Without a disambiguating `--`, Git makes a reasonable guess. If it > cannot guess (because your request is ambiguous), then it will error > out.
Splitting it into two sentences like you did makes it even clearer, I would think.