diff options
| author | Junio C Hamano <junio@hera.kernel.org> | 2008-08-21 10:34:22 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@hera.kernel.org> | 2008-08-21 10:34:22 +0000 |
| commit | 3f2f6e5d768e1e09e959ec54a26e552b5dfc4f14 (patch) | |
| tree | d4d3b9e33da31ec8fb99af5d4376194ac84fbfa6 /git-submodule.html | |
| parent | 3580ad240fadb5ab479fd96c65350ec2b77c33bd (diff) | |
| download | git-htmldocs-3f2f6e5d768e1e09e959ec54a26e552b5dfc4f14.tar.gz | |
Autogenerated HTML docs for v1.6.0-90-g436ed
Diffstat (limited to 'git-submodule.html')
| -rw-r--r-- | git-submodule.html | 24 |
1 files changed, 22 insertions, 2 deletions
diff --git a/git-submodule.html b/git-submodule.html index 4d00e64cf..e4037fd08 100644 --- a/git-submodule.html +++ b/git-submodule.html @@ -325,7 +325,8 @@ git-submodule(1) Manual Page <em>git submodule</em> [--quiet] status [--cached] [--] [<path>…]
<em>git submodule</em> [--quiet] init [--] [<path>…]
<em>git submodule</em> [--quiet] update [--init] [--] [<path>…]
-<em>git submodule</em> [--quiet] summary [--summary-limit <n>] [commit] [--] [<path>…]</div></div>
+<em>git submodule</em> [--quiet] summary [--summary-limit <n>] [commit] [--] [<path>…]
+<em>git submodule</em> [--quiet] foreach <command></div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
@@ -451,6 +452,25 @@ summary index or working tree (switched by --cached) are shown.
</p>
</dd>
+<dt>
+foreach
+</dt>
+<dd>
+<p>
+ Evaluates an arbitrary shell command in each checked out submodule.
+ The command has access to the variables $path and $sha1:
+ $path is the name of the submodule directory relative to the
+ superproject, and $sha1 is the commit as recorded in the superproject.
+ Any submodules defined in the superproject but not checked out are
+ ignored by this command. Unless given --quiet, foreach prints the name
+ of each submodule before evaluating the command.
+ A non-zero return from the command in any submodule causes
+ the processing to terminate. This can be overridden by adding <em>|| :</em>
+ to the end of the command.
+</p>
+<div class="para"><p>As an example, "git submodule foreach <em>echo $path <tt>git rev-parse HEAD</tt></em> will
+show the path and currently checked out commit for each submodule.</p></div>
+</dd>
</dl></div>
</div>
<h2 id="_options">OPTIONS</h2>
@@ -533,7 +553,7 @@ for details.</p></div> </div>
<div id="footer">
<div id="footer-text">
-Last updated 2008-07-31 22:10:24 UTC
+Last updated 2008-08-21 10:34:01 UTC
</div>
</div>
</body>
|