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

Re: [PATCH v2 00/11] Spring cleanup of "contrib/"

From
Patrick Steinhardt <ps@pks.im>
Date
May 12, 2025, 09:39 UTC
Message-ID
<aCHB08edPcxWCMiP@pks.im>
In-Reply-To
<CABPp-BFYuYnbHG9uUOig8gpqrLywESf6fs62e_CMi2uCtNXYYw@mail.gmail.com>
On Fri, May 09, 2025 at 04:53:54PM -0700, Elijah Newren wrote:
Show 27 quoted lines
> On Fri, May 9, 2025 at 2:20 AM Patrick Steinhardt <ps@pks.im> wrote:
> >
> > Hi,
> >
> > as I have lamented multiple times multiple times already (e.g. [1]), the
> > "contrib/" directory is a bit of a mess containing many bits and pieces
> > that just sit there gathering dust, without getting any maintenance and
> > sometimes even in a clearly-broken state. So I decided to finally bite
> > the bullet and do a spring cleanup of "contrib/", which resulted in this
> > patch series here.
> >
> > I have used the following reasons for removal:
> >
> >   - The tool is clearly broken, e.g. it doesn't even compile.
> >
> >   - The tool hasn't received any updates for at least the last 5 years.
> >
> >   - The tool has a clear alternative or just isn't useful anymore.
> 
> Do we still want to use your second reason listed as a reason to
> remove?  Junio brought that up on v1, and it bothers me a bit too.
> Now, if you couple that with "contrib is meant as staging and projects
> should graduate or be removed", then I'd be fine with it, but you said
> later in this cover letter that you were going to post that
> information in a follow-up series.  That makes me wonder whether the
> removal of tools for this reason should be deferred to that later
> series where that new direction is recorded.

The only part that I would count into the category is parts of commit 11, and I'd be okay with dropping it for now.

Show 20 quoted lines
> That all said, I tried to do a count of which patches used which
> rationale (though I split out a fourth because it makes more sense to
> me that way).  I see:
> 
>   - broken tool: patches 1, 7
>   - not updated: patches 4, part of 11
>   - better alternative: patches 1, 3, 5, 6, 8, 9, 10, part of 11
>   - already removed with just a stub left behind: patches 2, 3
> 
> (Here I excluded patches from the "not updated" category if there was
> also an additional rationale given in the commit message.  For other
> rationales, I put the patch under each category that was brought up as
> a reason for retirement.)
> 
> So this series doesn't rely solely on the "not updated" rationale very
> much.  Even in patch 4 you allude to the fact that you _suspect_ that
> tool also falls under the "broken tool" category, and in patch 11, you
> also argue that it should be handled differently if it's useful (which
> rhymes with saying that a better alternative exists, but isn't the
> same since one doesn't necessarily exist yet).

Yeah, I wouldn't categorize patch 4 into the "not updated" category. It's the ecosystem it depends on that hasn't been updated, which isn't quite the same.

Show 5 quoted lines
> Anyway, I like the series, I'm just a little uncomfortable with this
> part of the cover letter and the wording of some of the commit
> messages.  "not updated in 5 years" is good supplemental information,
> but I think other git contributors reading those commit messages might
> get the wrong idea and apply it elsewhere.

Okay, I'll try to rephrase both the cover letter and the indvidual commit messages to make sufficiently clear that this is only used as supporting evidence that something can be removed.

Patrick
Previous: Junio C HamanoNext: Collin Funk
Message 49 of 62 in “Spring cleanup of "contrib/"”
  1. 00/10 Spring cleanup of "contrib/"Patrick Steinhardt, May 6, 2025
  2. 02/10 contrib: remove "examples" directoryPatrick Steinhardt, May 6, 2025
  3. 01/10 contrib: remove "remotes2config.sh"Patrick Steinhardt, May 6, 2025
  4. Junio C HamanoMay 6, 2025
  5. Patrick SteinhardtMay 7, 2025
  6. Junio C HamanoMay 7, 2025
  7. 03/10 contrib: remove remote-helper stubsPatrick Steinhardt, May 6, 2025
  8. 04/10 contrib: remove "thunderbird-patch-inline"Patrick Steinhardt, May 6, 2025
  9. 05/10 contrib: remove "hooks" directoryPatrick Steinhardt, May 6, 2025
  10. 06/10 contrib: remove "mw-to-git"Patrick Steinhardt, May 6, 2025
  11. Junio C HamanoMay 6, 2025
  12. Matthieu MoyMay 7, 2025
  13. 08/10 contrib: remove "git-resurrect.sh"Patrick Steinhardt, May 6, 2025
  14. Junio C HamanoMay 6, 2025
  15. Patrick SteinhardtMay 7, 2025
  16. Junio C HamanoMay 7, 2025
  17. Kristoffer HaugsbakkMay 7, 2025
  18. 09/10 contrib: remove "emacs" directoryPatrick Steinhardt, May 6, 2025
  19. Junio C HamanoMay 6, 2025
  20. 07/10 contrib: remove "persistent-https" remote helperPatrick Steinhardt, May 6, 2025
  21. Junio C HamanoMay 6, 2025
  22. 10/10 contrib: remove "git-new-workdir"Patrick Steinhardt, May 6, 2025
  23. Junio C HamanoMay 6, 2025
  24. Patrick SteinhardtMay 7, 2025
  25. Junio C HamanoMay 7, 2025
  26. Patrick SteinhardtMay 9, 2025
  27. Junio C HamanoMay 6, 2025
  28. Eric SunshineMay 6, 2025
  29. Todd ZullingerMay 7, 2025
  30. Eric SunshineMay 7, 2025
  31. Patrick SteinhardtMay 7, 2025
  32. D. Ben KnobleMay 10, 2025
  33. Phillip WoodMay 12, 2025
  34. 00/11 Spring cleanup of "contrib/"Patrick Steinhardt, May 9, 2025
  35. 01/11 contrib: remove "remotes2config.sh"Patrick Steinhardt, May 9, 2025
  36. 02/11 contrib: remove "examples" directoryPatrick Steinhardt, May 9, 2025
  37. 03/11 contrib: remove remote-helper stubsPatrick Steinhardt, May 9, 2025
  38. 04/11 contrib: remove "thunderbird-patch-inline"Patrick Steinhardt, May 9, 2025
  39. 05/11 contrib: remove "hooks" directoryPatrick Steinhardt, May 9, 2025
  40. 06/11 contrib: remove "mw-to-git"Patrick Steinhardt, May 9, 2025
  41. 08/11 contrib: remove "git-resurrect.sh"Patrick Steinhardt, May 9, 2025
  42. 07/11 contrib: remove "persistent-https" remote helperPatrick Steinhardt, May 9, 2025
  43. 09/11 contrib: remove "emacs" directoryPatrick Steinhardt, May 9, 2025
  44. 10/11 contrib: remove "git-new-workdir"Patrick Steinhardt, May 9, 2025
  45. 11/11 contrib: remove "stats" directoryPatrick Steinhardt, May 9, 2025
  46. Elijah NewrenMay 9, 2025
  47. Elijah NewrenMay 9, 2025
  48. Junio C HamanoMay 10, 2025
  49. Patrick SteinhardtMay 12, 2025
  50. Collin FunkMay 12, 2025
  51. Phillip WoodMay 12, 2025
  52. Patrick SteinhardtMay 12, 2025
  53. Junio C HamanoMay 12, 2025
  54. Phillip WoodMay 14, 2025
  55. contrib: update thunderbird-patch-inlinePhillip Wood, May 16, 2025
  56. Kristoffer HaugsbakkMay 16, 2025
  57. Patrick SteinhardtMay 19, 2025
  58. Collin FunkMay 19, 2025
  59. Phillip WoodMay 19, 2025
  60. Junio C HamanoJun 3, 2025
  61. Junio C HamanoMay 19, 2025
  62. Peter KreftingMay 10, 2025

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.