diff options
author | Junio C Hamano <gitster@pobox.com> | 2014-04-02 15:40:34 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2014-04-02 15:40:34 -0700 |
commit | 90acbd7f147a3b8ad6f490b0f94d7932ddff0d8a (patch) | |
tree | 7c77652a37f36ae4365cf95dc47f65989fd6143a /git-submodule.html | |
parent | 52b6ba3e7e1bc9132a7f756c6a968b1214549fb8 (diff) | |
download | git-htmldocs-90acbd7f147a3b8ad6f490b0f94d7932ddff0d8a.tar.gz |
Autogenerated HTML docs for v1.9.1-445-g125d8e
Diffstat (limited to 'git-submodule.html')
-rw-r--r-- | git-submodule.html | 34 |
1 files changed, 9 insertions, 25 deletions
diff --git a/git-submodule.html b/git-submodule.html index 7db93a50f..5535054ab 100644 --- a/git-submodule.html +++ b/git-submodule.html @@ -756,7 +756,7 @@ git-submodule(1) Manual Page <em>git submodule</em> [--quiet] init [--] [<path>…]
<em>git submodule</em> [--quiet] deinit [-f|--force] [--] <path>…
<em>git submodule</em> [--quiet] update [--init] [--remote] [-N|--no-fetch]
- [-f|--force] [--checkout|--rebase|--merge] [--reference <repository>]
+ [-f|--force] [--rebase|--merge] [--reference <repository>]
[--depth <depth>] [--recursive] [--] [<path>…]
<em>git submodule</em> [--quiet] summary [--cached|--files] [(-n|--summary-limit) <n>]
[commit] [--] [<path>…]
@@ -915,30 +915,14 @@ update <dd>
<p>
Update the registered submodules, i.e. clone missing submodules and
- checkout the commit specified in the index of the containing
- repository. The update mode defaults to <tt>checkout</tt>, but can be
- configured with the <tt>submodule.<name>.update</tt> setting or the
- <tt>--rebase</tt>, <tt>--merge</tt>, or <tt>--checkout</tt> options.
+ checkout the commit specified in the index of the containing repository.
+ This will make the submodules HEAD be detached unless <tt>--rebase</tt> or
+ <tt>--merge</tt> is specified or the key <tt>submodule.$name.update</tt> is set to
+ <tt>rebase</tt>, <tt>merge</tt> or <tt>none</tt>. <tt>none</tt> can be overridden by specifying
+ <tt>--checkout</tt>. Setting the key <tt>submodule.$name.update</tt> to <tt>!command</tt>
+ will cause <tt>command</tt> to be run. <tt>command</tt> can be any arbitrary shell
+ command that takes a single argument, namely the sha1 to update to.
</p>
-<div class="paragraph"><p>For updates that clone missing submodules, checkout-mode updates will
-create submodules with detached HEADs; all other modes will create
-submodules with a local branch named after <tt>submodule.<name>.branch</tt>.</p></div>
-<div class="paragraph"><p>For updates that do not clone missing submodules, the submodule’s HEAD
-is only touched when the remote reference does not match the
-submodule’s HEAD (for none-mode updates, the submodule is never
-touched). The remote reference is usually the gitlinked commit from
-the superproject’s tree, but with <tt>--remote</tt> it is the upstream
-subproject’s <tt>submodule.<name>.branch</tt>. This remote reference is
-integrated with the submodule’s HEAD using the specified update mode.
-For checkout-mode updates, that will result in a detached HEAD. For
-rebase- and merge-mode updates, the commit referenced by the
-submodule’s HEAD may change, but the symbolic reference will remain
-unchanged (i.e. checked-out branches will still be checked-out
-branches, and detached HEADs will still be detached HEADs). If none
-of the builtin modes fit your needs, set <tt>submodule.<name>.update</tt> to
-<tt>!command</tt> to configure a custom integration command. <tt>command</tt> can
-be any arbitrary shell command that takes a single argument, namely
-the sha1 to update to.</p></div>
<div class="paragraph"><p>If the submodule is not yet initialized, and you just want to use the
setting as stored in .gitmodules, you can automatically initialize the
submodule with the <tt>--init</tt> option.</p></div>
@@ -1264,7 +1248,7 @@ for details.</p></div> <div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2014-03-31 17:26:22 PDT
+Last updated 2014-04-02 15:40:12 PDT
</div>
</div>
</body>
|