path: root/t/
diff options
authorJohan Herland <>2009-08-19 23:07:43 (GMT)
committerJunio C Hamano <>2009-08-20 23:59:50 (GMT)
commite7fed18a89fae97655687e19f13cd802d8d70845 (patch)
treee9bd4f339a705f2290348e42a96ed69986cbe514 /t/
parente3ae4a8613151c93ffce78c674ac91c1ee34eef6 (diff)
git clone: Add --recursive to automatically checkout (nested) submodules
Many projects using submodules expect all submodules to be checked out in order to build/work correctly. A common command sequence for developers on such projects is: git clone url/to/project cd project git submodule update --init (--recursive) This patch introduces the --recursive option to git-clone. The new option causes git-clone to recursively clone and checkout all submodules of the cloned project. Hence, the above command sequence can be reduced to: git clone --recursive url/to/project --recursive is ignored if no checkout is done by the git-clone. The patch also includes documentation and a selftest. Signed-off-by: Johan Herland <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 't/')
1 files changed, 12 insertions, 0 deletions
diff --git a/t/ b/t/
index 519db49..2a52775 100755
--- a/t/
+++ b/t/
@@ -222,4 +222,16 @@ test_expect_success 'test "status --recursive"' '
test_cmp expect actual
+test_expect_success 'use "git clone --recursive" to checkout all submodules' '
+ git clone --recursive super clone4 &&
+ test -d clone4/.git &&
+ test -d clone4/sub1/.git &&
+ test -d clone4/sub2/.git &&
+ test -d clone4/sub3/.git &&
+ test -d clone4/nested1/.git &&
+ test -d clone4/nested1/nested2/.git &&
+ test -d clone4/nested1/nested2/nested3/.git &&
+ test -d clone4/nested1/nested2/nested3/submodule/.git