git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v4 1/3] git-submodule.txt: "--branch <branch>" option defaults to 'master'

From
Denton Liu <liu.denton@gmail.com>
Date
Feb 8, 2019, 11:21 UTC
Message-ID
<2ba8751212b634dd18e16011b1714588e43502e1.1549624679.git.liu.denton@gmail.com>
In-Reply-To
<cover.1549624679.git.liu.denton@gmail.com>

This behavior is mentioned in gitmodules.txt but not in git-submodule.txt so we copy the information over so that it is not missed.

Also, add the missed argument to the -b/--branch option.
Signed-off-by: Denton Liu <liu.denton@gmail.com>
---
 Documentation/git-submodule.txt | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt
index ba3c4df550..4150148fa3 100644
--- a/Documentation/git-submodule.txt
+++ b/Documentation/git-submodule.txt
@@ -255,13 +255,14 @@ OPTIONS
 	This option is only valid for the deinit command. Unregister all
 	submodules in the working tree.
 
--b::
---branch::
+-b <branch>::
+--branch <branch>::
 	Branch of repository to add as submodule.
 	The name of the branch is recorded as `submodule.<name>.branch` in
 	`.gitmodules` for `update --remote`.  A special value of `.` is used to
 	indicate that the name of the branch in the submodule should be the
-	same name as the current branch in the current repository.
+	same name as the current branch in the current repository.  If the
+	option is not specified, it defaults to 'master'.
 
 -f::
 --force::
-- 
2.20.1.522.g5f42c252e9
Previous: Denton LiuNext: Denton Liu
Message 22 of 25 in “Teach submodule set-branch subcommand”
  1. 0/3 Teach submodule set-branch subcommandDenton Liu, Feb 6, 2019
  2. 1/3 git-submodule.txt: document default behavior without --branchDenton Liu, Feb 6, 2019
  3. Junio C HamanoFeb 6, 2019
  4. 2/3 submodule--helper: teach config subcommand --unsetDenton Liu, Feb 6, 2019
  5. Junio C HamanoFeb 6, 2019
  6. 3/3 submodule: teach set-branch subcommandDenton Liu, Feb 6, 2019
  7. 0/3 Teach submodule set-branch subcommandDenton Liu, Feb 7, 2019
  8. 1/3 git-submodule.txt: document default behavior without --branchDenton Liu, Feb 7, 2019
  9. 2/3 submodule--helper: teach config subcommand --unsetDenton Liu, Feb 7, 2019
  10. 3/3 submodule: teach set-branch subcommandDenton Liu, Feb 7, 2019
  11. 0/3 Teach submodule set-branch subcommandDenton Liu, Feb 7, 2019
  12. 1/3 git-submodule.txt: "--branch <branch>" option defaults to 'master'Denton Liu, Feb 7, 2019
  13. 2/3 submodule--helper: teach config subcommand --unsetDenton Liu, Feb 7, 2019
  14. Junio C HamanoFeb 7, 2019
  15. Junio C HamanoFeb 7, 2019
  16. 3/3 submodule: teach set-branch subcommandDenton Liu, Feb 7, 2019
  17. Junio C HamanoFeb 7, 2019
  18. Junio C HamanoFeb 7, 2019
  19. Denton LiuFeb 8, 2019
  20. Junio C HamanoFeb 8, 2019
  21. 0/3 Teach submodule set-branch subcommandDenton Liu, Feb 8, 2019
  22. 1/3 git-submodule.txt: "--branch <branch>" option defaults to 'master'Denton Liu, Feb 8, 2019
  23. 2/3 submodule--helper: teach config subcommand --unsetDenton Liu, Feb 8, 2019
  24. 3/3 submodule: teach set-branch subcommandDenton Liu, Feb 8, 2019
  25. Denton LiuFeb 8, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.