git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2] replay: support replaying down from root commit

From
Junio C Hamano <gitster@pobox.com>
Date
Mar 27, 2026, 16:45 UTC
Message-ID
<xmqqfr5lkyq8.fsf@gitster.g>
In-Reply-To
<87a4vv2ada.fsf@iotcl.com>
Toon Claes <toon@iotcl.com> writes:
Show 15 quoted lines
>> 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.
Previous: Toon ClaesNext: Christian Couder
Message 11 of 17 in “replay: support replaying down from root commit”
  1. replay: support replaying down from root commitToon Claes, Mar 17, 2026
  2. Junio C HamanoMar 17, 2026
  3. Toon ClaesMar 24, 2026
  4. replay: support replaying down from root commitToon Claes, Mar 24, 2026
  5. Junio C HamanoMar 24, 2026
  6. Christian CouderMar 25, 2026
  7. Ben KnobleMar 25, 2026
  8. Toon ClaesMar 25, 2026
  9. Toon ClaesMar 25, 2026
  10. Toon ClaesMar 25, 2026
  11. Junio C HamanoMar 27, 2026
  12. Christian CouderMar 31, 2026
  13. Junio C HamanoMar 31, 2026
  14. Toon ClaesApr 2, 2026
  15. Junio C HamanoApr 2, 2026
  16. Christian CouderApr 3, 2026
  17. Junio C HamanoMar 25, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.