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

Re: [PATCH] chdir-notify.h: Removed unused param 'name'

From
Jeff King <peff@peff.net>
Date
Aug 14, 2026, 20:31 UTC
Message-ID
<20260814203100.GB2575854@coredump.intra.peff.net>
In-Reply-To
<20260814193849.1538-1-colinlewishinton@gmail.com>
On Fri, Aug 14, 2026 at 12:38:49PM -0700, Colin Hinton wrote:
> the `name` parameter in `chdir_notify_entry` is only set to NULL.
> Dropped to simplify logic in `chdir_notify_unregister`

I think this makes sense. It is often helpful in cleanup patches to summarize the history in the commit message. And then we can be sure that the unused field is OK to be removed, and it is not simply a bug that nobody is passing in the value.

It looks like these became NULL in the callers across several functions, like 1f43ff2c7e (refs: unregister reference stores from "chdir_notify", 2026-06-25) and 0de2467e6c (odb/source-packed: start converting to a proper `struct odb_source`, 2026-06-17). With hunks like this:

  -       chdir_notify_reparent("files-backend $GIT_DIR", &refs->base.gitdir);
  -       chdir_notify_reparent("files-backend $GIT_COMMONDIR",
  -                             &refs->gitcommondir);
  +       chdir_notify_register(NULL, files_ref_store_reparent, refs);

None of those indicate why they drop the descriptive names in favor of NULL.

I think ultimately the reason is that the only user of the "name" field was chdir_notify_reparent(), when it produced trace output. That went away in 5bf546755c (chdir-notify: drop unused `chdir_notify_reparent()`, 2026-06-25).

So those other patches were preparing for that world, though I think the ordering is somewhat confusing (and I won't be surprised if there was some intermediate state where turning on tracing might have caused a segfault).

So AFAICT the patch itself is good, but it might be nice to give some explanation in the commit message.

-Peff
Previous: Colin HintonNext: Junio C Hamano
Message 2 of 5 in “chdir-notify.h: Removed unused param 'name'”
  1. chdir-notify.h: Removed unused param 'name'Colin Hinton, Aug 14, 2026
  2. Jeff KingAug 14, 2026
  3. Junio C HamanoAug 14, 2026
  4. chdir-notify.h: Removed unused param 'name'Colin Hinton, Aug 14, 2026
  5. Jeff KingAug 15, 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.