/docs/MyDocs

Submodules

----------

 The submodules are git-repo within the git-repo.

 

 - Add the submodule:

    git submodule add <new-remote-repo> <path/name>

 

    * This generates '.gitmodules' file with configuration. When committing, only this file will go

    into the repository.

    * In the submodule directory you can checkout the required revision. It will be stored in the

    repository and always restored.

 

 - Selecting the branch

    git config -f .gitmodules submodule.<submodule>.branch <branch>     - Unless -f specified, the local change only will be made

    

 - Request submodule information on the status, diff, etc.

    git config status.submodulesummary 1

    git config --global diff.submodule log

    

 - Workign with submodules

    git submodule init                                                  - Registers submodule

    git submodule update                                                - Fetches the submodule

    git submodule update --remote                                       - Update the submodule

    

 - Workign with multiple submodules

    git submodule foreach 'git ...'