summaryrefslogtreecommitdiffstats
path: root/git-push.txt
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.txt
parent6a45be9321b1ee81baf74de51671f224407e5ad1 (diff)
downloadgit-htmldocs-a9aee78a156ad6299451294a61aebe2a73945d3c.tar.gz
Autogenerated HTML docs for v1.5.5.1-79-g57cf
Diffstat (limited to 'git-push.txt')
-rw-r--r--git-push.txt23
1 files changed, 13 insertions, 10 deletions
diff --git a/git-push.txt b/git-push.txt
index 3128170bc..058594913 100644
--- a/git-push.txt
+++ b/git-push.txt
@@ -35,14 +35,15 @@ OPTIONS
by the source ref, followed by a colon `:`, followed by
the destination ref.
+
-The <src> side can be an
-arbitrary "SHA1 expression" that can be used as an
-argument to `git-cat-file -t`. E.g. `master~4` (push
-four parents before the current master head).
+The <src> side represents the source branch (or arbitrary
+"SHA1 expression", such as `master~4` (four parents before the
+tip of `master` branch); see linkgit:git-rev-parse[1]) that you
+want to push. The <dst> side represents the destination location.
+
The local ref that matches <src> is used
-to fast forward the remote ref that matches <dst>. If
-the optional plus `+` is used, the remote ref is updated
+to fast forward the remote ref that matches <dst> (or, if no <dst> was
+specified, the same ref that <src> referred to locally). If
+the optional leading plus `+` is used, the remote ref is updated
even if it does not result in a fast forward update.
+
Note: If no explicit refspec is found, (that is neither
@@ -165,7 +166,8 @@ git push origin master::
Find a ref that matches `master` in the source repository
(most likely, it would find `refs/heads/master`), and update
the same ref (e.g. `refs/heads/master`) in `origin` repository
- with it.
+ with it. If `master` did not exist remotely, it would be
+ created.
git push origin :experimental::
Find a ref that matches `experimental` in the `origin` repository
@@ -179,9 +181,10 @@ git push origin master:satellite/master::
git push origin master:refs/heads/experimental::
Create the branch `experimental` in the `origin` repository
- by copying the current `master` branch. This form is usually
- needed to create a new branch in the remote repository as
- there is no `experimental` branch to match.
+ by copying the current `master` 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.
Author
------