man1/git-http-push.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "GIT-HTTP-PUSH" 1 "" "" ""
  21 .SH NAME
  22 git-http-push \- Push missing objects using HTTP/DAV
  23 .SH "SYNOPSIS"
  24
  25
  26 \fIgit\-http\-push\fR [\-\-complete] [\-\-force] [\-\-verbose] <url> <ref> [<ref>...]
  27
  28 .SH "DESCRIPTION"
  29
  30
  31 Sends missing objects to remote repository, and updates the remote branch\&.
  32
  33 .SH "OPTIONS"
  34
  35 .TP
  36 \-\-complete
  37 Do not assume that the remote repository is complete in its current state, and verify all objects in the entire local ref's history exist in the remote repository\&.
  38
  39 .TP
  40 \-\-force
  41 Usually, the command refuses to update a remote ref that is not an ancestor of the local ref used to overwrite it\&. This flag disables the check\&. What this means is that the remote repository can lose commits; use it with care\&.
  42
  43 .TP
  44 \-\-verbose
  45 Report the list of objects being walked locally and the list of objects successfully sent to the remote repository\&.
  46
  47
  48 <ref>...: The remote refs to update\&.
  49
  50 .SH "SPECIFYING THE REFS"
  51
  52
  53 A \fI<ref>\fR specification can be either a single pattern, or a pair of such patterns separated by a colon ":" (this means that a ref name cannot have a colon in it)\&. A single pattern \fI<name>\fR is just a shorthand for \fI<name>:<name>\fR\&.
  54
  55
  56 Each pattern pair consists of the source side (before the colon) and the destination side (after the colon)\&. The ref to be pushed is determined by finding a match that matches the source side, and where it is pushed is determined by using the destination side\&.
  57
  58 .TP 3
  59 \(bu
  60 It is an error if <src> does not match exactly one of the local refs\&.
  61 .TP
  62 \(bu
  63 If <dst> does not match any remote ref, either
  64
  65 .RS
  66 .TP 3
  67 \(bu
  68 it has to start with "refs/"; <dst> is used as the destination literally in this case\&.
  69 .TP
  70 \(bu
  71 <src> == <dst> and the ref that matched the <src> must not exist in the set of remote refs; the ref matched <src> locally is used as the name of the destination\&.
  72 .LP
  73 .RE
  74 .IP
  75 .LP
  76
  77
  78 Without \fI\-\-force\fR, the <src> ref is stored at the remote only if <dst> does not exist, or <dst> is a proper subset (i\&.e\&. an ancestor) of <src>\&. This check, known as "fast forward check", is performed in order to avoid accidentally overwriting the remote ref and lose other peoples' commits from there\&.
  79
  80
  81 With \fI\-\-force\fR, the fast forward check is disabled for all refs\&.
  82
  83
  84 Optionally, a <ref> parameter can be prefixed with a plus \fI+\fR sign to disable the fast\-forward check only on that ref\&.
  85
  86 .SH "AUTHOR"
  87
  88
  89 Written by Nick Hengeveld <nickh@reactrix\&.com>
  90
  91 .SH "DOCUMENTATION"
  92
  93
  94 Documentation by Nick Hengeveld
  95
  96 .SH "GIT"
  97
  98
  99 Part of the \fBgit\fR(7) suite
 100