summaryrefslogtreecommitdiff
path: root/Documentation/git-submodule.txt
diff options
context:
space:
mode:
authorBrandon Williams <bmwill@google.com>2017-03-17 22:38:02 (GMT)
committerJunio C Hamano <gitster@pobox.com>2017-03-18 16:51:23 (GMT)
commit3e7eaed016e6241e96de6a0140923e81cfc387e8 (patch)
treee3bfda65b4bce0381f37830b20568b51b195aec4 /Documentation/git-submodule.txt
parenta086f921a725319a6f0c2c3aacf676c890b3ce3e (diff)
downloadgit-3e7eaed016e6241e96de6a0140923e81cfc387e8.zip
git-3e7eaed016e6241e96de6a0140923e81cfc387e8.tar.gz
git-3e7eaed016e6241e96de6a0140923e81cfc387e8.tar.bz2
submodule init: initialize active submodules
Teach `submodule init` to initialize submodules which have been configured to be active by setting 'submodule.active' with a pathspec. Now if no path arguments are given and 'submodule.active' is configured, `init` will initialize all submodules which have been configured to be active. If no path arguments are given and 'submodule.active' 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 <bmwill@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-submodule.txt')
-rw-r--r--Documentation/git-submodule.txt4
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 submodule.active has been configured, submodules
+configured to be active will be initialized, otherwise all submodules are
+initialized.
+
When present, it will also copy the value of `submodule.$name.update`.
This command does not alter existing information in .git/config.