From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 24 Dec 2007 08:30:59 GMT
Subject: Re: [PATCH] Document git rev-list --first-parent
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:

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