Re: [PATCH v8 4/5] doc: git-rebase: move --onto explanation down

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 18, 2025, 17:06 UTC
Message-ID: <xmqq4iu4k18z.fsf@gitster.g>
In-Reply-To: <51468411-8251-4f13-90f2-5cd5184d7c52@gmail.com>

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

Show 6 quoted lines

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