Subject: Re: [PATCH 3/4] builtin/history: replace "--ref-action=print" with "--dry-run"

From: Patrick Steinhardt <[email-masked]>
Date: Fri, 13 Feb 2026 06:50:51 +0100

On Thu, Feb 12, 2026 at 05:20:13PM -0500, D. Ben Knoble wrote:
> On Thu, Feb 12, 2026 at 7:45 AM Patrick Steinhardt <[email-masked]> wrote:
> > diff --git a/Documentation/git-history.adoc b/Documentation/git-history.adoc
> > index 154e262b76..33353815cb 100644
> > --- a/Documentation/git-history.adoc
> > +++ b/Documentation/git-history.adoc
> > @@ -60,13 +60,15 @@ The following commands are available to rewrite history in different ways:
> >  OPTIONS
> >  -------
> >
> > -`--ref-action=(branches|head|print)`::
> > +`--dry-run`::
> > +       Do not update any references, but instead print any ref updates in a
> > +       format that can be consumed by linkgit:git-update-ref[1].
> > +
> > +`--ref-action=(branches|head)`::
> >         Control which references will be updated by the command, if any. With
> >         `branches`, all local branches that point to commits which are
> >         descendants of the original commit will be rewritten. With `head`, only
> > -       the current `HEAD` reference will be rewritten. With `print`, all
> > -       updates as they would be performed with `branches` are printed in a
> > -       format that can be consumed by linkgit:git-update-ref[1].
> > +       the current `HEAD` reference will be rewritten.
> 
> Unrelated to this series, I've just realized I can't tell from these
> docs what the default --ref-action is. The code says "branches."

Good point indeed. I'll add another patch on top, thanks!

Patrick