From: Eric Sunshine <sunshine@sunshineco.com>
Date: Wed, 27 Aug 2025 21:02:28 GMT
Subject: Re: [PATCH 1/4] usage: help the user help themselves
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:
> 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