From ca0fc739741b72b50641e382a6162a829447237f Mon Sep 17 00:00:00 2001 From: "W. Trevor King" Date: Thu, 8 Nov 2012 21:52:11 -0500 Subject: [PATCH] git-submodule: Motivate --record with an example use case Signed-off-by: W. Trevor King --- Documentation/git-submodule.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt index 9a99826d5..d4e993faf 100644 --- a/Documentation/git-submodule.txt +++ b/Documentation/git-submodule.txt @@ -220,6 +220,14 @@ OPTIONS is not set either, `HEAD` will be recorded. Because the branch name is optional, you must use the equal-sign form (`-r=`), not `-r `. ++ +The recorded setting is not actually used by git; however, some +external tools and workflows may make use of it. For example, if the +upstream branches still exist and you have a recorded branch setting +for each of your submodules, you can update all of the submodules to +the current branch tips with: ++ + git submodule foreach 'git checkout $submodule_branch && git pull' -f:: --force:: -- 2.26.2