From: Ramkumar Ramachandra <artagnon@gmail.com>
Date: Wed, 24 Apr 2013 18:29:54 GMT
Subject: Re: [PATCH 5/5] git-diff.txt: fix ordering of the [--no-index] form
Message-ID: <CALkWK0kaFc8cj-=1NbEwC_61U7qUCye70d9MZR66TpKB3i9XyA@mail.gmail.com>
In-Reply-To: <7vmwsndbve.fsf@alter.siamese.dyndns.org>

Junio C Hamano wrote:
> The "--no-index" mode was a hack to allow "git diff" goodies to be
> used outside the context of "git", and a proper execution of it
> should have been to send patches to GNU or BSD diff maintainers, not
> to add the "--no-index" option that is unrelated to "git" to our
> code.

Yeah, I know.  I use it instead of diff all the time.

> I think it is more correct to list it as a footnote and list
> separately from the main text, which is what the original SYNOPSIS
> section does.

I was trying to be more "correct" here.  The form is a special case of
the first form where the number of paths are limited to two.  Besides,
isn't that how the DESCRIPTION section explains it now?