Git stores information about submodules in two places. The first is in a file called .gitmodules
, which is checked in to the git repository. Changes to this file are what get propagated to other repositories.
The other location is in .git/config
, and it‘s where git actually looks when performing most commands.
So imagine you‘ve worked on a project for a while, and there‘s a submodule called foo
.
Files for this submodule are checked out from some url, it doesn‘t really matter where.
At some point, however, this url changes.
Perhaps it changes so that the submodule is checked out from a different server, or a different path or whatever.
When you update your repository your copy of the .gitmodules
file will be updated, but not your .git/config
file; you would still be checking out from the old url.
When you want to start checking out from the new url, you would run git submodule sync
to copy the new configuration from .gitmodules
to .git/config
.
Git doesn‘t do this automatically because you might have made your own changes to your configuration, and it wouldn‘t want to overwrite them.