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

Re: [PATCH 0/3] worktree: add --recurse-submodules support to git worktree add

From
PWPhillip Wood <phillip.wood123@gmail.com>
Date
Apr 17, 2026, 09:38 UTC
Message-ID
<9f46e619-2f34-465f-8bb8-6688f8b56cc0@gmail.com>
In-Reply-To
<19b86e02-6842-42f0-8226-c86ad6669ec4@gmail.com>
On 16/04/2026 19:38, Phillip Wood wrote:
Show 39 quoted lines
> On 16/04/2026 18:05, Junio C Hamano wrote:
>> Jimmy Aguilar Mena <kratsbinovish@gmail.com> writes:
>>
>>> The approach follows Phillip Wood's and Junio's feedback: each linked
>>> worktree gets its own per-worktree submodule gitdir under
>>> $GIT_COMMON_DIR/worktrees/<id>/modules/<name>/, so HEAD, refs, and
>>> the index are independent per worktree while pack files and loose
>>> objects are shared via hardlinks.  The gitdir isolation is the same
>>> model git worktree already uses for the superproject.
>>
>> I do not quite follow.  The point of git-native worktree support
>> (which improved a lot compared to its precursor, "git-new-workdir",
>> is that it can work well in a hardlink-challenged platforms.  You
>> shouldn't worry about "hardlinking" yourself at all.
>>
>> After the superproject successfully did "submodule init", you can
>> move the submodule's repository with "absorbgitdirs" to
>> $GIT_DIR/modules/<submodule>/ of the superproject.  The primary
>> motivation behind this feature was that you can switch to a commit
>> in the superproject that does *not* have the submodule bound to it
>> at all (and obviously you do not want to lose the submodule
>> repository only because you tentatively switch to such a commit and
>> have to re-download when you switch back), but I think it gives the
>> single instance of submodule repository that you can share across
>> worktrees of the submodule.  Because the single directory created
>> with "absorbgitdirs" looks like a bare repository, you should be
>> able to create two worktrees off of that, with their own HEAD etc.
> 
> I haven't thought much about it but that would mean that "git worktree 
> remove" ought to remove the submodule's worktree when the worktree 
> containing the submodule is removed. Worktrees avoid hardlinks by 
> creating a "commondir" file in the worktree's gitdir which contains the 
> relative path to "$GIT_COMMON_DIR". I think we could probably do the 
> same here and create "$GIT_COMMON_DIR/worktrees/<id>/modules/<name>/ 
> commondir" containing "../../../../modules/<name>" if we want to store 
> the submodule's gitdir under the worktree's gitdir. That way removing a 
> worktree's gitdir removes all the gitdirs of its submodules without any 
> extra effort. There are probably other tradeoffs between the two 
> approaches that I've not thought of.

I've realized that creating the submodule's gitdir under the worktree's gitdir means that "git gc" running in the submodule repository wont see the per-worktree refs and index file and will happily prune those objects. Junio's suggestion avoids that problem.

Thanks
Phillip
Previous: Phillip Wood
Message 4 of 4 in “worktree: add --recurse-submodules support to git worktree add”
  1. 0/3 worktree: add --recurse-submodules support to git worktree addJimmy Aguilar Mena, Apr 16, 2026
  2. Junio C HamanoApr 16, 2026
  3. Phillip WoodApr 16, 2026
  4. Phillip WoodApr 17, 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.