# [PATCH] submodules: update documentaion for submodule branches 5 messages from 2016-10-19 to 2016-10-19. Participants: Brandon Williams, Stefan Beller, Junio C Hamano. Thread: https://gitlist.dev/t/44331 ## Brandon Williams, 2016-10-19 20:42 Subject: [PATCH] submodules: update documentaion for submodule branches Message-ID: <20161019204254.97659-1-bmwill@google.com> URL: https://gitlist.dev/e/20161019204254.97659-1-bmwill%40google.com ``` Update the documentaion for the the special value `.` to indicate that it signifies that the tracking branch in the submodule should be the same as the current branch in the superproject. Signed-off-by: Brandon Williams --- Documentation/git-submodule.txt | 4 +++- Documentation/gitmodules.txt | 7 +++++-- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt index bf3bb37..d841573 100644 --- a/Documentation/git-submodule.txt +++ b/Documentation/git-submodule.txt @@ -259,7 +259,9 @@ OPTIONS --branch:: Branch of repository to add as submodule. The name of the branch is recorded as `submodule..branch` in - `.gitmodules` for `update --remote`. + `.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. -f:: --force:: diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt index 10dcc08..8f7c50f 100644 --- a/Documentation/gitmodules.txt +++ b/Documentation/gitmodules.txt @@ -50,8 +50,11 @@ submodule..update:: submodule..branch:: A remote branch name for tracking updates in the upstream submodule. - If the option is not specified, it defaults to 'master'. See the - `--remote` documentation in linkgit:git-submodule[1] for details. + If the option is not specified, it defaults to 'master'. 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. See the `--remote` documentation in + linkgit:git-submodule[1] for details. submodule..fetchRecurseSubmodules:: This option can be used to control recursive fetching of this -- 2.10.1 ``` ## Stefan Beller, 2016-10-19 20:45 Subject: Re: [PATCH] submodules: update documentaion for submodule branches Message-ID: URL: https://gitlist.dev/e/CAGZ79kZAgT2ac_D-xiYCWY-bJZYNx4r7zqbf2i0d4%3Dvfmamw4A%40mail.gmail.com In-Reply-To: <20161019204254.97659-1-bmwill@google.com> ``` On Wed, Oct 19, 2016 at 1:42 PM, Brandon Williams wrote: > Update the documentaion for the the special value `.` to indicate that > it signifies that the tracking branch in the submodule should be the > same as the current branch in the superproject. For reference of other reviewers: See 4d7bc52b178bffe9e484c4dcd92d5353e2ce716f as well as https://gerrit-review.googlesource.com/Documentation/user-submodules.html Thanks, Stefan > > Signed-off-by: Brandon Williams > --- > Documentation/git-submodule.txt | 4 +++- > Documentation/gitmodules.txt | 7 +++++-- > 2 files changed, 8 insertions(+), 3 deletions(-) > > diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt > index bf3bb37..d841573 100644 > --- a/Documentation/git-submodule.txt > +++ b/Documentation/git-submodule.txt > @@ -259,7 +259,9 @@ OPTIONS > --branch:: > Branch of repository to add as submodule. > The name of the branch is recorded as `submodule..branch` in > - `.gitmodules` for `update --remote`. > + `.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. > > -f:: > --force:: > diff --git a/Documentation/gitmodules.txt b/Documentation/gitmodules.txt > index 10dcc08..8f7c50f 100644 > --- a/Documentation/gitmodules.txt > +++ b/Documentation/gitmodules.txt > @@ -50,8 +50,11 @@ submodule..update:: > > submodule..branch:: > A remote branch name for tracking updates in the upstream submodule. > - If the option is not specified, it defaults to 'master'. See the > - `--remote` documentation in linkgit:git-submodule[1] for details. > + If the option is not specified, it defaults to 'master'. 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. See the `--remote` documentation in > + linkgit:git-submodule[1] for details. > > submodule..fetchRecurseSubmodules:: > This option can be used to control recursive fetching of this > -- > 2.10.1 > ``` ## Junio C Hamano, 2016-10-19 21:42 Subject: Re: [PATCH] submodules: update documentaion for submodule branches Message-ID: URL: https://gitlist.dev/e/xmqqmvi0j9rv.fsf%40gitster.mtv.corp.google.com In-Reply-To: <20161019204254.97659-1-bmwill@google.com> ``` Brandon Williams writes: > Update the documentaion for the the special value `.` to indicate that > it signifies that the tracking branch in the submodule should be the > same as the current branch in the superproject. Thanks. Will typofix while extending with info supplied by Stefan like so: submodules doc: update documentation for "." used for submodule branches 4d7bc52b17 ("submodule update: allow '.' for branch value", 2016-08-03) adopted from Gerrit a feature to set "." as a special value of "submodule..branch" in .gitmodules file to indicate that it signifies that the tracking branch in the submodule should be the same as the current branch in the superproject. Update the documentation to describe this. ``` ## Junio C Hamano, 2016-10-19 22:43 Subject: Re: [PATCH] submodules: update documentaion for submodule branches Message-ID: URL: https://gitlist.dev/e/xmqqzim0hsdz.fsf%40gitster.mtv.corp.google.com In-Reply-To: ``` Junio C Hamano writes: > Brandon Williams writes: > >> Update the documentaion for the the special value `.` to indicate that >> it signifies that the tracking branch in the submodule should be the >> same as the current branch in the superproject. > > Thanks. Will typofix while extending with info supplied by Stefan > like so: Ugh. Should have proof-read before sending it out. > 4d7bc52b17 ("submodule update: allow '.' for branch value", > 2016-08-03) adopted from Gerrit a feature to set "." as a special > value of "submodule..branch" in .gitmodules file to indicate > that it signifies that the tracking branch in the submodule should > be the same as the current branch in the superproject. ... in .gitmodules file to indicate that the tracking branch in the submodule should be ... "to indicate that it signifies that" was overly redundant. ``` ## Brandon Williams, 2016-10-19 23:01 Subject: Re: [PATCH] submodules: update documentaion for submodule branches Message-ID: <20161019230130.GA21768@google.com> URL: https://gitlist.dev/e/20161019230130.GA21768%40google.com In-Reply-To: ``` On 10/19, Junio C Hamano wrote: > Junio C Hamano writes: > > > Brandon Williams writes: > > > >> Update the documentaion for the the special value `.` to indicate that > >> it signifies that the tracking branch in the submodule should be the > >> same as the current branch in the superproject. > > > > Thanks. Will typofix while extending with info supplied by Stefan > > like so: > > Ugh. Should have proof-read before sending it out. > > > 4d7bc52b17 ("submodule update: allow '.' for branch value", > > 2016-08-03) adopted from Gerrit a feature to set "." as a special > > value of "submodule..branch" in .gitmodules file to indicate > > that it signifies that the tracking branch in the submodule should > > be the same as the current branch in the superproject. > > ... in .gitmodules file to indicate that the tracking branch in > the submodule should be ... > > "to indicate that it signifies that" was overly redundant. Sorry that seems to have stemed from my poor commit message. -- Brandon Williams ```