diff options
| author | Junio C Hamano <junio@hera.kernel.org> | 2008-02-20 10:44:26 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@hera.kernel.org> | 2008-02-20 10:44:26 +0000 |
| commit | 6d559fc736bece9bac0d731b496639cbfe9ef757 (patch) | |
| tree | 8a7cc77ae892f0ec22f260edc8bd452f06390d48 /git-push.html | |
| parent | e670d0d6241cf484903e1d98bf786b58657c98e2 (diff) | |
| download | git-htmldocs-6d559fc736bece9bac0d731b496639cbfe9ef757.tar.gz | |
Autogenerated HTML docs for v1.5.4.2-156-ge3c5
Diffstat (limited to 'git-push.html')
| -rw-r--r-- | git-push.html | 83 |
1 files changed, 79 insertions, 4 deletions
diff --git a/git-push.html b/git-push.html index a2f60173b..6ada41e4a 100644 --- a/git-push.html +++ b/git-push.html @@ -316,9 +316,9 @@ the optional 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
-corresponding remotes file---see below), then all the
-heads that exist both on the local side and on the remote
-side are updated.</p>
+corresponding remotes file---see below), then "matching" heads are
+pushed: for every head that exists on the local side, the remote side is
+updated if a head of the same name already exists on the remote side.</p>
<p><tt>tag <tag></tt> means the same as <tt>refs/tags/<tag>:refs/tags/<tag></tt>.</p>
<p>A parameter <ref> without a colon pushes the <ref> from the source
repository to the destination repository under the same name.</p>
@@ -572,6 +572,81 @@ corresponding file in the <tt>$GIT_DIR/remotes/</tt> directory.</p> Pull: refs/heads/<head>:<remote></tt></pre>
</div></div>
</div>
+<h2>OUTPUT</h2>
+<div class="sectionbody">
+<p>The output of "git push" depends on the transport method used; this
+section describes the output when pushing over the git protocol (either
+locally or via ssh).</p>
+<p>The status of the push is output in tabular form, with each line
+representing the status of a single ref. Each line is of the form:</p>
+<div class="listingblock">
+<div class="content">
+<pre><tt> <flag> <summary> <from> -> <to> (<reason>)</tt></pre>
+</div></div>
+<dl>
+<dt>
+flag
+</dt>
+<dd>
+<p>
+ A single character indicating the status of the ref. This is
+ blank for a successfully pushed ref, <tt>!</tt> for a ref that was
+ rejected or failed to push, and <em>=</em> for a ref that was up to
+ date and did not need pushing (note that the status of up to
+ date refs is shown only when <tt>git push</tt> is running verbosely).
+</p>
+</dd>
+<dt>
+summary
+</dt>
+<dd>
+<p>
+ For a successfully pushed ref, the summary shows the old and new
+ values of the ref in a form suitable for using as an argument to
+ <tt>git log</tt> (this is <tt><old>..<new></tt> in most cases, and
+ <tt><old>…<new></tt> for forced non-fast forward updates). For a
+ failed update, more details are given for the failure.
+ The string <tt>rejected</tt> indicates that git did not try to send the
+ ref at all (typically because it is not a fast forward). The
+ string <tt>remote rejected</tt> indicates that the remote end refused
+ the update; this rejection is typically caused by a hook on the
+ remote side. The string <tt>remote failure</tt> indicates that the
+ remote end did not report the successful update of the ref
+ (perhaps because of a temporary error on the remote side, a
+ break in the network connection, or other transient error).
+</p>
+</dd>
+<dt>
+from
+</dt>
+<dd>
+<p>
+ The name of the local ref being pushed, minus its
+ <tt>refs/<type>/</tt> prefix. In the case of deletion, the
+ name of the local ref is omitted.
+</p>
+</dd>
+<dt>
+to
+</dt>
+<dd>
+<p>
+ The name of the remote ref being updated, minus its
+ <tt>refs/<type>/</tt> prefix.
+</p>
+</dd>
+<dt>
+reason
+</dt>
+<dd>
+<p>
+ A human-readable explanation. In the case of successfully pushed
+ refs, no explanation is needed. For a failed ref, the reason for
+ failure is described.
+</p>
+</dd>
+</dl>
+</div>
<h2>Examples</h2>
<div class="sectionbody">
<dl>
@@ -634,7 +709,7 @@ by Linus Torvalds <torvalds@osdl.org></p> </div>
<div id="footer">
<div id="footer-text">
-Last updated 07-Jan-2008 07:50:37 UTC
+Last updated 20-Feb-2008 10:44:09 UTC
</div>
</div>
</body>
|