git/Documentation/git-submodule.txt, branch gitk-resize-error

submodule: fall back to remote's HEAD for missing remote..branch

2020-06-24T16:14:21Z

When `remote..branch` is not configured, `git submodule update` currently falls back to using the branch name `master`. A much better idea, however, is to use the remote `HEAD`: on all Git servers running reasonably recent Git versions, the symref `HEAD` points to the main branch. Note: t7419 demonstrates that there _might_ be use cases out there that _expect_ `git submodule update --remote` to update submodules to the remote `master` branch even if the remote `HEAD` points to another branch. Arguably, this patch makes the behavior more intuitive, but there is a slight possibility that this might cause regressions in obscure setups. Even so, it should be okay to fix this behavior without anything like a longer transition period: - The `git submodule update --remote` command is not really common. - Current Git's behavior when running this command is outright confusing, unless the remote repository's current branch _is_ `master` (in which case the proposed behavior matches the old behavior). - If a user encounters a regression due to the changed behavior, the fix is actually trivial: setting `submodule..branch` to `master` will reinstate the old behavior. Helped-by: Philippe Blain Signed-off-by: Johannes Schindelin Signed-off-by: Junio C Hamano

Merge branch 'es/recursive-single-branch-clone'

2020-03-05T18:43:03Z

"git clone --recurse-submodules --single-branch" now uses the same single-branch option when cloning the submodules. * es/recursive-single-branch-clone: clone: pass --single-branch during --recurse-submodules submodule--helper: use C99 named initializer

clone: pass --single-branch during --recurse-submodules

2020-02-25T18:00:38Z

Previously, performing "git clone --recurse-submodules --single-branch" resulted in submodules cloning all branches even though the superproject cloned only one branch. Pipe --single-branch through the submodule helper framework to make it to 'clone' later on. Signed-off-by: Emily Shaffer Acked-by: Jeff King Signed-off-by: Junio C Hamano

Merge branch 'km/submodule-doc-use-sm-path'

2020-02-12T20:41:37Z

Docfix. * km/submodule-doc-use-sm-path: submodule foreach: replace $path with $sm_path in example

submodule foreach: replace $path with $sm_path in example

2020-01-31T20:57:18Z

f0fd0dc5c5 (submodule foreach: document '$sm_path' instead of '$path', 2018-05-08) updated the documentation to advise callers to favor $sm_path over the deprecated synonym $path. However, the example in that section still uses $path. Update it to use $sm_path. Signed-off-by: Kyle Meyer Signed-off-by: Junio C Hamano

Merge branch 'tm/doc-submodule-absorb-fix'

2020-01-08T20:44:12Z

Typofix. * tm/doc-submodule-absorb-fix: doc: submodule: fix typo for command absorbgitdirs

doc: submodule: fix typo for command absorbgitdirs

2020-01-06T17:24:46Z

The sentence wants to talk about the superproject's possesive, not plural form. Signed-off-by: Thomas Menzel Signed-off-by: Junio C Hamano

Merge branch 'dl/submodule-set-url'

2019-12-10T21:11:42Z

"git submodule" learned a subcommand "set-url". * dl/submodule-set-url: submodule: teach set-url subcommand

Merge branch 'mg/doc-submodule-status-cached'

2019-12-05T20:52:47Z

"git submodule status" and "git submodule status --cached" show different things, but the documentation did not cover them correctly, which has been corrected. * mg/doc-submodule-status-cached: doc: document 'git submodule status --cached'

Merge branch 'pb/submodule-update-fetches'

2019-12-05T20:52:45Z

Doc update. * pb/submodule-update-fetches: doc: mention that 'git submodule update' fetches missing commits