From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 29 Aug 2011 23:50:10 GMT
Subject: Re: [PATCH] Documentation: point to "History Simplification" from -- <path>
Message-ID: <7vbov74w25.fsf@alter.siamese.dyndns.org>
In-Reply-To: <307fe311ad448ecd3d0643040008954a217d7ddb.1314659821.git.trast@student.ethz.ch>

Thomas Rast <trast@student.ethz.ch> writes:

> 'git log -- <path>' does not "show commits that affect the specified
> paths" in a literal sense unless --full-history is given (for example,
> a file that only existed on a side branch will turn up no commits at
> all!).
>
> Point the user to the "History Simplification" section to avoid
> surprises.

Hmm, or perhaps replace it with a brief explanation instead of redirecting
the readers to a separate section without telling them anything here?

    Show only commits that are enough to explain how the files that match
    the specified paths came to be.

(this is my attempt to paraphrase $gmane/90659)

>  [\--] <path>...::
> +	Show only commits that affect any of the specified paths.
> +	See "History Simplification" below for a precise definition of
> +	the filtering applied.