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

Re: Nesting a submodule inside of another...

From
Jens Lehmann <jens.lehmann@web.de>
Date
Jul 12, 2011, 19:23 UTC
Message-ID
<4E1C9F21.6070300@web.de>
In-Reply-To
<CAEBDL5XQDehUyqKoazxy+YVHh_2iAyt9aE-77H1jZg4oujMJgw@mail.gmail.com>
Am 12.07.2011 14:01, schrieb John Szakmeister:
Show 13 quoted lines
> I've got a project where we have several frameworks involved, and
> external modules we want to pull into the framework tree.  We'd like
> to make use of submodules and have something like this:
>     top-level/            <-- .gitmodules lives here
>         src/
>         framework1/   <-- a submodule
>             module/     <-- another submodule
>         framework2/   <-- a submodule
>             module2/    <-- another submodule
> 
> Currently, git fails trying to do this.  It's not happy about
> .gitmodules living at the top-level and nesting a submodule inside of
> another[1].  Is there a technical reason that this is not allowed?

Submodules are repositories of their own, so their work tree is outside the superproject's work tree. You're attempting to have a submodule of the superproject inside another submodule of the superproject, but this won't work because it does not live in the superproject's work tree (as that doesn't include submodules and their subdirectories).

To have nested submodules you must add "module" as a submodule of "framework1" and "module2" as a submodule of "framework2". Then git will handle them just fine (assuming you use the --recursive option for "git submodule update" and friends). Of course that means that if you want to record a new commit of a sub-submodule in the superpoject, you'll have to commit that in it's parent submodule first and then can record that commit in the superproject. (But if "framework1" wouldn't depend on a specific version of "module", there would be no reason to put it inside it in the first place, right?)

> Limiting the traversal up the tree, etc.?  I've worked around the lack
> of support to do this for now, but it would be really nice if we could
> do such a thing.
I can't think of a sane way to make that work.
Show 9 quoted lines
> [1]  I may generate a patch for the error message, as the current
> implementation obscures the real error message.  When I try this, git
> says:
>     The following path is ignored by one of your .gitignore files:
>     framework1/module
>     Use -f if you really want to add it.
> 
>     After some careful debugging, I found out the real error message
> was about this sort of nesting being disallowed.

But at least since 1.6.2 git should issue a meaningful error message. With current master I get:

$ git add sub/file fatal: Path 'sub/file' is in submodule 'sub'

What version are you using?
Previous: John SzakmeisterNext: John Szakmeister
Message 2 of 11 in “Nesting a submodule inside of another...”
  1. John SzakmeisterJul 12, 2011
  2. Jens LehmannJul 12, 2011
  3. John SzakmeisterJul 13, 2011
  4. Jens LehmannJul 13, 2011
  5. Junio C HamanoJul 13, 2011
  6. Jens LehmannJul 13, 2011
  7. Junio C HamanoJul 13, 2011
  8. John SzakmeisterJul 14, 2011
  9. Seth RobertsonJul 14, 2011
  10. John SzakmeisterJul 15, 2011
  11. Andreas EricssonJul 13, 2011

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.