From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 29 Apr 2013 16:33:12 GMT
Subject: Re: Re* [PATCH 5/7] git-log.txt: rewrite note on why "--" may be required
Message-ID: <7va9ohl2k7.fsf@alter.siamese.dyndns.org>
In-Reply-To: <CALkWK0m2__SZmpyQqLjkJuMWtPuD4=Oo7QrYovq_Fw6fpHEXXQ@mail.gmail.com>

Ramkumar Ramachandra <artagnon@gmail.com> writes:

> I agree that the "confusion" paragraph after [--] [<path>] can be
> improved, but putting [--] in a paragraph of its own sounds like an
> overkill.  Apart from other things, it means that every single git
> command would need an identical [--] paragraph for consistency.

That is not a problem.  We need to say what command line argument X
(e.g. <path>, but not limited to it) does in all pages for commands
that pay attention to X anyway.

A more important reason to have them as separate entries is to avoid
giving a wrong impression that "--" is somehow related to <path>,
which is where the mistake in the synopsis "[[--] <path>...]" that
started this thread comes from.