From: Junio C Hamano Date: Fri, 27 Mar 2026 16:45:35 GMT Subject: Re: [PATCH v2] replay: support replaying down from root commit Message-ID: In-Reply-To: <87a4vv2ada.fsf@iotcl.com> Toon Claes writes: >> Maybe something like the following could help: >> >> --- a/Documentation/git-replay.adoc >> +++ b/Documentation/git-replay.adoc >> @@ -23,6 +23,10 @@ instead get update commands that can be piped to >> `git update-ref --stdin` >> >> THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE. >> >> +Note that `git replay --onto main topic` replays the topic branch starting >> +from the root commit, not from main. What you might want instead is >> +`git replay --onto main main..topic`. >> + > > Definitely would help, not sure it needs to be part of this series. Where else should the patch to add such a note to the documentation go, though? Without this patch, we do not is because the command will not take such a command line. With this patch that adds the "now we allow replay to take a single tip commit and replay the history leading to the tip all the way down to root" feature, the note may become relevant. So to me, it looks like it is either we will never add such a note because it is irrelevant and everybody should know the consequence of passing "topic", not "main..topic", or we will have to add such a note as part of the series (if the note would help the readers). Even though I am on the fence about the need for this specific note in the documentation, it does not make sense to me to say "this will help but we are not doing so here". My comment on "might" in "What you might" in the thread still applies, by the way. Thanks.