diff options
author | Junio C Hamano <gitster@pobox.com> | 2015-06-05 13:28:29 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2015-06-05 13:28:29 -0700 |
commit | 975f4dba2f3b9bdb50b16dbad38ac610850e9fc2 (patch) | |
tree | 7348cc49a6bd12e9fc61d76ed4f219ebfed85fe2 /gitrevisions.html | |
parent | 85f1fdef295d40098c723afbbbc650101868d697 (diff) | |
download | git-htmldocs-975f4dba2f3b9bdb50b16dbad38ac610850e9fc2.tar.gz |
Autogenerated HTML docs for v2.4.3-368-g797488
Diffstat (limited to 'gitrevisions.html')
-rw-r--r-- | gitrevisions.html | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/gitrevisions.html b/gitrevisions.html index aa365f0ea..b03b954d0 100644 --- a/gitrevisions.html +++ b/gitrevisions.html @@ -927,6 +927,34 @@ some output processing may assume ref names in UTF-8.</p></div> </p>
</dd>
<dt class="hdlist1">
+<em><branchname>@{push}</em>, e.g. <em>master@{push}</em>, <em>@{push}</em>
+</dt>
+<dd>
+<p>
+ The suffix <em>@{push}</em> reports the branch "where we would push to" if
+ <code>git push</code> were run while <code>branchname</code> was checked out (or the current
+ <em>HEAD</em> if no branchname is specified). Since our push destination is
+ in a remote repository, of course, we report the local tracking branch
+ that corresponds to that branch (i.e., something in <em>refs/remotes/</em>).
+</p>
+<div class="paragraph"><p>Here’s an example to make it more clear:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>$ git config push.default current
+$ git config remote.pushdefault myfork
+$ git checkout -b mybranch origin/master
+
+$ git rev-parse --symbolic-full-name @{upstream}
+refs/remotes/origin/master
+
+$ git rev-parse --symbolic-full-name @{push}
+refs/remotes/myfork/mybranch</code></pre>
+</div></div>
+<div class="paragraph"><p>Note in the example that we set up a triangular workflow, where we pull
+from one location and push to another. In a non-triangular workflow,
+<em>@{push}</em> is the same as <em>@{upstream}</em>, and there is no need for it.</p></div>
+</dd>
+<dt class="hdlist1">
<em><rev>^</em>, e.g. <em>HEAD^, v1.5.1^0</em>
</dt>
<dd>
|