{"thread":{"id":"46481","subject":"[PATCH] Documentation/checkout: clarify submodule HEADs to be detached","startedAt":"2017-07-28T21:40:23Z","lastAt":"2017-07-28T21:40:23Z","messageCount":1,"participants":["Stefan Beller"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"325228","messageId":"20170728214011.6184-1-sbeller@google.com","threadId":"46481","inReplyTo":null,"subject":"[PATCH] Documentation/checkout: clarify submodule HEADs to be detached","fromName":"Stefan Beller","fromEmail":"sbeller@google.com","sentAt":"2017-07-28T21:40:11Z","receivedAt":"2017-07-28T21:40:23Z","isPatch":true,"sender":{"key":"stefanbeller@gmail.com","avatar":"https://avatars.githubusercontent.com/u/455868?v=4"},"body":"Signed-off-by: Stefan Beller <sbeller@google.com>\n---\n\n  On top of sb/submodule-recursive-checkout-detach-head\n  \n  I also checked other man pages such as read-tree, which\n  already mentions the behavior as the fix implements:\n  \n       --[no-]recurse-submodules\n           Using --recurse-submodules will update the content of all\n           initialized submodules according to the commit recorded in the\n           superproject by calling read-tree recursively, also setting the\n           submodules HEAD to be detached at that commit.\n\n Documentation/git-checkout.txt | 2 ++\n 1 file changed, 2 insertions(+)\n\ndiff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt\nindex d6399c0af8..84bd323a00 100644\n--- a/Documentation/git-checkout.txt\n+++ b/Documentation/git-checkout.txt\n@@ -262,6 +262,8 @@ section of linkgit:git-add[1] to learn how to operate the `--patch` mode.\n \tlocal modifications in a submodule would be overwritten the checkout\n \twill fail unless `-f` is used. If nothing (or --no-recurse-submodules)\n \tis used, the work trees of submodules will not be updated.\n+\tJust like linkgit:git-submodule[1], this will detach the\n+\tsubmodules HEAD.\n \n <branch>::\n \tBranch to checkout; if it refers to a branch (i.e., a name that,\n-- \n2.14.0.rc0.3.g6c2e499285\n\n"}]}