From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 08 Jun 2012 19:52:32 GMT
Subject: Re: [PATCHv3 1/2] git-rebase.txt: "--onto" option updated
Message-ID: <7v8vfxd1j3.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20120608210630.Horde.joXbQHwdC4BP0k02QgDFpMA@webmail.minatec.grenoble-inp.fr>

konglu@minatec.inpg.fr writes:

> That's what I thought, but it appeared to me that the description
>
> --onto <newbase>::
>          Starting point at which to create the new commits.
>          If the --onto option is not specified, the starting
>          point is <upstream>.  May be any valid commit, and
> 	not just an existing branch name.
>
> only focus on the parameter <newbase>.

Talking about <newbase> is equivalent to talking about --onto isn't
it?  What the command does is described far above upfront in the
manual page; the description of options is the place to explain what
details are affected by giving (or not giving) the option in the
behaviour that was explained earlier.