From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 18 Aug 2025 17:06:52 GMT
Subject: Re: [PATCH v8 4/5] doc: git-rebase: move --onto explanation down
Message-ID: <xmqq4iu4k18z.fsf@gitster.g>
In-Reply-To: <51468411-8251-4f13-90f2-5cd5184d7c52@gmail.com>

Phillip Wood <phillip.wood123@gmail.com> writes:

>> The new location of this section on "--onto" felt a bit off.
>> Perhaps it is just me, but in case others have different opinions,
>> I'd raise it here.
>
> I agree that "--onto" is a fairly commonly used option and so it might
> be nice to mention it in the general description.

That would independently be a good idea.

> The existing
> examples are all good reasons why one might want to use "--onto" so
> I'm slightly wary of replacing them with a single example in the
> description.

Then perhaps we should find a better place to put it.  The section
on advanced topics notes are mostly about operations using sequencer
machinery, except for the onto section.  Perhaps immediately after
the apply/merge comparison?