This is v3, incorporating all remarks received: - The typos mistakes mentioned by Robert and Junio. - The main change is patch 5/5 where I incorporated the nice explanations of Philippe Blain. Damien Robert (5): doc: list all commands affected by submodule.recurse doc: document --recurse-submodules for reset and restore doc: explain how to deactivate submodule.recurse completely doc: be more precise on (fetch|push).recurseSubmodules doc: --recurse-submodules mostly only apply to active submodules Documentation/config/fetch.txt | 10 ++++++---- Documentation/config/push.txt | 2 ++ Documentation/config/submodule.txt | 12 ++++++++++-- Documentation/fetch-options.txt | 3 ++- Documentation/git-checkout.txt | 2 +- Documentation/git-grep.txt | 2 +- Documentation/git-ls-files.txt | 2 +- Documentation/git-pull.txt | 5 ++--- Documentation/git-read-tree.txt | 2 +- Documentation/git-reset.txt | 6 ++++++ Documentation/git-restore.txt | 10 ++++++++++ Documentation/git-switch.txt | 2 +- Documentation/gitsubmodules.txt | 3 ++- 13 files changed, 45 insertions(+), 16 deletions(-) -- Patched on top of v2.26.0-rc2-27-gbe8661a328 (git version 2.25.2)