Re: [PATCH 1/4] usage: help the user help themselves

From: Eric Sunshine <sunshine@sunshineco.com>
Date: Aug 27, 2025, 21:02 UTC
Message-ID: <CAPig+cRgBXX+b=P31VjQ6Dd4mciFvaUJ4T1oeOGjk7mwV-9KMw@mail.gmail.com>
In-Reply-To: <9611573e-fb0b-49d5-933a-50d8e0603701@app.fastmail.com>

On Wed, Aug 27, 2025 at 4:36 PM Kristoffer Haugsbakk <code@khaugsbakk.name> wrote:

Show 16 quoted lines

> On Wed, Aug 27, 2025, at 18:29, kristofferhaugsbakk@fastmail.com wrote:
> >       fprintf(stderr,
> >               _("'%s' is nominated for removal.\n"
> > +               "If you still use this command, here's what you can do:\n"
> > +               "\n"
> > +               "- read https://git-scm.com/docs/BreakingChanges.html\n"
> > +               "- check if anyone has discussed this on the mailing\n"
> > +               "  list and if they came up with something that can\n"
> > +               "  help you: https://lore.kernel.org/git/?q=%s\n"
> > +               "- send an email to <git@vger.kernel.org>\n"
>
> Maybe (thinking out loud) this should retain some part of the “let us
> know you still use this” spirit:
>
>     - send an email to <git@vger.kernel.org> and let us know
>       that you still use this command

That's still inviting unnecessary emails, isn't it? It would probably be better add the qualification that people should send the email only if they were unable to find any workable replacement. Perhaps:

    - send an email to <git@...> to let us know
      that you still use this command and were unable
      to determine a suitable replacement