summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorLibravatar Junio C Hamano <gitster@pobox.com>2016-08-10 12:33:18 -0700
committerLibravatar Junio C Hamano <gitster@pobox.com>2016-08-10 12:33:18 -0700
commite6747627865347a534e7106bb1d14e32867b234d (patch)
treee1d42d0b487628340329a4bf0e5333b477b149c3 /Documentation
parentMerge branch 'jk/reset-ident-time-per-commit' (diff)
parentt5533: make it pass on case-sensitive filesystems (diff)
downloadtgif-e6747627865347a534e7106bb1d14e32867b234d.tar.xz
Merge branch 'jk/push-force-with-lease-creation'
"git push --force-with-lease" already had enough logic to allow ensuring that such a push results in creation of a ref (i.e. the receiving end did not have another push from sideways that would be discarded by our force-pushing), but didn't expose this possibility to the users. It does so now. * jk/push-force-with-lease-creation: t5533: make it pass on case-sensitive filesystems push: allow pushing new branches with --force-with-lease push: add shorthand for --force-with-lease branch creation Documentation/git-push: fix placeholder formatting
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-push.txt5
1 files changed, 3 insertions, 2 deletions
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index ec514f6cd5..47b77e693b 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -204,10 +204,11 @@ branch we have for it.
+
`--force-with-lease=<refname>:<expect>` will protect the named ref (alone),
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
+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