Re: [PATCH 3/8] tag: Change misleading --list <pattern> documentation

From: Junio C Hamano <gitster@pobox.com>
Date: Mar 20, 2017, 17:07 UTC
Message-ID: <xmqqshm7x4gb.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <xmqqinn4x7rz.fsf@gitster.mtv.corp.google.com>

Junio C Hamano <gitster@pobox.com> writes:

Show 13 quoted lines

> Jeff King <peff@peff.net> writes:
>
>> I think it's expected to work under the usual last-one-wins option
>> parsing. A more subtle case is that:
>>
>>   git tag -l -d foo
>>
>> would override "-l" with "-d". That's reasonable under the same rule as
>> long as the user knows that the two are mode-selectors. I don't think we
>> make that explicit in the documentation, though, so perhaps it isn't
>> something users should rely on.
>
> Yup, that is reasonable.

Oops. I meant "two are mode-selectors and can override with the usual last one wins rule" was reasonable. As Ævar says, this is an established practice and may already be documented sufficiently.