GIT SUBMODULES

Everything
Is A
Reference

Submodules
Refer to
Commits

Keep a Git repository as a subdirectory of another Git repository

So you can keep your commits separate.

Tips

git clone --recursive <repo>
git submodule foreach git stash

What to do when things break

If you create a new branch, add a submodule there, and then switch back to a branch without that submodule, you still have the submodule directory as an untracked directory

$ git checkout -b add-library
Switched to a new branch 'add-library'

$ git submodule add <library>
Cloning into 'library'...
...

$ git commit -am 'adding library library'
[add-library 4445836] adding library library
 2 files changed, 4 insertions(+)
 create mode 160000 library

$ git checkout master
warning: unable to rmdir library: Directory not empty
Switched to branch 'master'
Your branch is up-to-date with 'origin/master'.

$ git status
On branch master
Your branch is up-to-date with 'origin/master'.

Untracked files:
  (use "git add <file>..." to include in what will be committed)

	library/

nothing added to commit but untracked files present (use "git add" to track)

Fix

$ git clean -fdx
Removing library/

$ git checkout add-library
Switched to branch 'add-library'

$ ls library/

$ git submodule update --init
Submodule path 'library': checked out 'b8dda6aa182ea4464f3f3264b11e0268545172af'

$ ls library/
Makefile		src

Delete

Delete the relevant line from the .gitmodules file.

Delete the relevant section from .git/config.

Run git rm --cached path_to_submodule (no trailing slash).

Commit and delete the now untracked submodule files.

SUBMODULES

By ..

SUBMODULES

  • 1,759