path: root/Documentation/git-submodule.txt
diff options
authorBrandon Williams <>2017-03-17 22:38:02 (GMT)
committerJunio C Hamano <>2017-03-18 16:51:23 (GMT)
commit3e7eaed016e6241e96de6a0140923e81cfc387e8 (patch)
treee3bfda65b4bce0381f37830b20568b51b195aec4 /Documentation/git-submodule.txt
parenta086f921a725319a6f0c2c3aacf676c890b3ce3e (diff)
submodule init: initialize active submodules
Teach `submodule init` to initialize submodules which have been configured to be active by setting '' with a pathspec. Now if no path arguments are given and '' is configured, `init` will initialize all submodules which have been configured to be active. If no path arguments are given and '' is not configured, then `init` will retain the old behavior of initializing all submodules. This allows users to record more complex patterns as it saves retyping them whenever you invoke update. Signed-off-by: Brandon Williams <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-submodule.txt')
1 files changed, 3 insertions, 1 deletions
diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt
index e05d0cd..74bc620 100644
--- a/Documentation/git-submodule.txt
+++ b/Documentation/git-submodule.txt
@@ -129,7 +129,9 @@ init [--] [<path>...]::
repository will be assumed to be upstream.
Optional <path> arguments limit which submodules will be initialized.
-If no path is specified, all submodules are initialized.
+If no path is specified and has been configured, submodules
+configured to be active will be initialized, otherwise all submodules are
When present, it will also copy the value of `submodule.$name.update`.
This command does not alter existing information in .git/config.