From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 24 Apr 2013 18:20:18 GMT
Subject: Re: [PATCH 3/5] git-diff.txt: group the [--] and [<path>...] templates
Message-ID: <7vtxmvdc4d.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1366821216-20868-4-git-send-email-artagnon@gmail.com>

Ramkumar Ramachandra <artagnon@gmail.com> writes:

> -'git diff' [options] [--] [<path>...]::
> +'git diff' [options] [[--] [<path>...]]::

You can say

    "git diff A B --" without any path
    "git diff A B pathspec" without any double-dashes
    "git diff -- pathspec"

and all three of them are expressed by versions before or after the
patch, so there is no change in the semantics introduced by this
patch.

While the update might be logically more correct, it looks to me
that the only end-user visibile effect of it is to make the end
result harder to read.