summaryrefslogtreecommitdiff
path: root/Documentation/git-push.txt
diff options
context:
space:
mode:
authorJohn Keeping <john@keeping.me.uk>2016-07-26 20:44:44 (GMT)
committerJunio C Hamano <gitster@pobox.com>2016-07-26 20:48:09 (GMT)
commiteee98e74f928a49c310038c77026ebc04e6cf4b2 (patch)
treeefb8d9d0f487770a486f9a2ff9cb82fd60772e77 /Documentation/git-push.txt
parentd132b32b4e3146e4aa5a719418f85d6db1134140 (diff)
downloadgit-eee98e74f928a49c310038c77026ebc04e6cf4b2.zip
git-eee98e74f928a49c310038c77026ebc04e6cf4b2.tar.gz
git-eee98e74f928a49c310038c77026ebc04e6cf4b2.tar.bz2
push: add shorthand for --force-with-lease branch creation
Allow the empty string to stand in for the null SHA-1 when pushing a new branch, like we do when deleting branches. This means that the following command ensures that `new-branch` is created on the remote (that is, is must not already exist): git push --force-with-lease=new-branch: origin new-branch Signed-off-by: John Keeping <john@keeping.me.uk> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-push.txt')
-rw-r--r--Documentation/git-push.txt3
1 files changed, 2 insertions, 1 deletions
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index 5355a8d..02b5dd3 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -201,7 +201,8 @@ if it is going to be updated, by requiring its current value to be
the same as the specified value `<expect>` (which is allowed to be
different from the remote-tracking branch we have for the refname,
or we do not even have to have such a remote-tracking branch when
-this form is used).
+this form is used). If `<expect>` is the empty string, then the named ref
+must not already exist.
+
Note that all forms other than `--force-with-lease=<refname>:<expect>`
that specifies the expected current value of the ref explicitly are