From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 05 Feb 2015 21:29:45 GMT
Subject: Re: Advice on edits to git-rebase man page
Message-ID: <xmqqmw4sjbcm.fsf@gitster.dls.corp.google.com>
In-Reply-To: <vpq1tm412dk.fsf@anie.imag.fr>

Matthieu Moy <Matthieu.Moy@grenoble-inp.fr> writes:

> Junio C Hamano <gitster@pobox.com> writes:
>
>> Perhaps something like this instead?
>>
>>     git-rebase - Rebuild a branch on top of a different commit
>
> I would say "Replay history on top of a different commit" instead.
> "Rebuild" may be misleading (it's not "build" as in "compile & link"),
> and the rebased history does not technically have to be a branch.

I am fine if the description were "replay history and repoint the
branch tip to the result"; the fact that branch tip moves is an
important part of the semantics of the command.

Otherwise, you cannot cleanly capture why we have rebase and
cherry-pick (which can do ranges these days).