Re: [PATCH] Document git rev-list --first-parent

From: Junio C Hamano <gitster@pobox.com>
Date: Dec 24, 2007, 08:30 UTC
Message-ID: <7v3atstry4.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <1198484450-16454-1-git-send-email-avi@qumranet.com>

Avi Kivity <avi@qumranet.com> writes:

Show 8 quoted lines

> Document git rev-list's --first-parent option.  Documentation taken from
> git log.
> ...
> +--first-parent::
> +	Follow only the first parent commit upon seeing a merge
> +	commit.  This  option gives a better overview of the
> +	evolution of a particular branch.
> +

I am afraid that this description is not sufficient. The history given by --first-parent is useful only in a very limited use case, and the user needs to be aware of it.