doc: explain how to deactivate submodule.recurse completely
Signed-off-by: Damien Robert <damien.olivier.robert+git@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Damien Robert committed
Apr 6, 2020 at 15:57 UTC
d09bc51428274bbb03669e4fb33f74b4edbe40dd
1 file changed
+7
Documentation/config/submodule.txt
+7
@@ -63,6 +63,13 @@ submodule.recurse::
63
(`checkout`, `fetch`, `grep`, `pull`, `push`, `read-tree`, `reset`,
64
`restore` and `switch`) except `clone` and `ls-files`.
65
Defaults to false.
66
+ When set to true, it can be deactivated via the
67
+ `--no-recurse-submodules` option. Note that some Git commands
68
+ lacking this option may call some of the above commands affected by
69
+ `submodule.recurse`; for instance `git remote update` will call
70
+ `git fetch` but does not have a `--no-recurse-submodules` option.
71
+ For these commands a workaround is to temporarily change the
72
+ configuration value by using `git -c submodule.recurse=0`.
73
74
submodule.fetchJobs::
75
Specifies how many submodules are fetched/cloned at the same time.