I think I sent out the first 2 patches once upon a time, but the review or me resending them stalled. They improve the man page for the git-submodule command. The third patch is RFC-ish and adds a background story to submodules Similar to gitattributes, gitnamespaces, gittutorial it doesn't describe a particular command but e.g. explains design. Thanks, Stefan Stefan Beller (3): submodule documentation: add options to the subcommand submodule update documentation: don't repeat ourselves submodules: add a background story Documentation/git-submodule.txt | 93 +++++++-------------- Documentation/gitsubmodules.txt | 176 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 206 insertions(+), 63 deletions(-) create mode 100644 Documentation/gitsubmodules.txt -- 2.11.0.196.gee862f456e.dirty