Re: [PATCH] Documentation: point to "History Simplification" from -- <path>

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 29, 2011, 23:50 UTC
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:

Show 7 quoted lines

> '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.