summaryrefslogtreecommitdiffstats
path: root/git-push.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2008-04-23 16:09:20 +0000
committerJunio C Hamano <junio@hera.kernel.org>2008-04-23 16:09:20 +0000
commita9aee78a156ad6299451294a61aebe2a73945d3c (patch)
tree67691d6e64c1ddd0806872a934a327873e57f53f /git-push.html
parent6a45be9321b1ee81baf74de51671f224407e5ad1 (diff)
downloadgit-htmldocs-a9aee78a156ad6299451294a61aebe2a73945d3c.tar.gz
Autogenerated HTML docs for v1.5.5.1-79-g57cf
Diffstat (limited to 'git-push.html')
-rw-r--r--git-push.html25
1 files changed, 14 insertions, 11 deletions
diff --git a/git-push.html b/git-push.html
index 0f3679b3f..67862c716 100644
--- a/git-push.html
+++ b/git-push.html
@@ -306,13 +306,14 @@ documentation for <a href="git-receive-pack.html">git-receive-pack(1)</a>.</p>
by the source ref, followed by a colon <tt>:</tt>, followed by
the destination ref.
</p>
-<p>The &lt;src&gt; side can be an
-arbitrary "SHA1 expression" that can be used as an
-argument to <tt>git-cat-file -t</tt>. E.g. <tt>master~4</tt> (push
-four parents before the current master head).</p>
+<p>The &lt;src&gt; side represents the source branch (or arbitrary
+"SHA1 expression", such as <tt>master~4</tt> (four parents before the
+tip of <tt>master</tt> branch); see <a href="git-rev-parse.html">git-rev-parse(1)</a>) that you
+want to push. The &lt;dst&gt; side represents the destination location.</p>
<p>The local ref that matches &lt;src&gt; is used
-to fast forward the remote ref that matches &lt;dst&gt;. If
-the optional plus <tt>+</tt> is used, the remote ref is updated
+to fast forward the remote ref that matches &lt;dst&gt; (or, if no &lt;dst&gt; was
+specified, the same ref that &lt;src&gt; referred to locally). If
+the optional leading plus <tt>+</tt> is used, the remote ref is updated
even if it does not result in a fast forward update.</p>
<p>Note: If no explicit refspec is found, (that is neither
on the command line nor in any Push line of the
@@ -676,7 +677,8 @@ git push origin master
Find a ref that matches <tt>master</tt> in the source repository
(most likely, it would find <tt>refs/heads/master</tt>), and update
the same ref (e.g. <tt>refs/heads/master</tt>) in <tt>origin</tt> repository
- with it.
+ with it. If <tt>master</tt> did not exist remotely, it would be
+ created.
</p>
</dd>
<dt>
@@ -705,9 +707,10 @@ git push origin master:refs/heads/experimental
<dd>
<p>
Create the branch <tt>experimental</tt> in the <tt>origin</tt> repository
- by copying the current <tt>master</tt> branch. This form is usually
- needed to create a new branch in the remote repository as
- there is no <tt>experimental</tt> branch to match.
+ by copying the current <tt>master</tt> branch. This form is only
+ needed to create a new branch or tag in the remote repository when
+ the local name and the remote name are different; otherwise,
+ the ref name on its own will work.
</p>
</dd>
</dl>
@@ -727,7 +730,7 @@ by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 28-Feb-2008 00:25:43 UTC
+Last updated 23-Apr-2008 16:08:37 UTC
</div>
</div>
</body>