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

Re: [PATCH] you_still_use_that(): reword the instructions

From
Michael Montalbo <mmontalbo@gmail.com>
Date
Aug 26, 2026, 17:12 UTC
Message-ID
<CAC2Qwm+Dx1UxLO3EOkQ-9uBokxacVfgrs7+XCj3BeM9vt8HcPw@mail.gmail.com>
In-Reply-To
<xmqqik4wizqf.fsf@gitster.g>
On Wed, Aug 26, 2026 at 10:00 AM Junio C Hamano <gitster@pobox.com> wrote:
Show 26 quoted lines
>
> Michael Montalbo <mmontalbo@gmail.com> writes:
>
> > I think this change makes sense.
> >
> >> +                 "- Send an email to <git@vger.kernel.org> asking for help, only if\n"
> >> +                 "  suggestions by others do not work for you.\n"
> >
> > Maybe a slight reword to reinforce the idea that the command is not coming
> > back:
> >
> >   "Send an email... asking for help, only if suggested replacements
> >     for the [now?] deprecated command do not work for you."
> >
> > Other than that suggestion, I think the change looks good.
>
> Not repeating 'replacement' there was deliberate for two reasons.
> First, the preceding instruction mentions others suggesting
> replacements, presenting an obvious opportunity to keep the wording
> concise.  Second, this message is meant to be generic.  For a case
> like 'whatschanged', the "new workflow" is to use another command
> (i.e., 'replacement'), but other cases may involve doing things
> differently and are not limited to a simple replacement with another
> command.
>
> And that is why the message only says "suggestions by others".
Got it, the reasoning for removing 'replacement' makes sense. Thank you.

Adding something like "[now] deprecated" or otherwise more explicitly suggesting the command does not intend to return is my main feedback.

Previous: Junio C HamanoNext: Michael Montalbo
Message 4 of 15 in “you_still_use_that(): reword the instructions”
  1. you_still_use_that(): reword the instructionsJunio C Hamano, Aug 26, 2026
  2. Michael MontalboAug 26, 2026
  3. Junio C HamanoAug 26, 2026
  4. Michael MontalboAug 26, 2026
  5. Michael MontalboAug 26, 2026
  6. Junio C HamanoAug 26, 2026
  7. Michael MontalboAug 26, 2026
  8. Michael MontalboAug 26, 2026
  9. Junio C HamanoAug 26, 2026
  10. you_still_use_that(): reword the instructionsJunio C Hamano, Aug 26, 2026
  11. Elijah NewrenAug 27, 2026
  12. Kristoffer HaugsbakkAug 27, 2026
  13. Junio C HamanoAug 27, 2026
  14. Junio C HamanoAug 27, 2026
  15. you_still_use_that(): reword the instructionsJunio C Hamano, Aug 27, 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.