Message ID | 20200320213729.571924-4-damien.olivier.robert+git@gmail.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | doc: --recurse-submodules | expand |
> Le 20 mars 2020 à 17:37, Damien Robert <damien.olivier.robert@gmail.com> a écrit : > > + When set to true, it can be deactivated via the > + `--no-recurse-submodules` option. Note that some Git commands > + without this option may call some of the above commands affected by For clarity I'd write "some Git commands lacking this option" instead, as "without this option" *could* be interpreted as "invoked without this option". > + `submodule.recurse`; for instance `git remote update` will call > + `git fetch` but does not have a `--no-recurse-submodules` option. > + In this case a solution I'm not sure "solution" is the best word here, maybe: "For these commands a workaround is to temporarily change the configuration..." Note: s/temporary/temporarily/ > is to temporary change the configuration > + value by using `git -c submodule.recurse=0`.
diff --git a/Documentation/config/submodule.txt b/Documentation/config/submodule.txt index 5962f41ead..900d374385 100644 --- a/Documentation/config/submodule.txt +++ b/Documentation/config/submodule.txt @@ -63,6 +63,13 @@ submodule.recurse:: (`checkout`, `fetch`, `grep`, `pull`, `push`, `read-tree`, `reset`, `restore` and `switch`) except `clone` and `ls-files`. Defaults to false. + When set to true, it can be deactivated via the + `--no-recurse-submodules` option. Note that some Git commands + without this option may call some of the above commands affected by + `submodule.recurse`; for instance `git remote update` will call + `git fetch` but does not have a `--no-recurse-submodules` option. + In this case a solution is to temporary change the configuration + value by using `git -c submodule.recurse=0`. submodule.fetchJobs:: Specifies how many submodules are fetched/cloned at the same time.
Signed-off-by: Damien Robert <damien.olivier.robert+git@gmail.com> --- Documentation/config/submodule.txt | 7 +++++++ 1 file changed, 7 insertions(+)