blob: 820bacfc003629f061246ae05c1bdff26b08bef1 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:231<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano103b5722011-01-31 05:03:456<meta name="generator" content="AsciiDoc 8.4.5" />
7<title>git-http-push(1)</title>
Junio C Hamano1a4e8412005-12-27 08:17:238<style type="text/css">
9/* Debug borders */
10p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
11/*
12 border: 1px solid red;
13*/
14}
15
16body {
17 margin: 1em 5% 1em 5%;
18}
19
Junio C Hamano4604fe52008-09-19 06:37:1020a {
21 color: blue;
22 text-decoration: underline;
23}
24a:visited {
25 color: fuchsia;
26}
Junio C Hamano1a4e8412005-12-27 08:17:2327
28em {
29 font-style: italic;
Junio C Hamano103b5722011-01-31 05:03:4530 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:2331}
32
33strong {
34 font-weight: bold;
Junio C Hamano103b5722011-01-31 05:03:4535 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:2336}
37
38tt {
39 color: navy;
40}
41
42h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
48}
49
Junio C Hamano4604fe52008-09-19 06:37:1050h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:2351 border-bottom: 2px solid silver;
52}
53h2 {
Junio C Hamano1a4e8412005-12-27 08:17:2354 padding-top: 0.5em;
55}
Junio C Hamano4604fe52008-09-19 06:37:1056h3 {
57 float: left;
58}
59h3 + * {
60 clear: left;
61}
Junio C Hamano1a4e8412005-12-27 08:17:2362
63div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
66}
67
68hr {
69 border: 1px solid silver;
70}
71
72p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
75}
76
Junio C Hamano103b5722011-01-31 05:03:4577ul, ol, li > p {
78 margin-top: 0;
79}
80
Junio C Hamano1a4e8412005-12-27 08:17:2381pre {
82 padding: 0;
83 margin: 0;
84}
85
86span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
Junio C Hamano4604fe52008-09-19 06:37:1090 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:2391}
92span#email {
93}
Junio C Hamano103b5722011-01-31 05:03:4594span#revnumber, span#revdate, span#revremark {
Junio C Hamano1a4e8412005-12-27 08:17:2395 font-family: sans-serif;
96}
97
98div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
104}
105div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
108}
109div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
112}
113
Junio C Hamano103b5722011-01-31 05:03:45114div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
117}
Junio C Hamano1a4e8412005-12-27 08:17:23118div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120div.admonitionblock {
Junio C Hamano1a4e8412005-12-27 08:17:23121 margin-top: 1.5em;
122 margin-bottom: 1.5em;
123}
124div.admonitionblock {
125 margin-top: 2.5em;
126 margin-bottom: 2.5em;
127}
128
129div.content { /* Block element content. */
130 padding: 0;
131}
132
133/* Block element titles. */
134div.title, caption.title {
Junio C Hamano103b5722011-01-31 05:03:45135 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23136 font-family: sans-serif;
137 font-weight: bold;
138 text-align: left;
139 margin-top: 1.0em;
140 margin-bottom: 0.5em;
141}
142div.title + * {
143 margin-top: 0;
144}
145
146td div.title:first-child {
147 margin-top: 0.0em;
148}
149div.content div.title:first-child {
150 margin-top: 0.0em;
151}
152div.content + div.title {
153 margin-top: 0.0em;
154}
155
156div.sidebarblock > div.content {
157 background: #ffffee;
158 border: 1px solid silver;
159 padding: 0.5em;
160}
161
162div.listingblock > div.content {
163 border: 1px solid silver;
164 background: #f4f4f4;
165 padding: 0.5em;
166}
167
Junio C Hamano103b5722011-01-31 05:03:45168div.quoteblock {
Junio C Hamano1a4e8412005-12-27 08:17:23169 padding-left: 2.0em;
Junio C Hamano103b5722011-01-31 05:03:45170 margin-right: 10%;
Junio C Hamano1a4e8412005-12-27 08:17:23171}
Junio C Hamano103b5722011-01-31 05:03:45172div.quoteblock > div.attribution {
173 padding-top: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23174 text-align: right;
175}
Junio C Hamano103b5722011-01-31 05:03:45176
177div.verseblock {
178 padding-left: 2.0em;
179 margin-right: 10%;
180}
181div.verseblock > div.content {
182 white-space: pre;
183}
184div.verseblock > div.attribution {
185 padding-top: 0.75em;
186 text-align: left;
187}
188/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamano4604fe52008-09-19 06:37:10189div.verseblock + div.attribution {
190 text-align: left;
191}
Junio C Hamano1a4e8412005-12-27 08:17:23192
193div.admonitionblock .icon {
194 vertical-align: top;
195 font-size: 1.1em;
196 font-weight: bold;
197 text-decoration: underline;
198 color: #527bbd;
199 padding-right: 0.5em;
200}
201div.admonitionblock td.content {
202 padding-left: 0.5em;
203 border-left: 2px solid silver;
204}
205
206div.exampleblock > div.content {
207 border-left: 2px solid silver;
208 padding: 0.5em;
209}
210
Junio C Hamano1a4e8412005-12-27 08:17:23211div.imageblock div.content { padding-left: 0; }
Junio C Hamano1a4e8412005-12-27 08:17:23212span.image img { border-style: none; }
Junio C Hamano103b5722011-01-31 05:03:45213a.image:visited { color: white; }
Junio C Hamano1a4e8412005-12-27 08:17:23214
215dl {
216 margin-top: 0.8em;
217 margin-bottom: 0.8em;
218}
219dt {
220 margin-top: 0.5em;
221 margin-bottom: 0;
Junio C Hamano103b5722011-01-31 05:03:45222 font-style: normal;
223 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23224}
225dd > *:first-child {
Junio C Hamano103b5722011-01-31 05:03:45226 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23227}
228
229ul, ol {
230 list-style-position: outside;
231}
Junio C Hamano103b5722011-01-31 05:03:45232ol.arabic {
233 list-style-type: decimal;
234}
235ol.loweralpha {
Junio C Hamano1a4e8412005-12-27 08:17:23236 list-style-type: lower-alpha;
237}
Junio C Hamano103b5722011-01-31 05:03:45238ol.upperalpha {
239 list-style-type: upper-alpha;
240}
241ol.lowerroman {
242 list-style-type: lower-roman;
243}
244ol.upperroman {
245 list-style-type: upper-roman;
246}
247
248div.compact ul, div.compact ol,
249div.compact p, div.compact p,
250div.compact div, div.compact div {
251 margin-top: 0.1em;
252 margin-bottom: 0.1em;
253}
Junio C Hamano1a4e8412005-12-27 08:17:23254
255div.tableblock > table {
Junio C Hamano4604fe52008-09-19 06:37:10256 border: 3px solid #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23257}
258thead {
259 font-family: sans-serif;
260 font-weight: bold;
261}
262tfoot {
263 font-weight: bold;
264}
Junio C Hamano103b5722011-01-31 05:03:45265td > div.verse {
266 white-space: pre;
267}
268p.table {
269 margin-top: 0;
270}
271/* Because the table frame attribute is overriden by CSS in most browsers. */
272div.tableblock > table[frame="void"] {
273 border-style: none;
274}
275div.tableblock > table[frame="hsides"] {
276 border-left-style: none;
277 border-right-style: none;
278}
279div.tableblock > table[frame="vsides"] {
280 border-top-style: none;
281 border-bottom-style: none;
282}
Junio C Hamano1a4e8412005-12-27 08:17:23283
Junio C Hamano103b5722011-01-31 05:03:45284
285div.hdlist {
Junio C Hamano1a4e8412005-12-27 08:17:23286 margin-top: 0.8em;
287 margin-bottom: 0.8em;
288}
Junio C Hamano103b5722011-01-31 05:03:45289div.hdlist tr {
290 padding-bottom: 15px;
Junio C Hamano4604fe52008-09-19 06:37:10291}
Junio C Hamano103b5722011-01-31 05:03:45292dt.hdlist1.strong, td.hdlist1.strong {
293 font-weight: bold;
294}
295td.hdlist1 {
Junio C Hamano1a4e8412005-12-27 08:17:23296 vertical-align: top;
Junio C Hamano103b5722011-01-31 05:03:45297 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23298 padding-right: 0.8em;
Junio C Hamano103b5722011-01-31 05:03:45299 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23300}
Junio C Hamano103b5722011-01-31 05:03:45301td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23302 vertical-align: top;
303}
Junio C Hamano103b5722011-01-31 05:03:45304div.hdlist.compact tr {
305 margin: 0;
306 padding-bottom: 0;
307}
308
309.comment {
310 background: yellow;
311}
Junio C Hamano1a4e8412005-12-27 08:17:23312
313@media print {
314 div#footer-badges { display: none; }
315}
Junio C Hamano4604fe52008-09-19 06:37:10316
317div#toctitle {
318 color: #527bbd;
319 font-family: sans-serif;
320 font-size: 1.1em;
321 font-weight: bold;
322 margin-top: 1.0em;
323 margin-bottom: 0.1em;
324}
325
326div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
327 margin-top: 0;
328 margin-bottom: 0;
329}
330div.toclevel2 {
331 margin-left: 2em;
332 font-size: 0.9em;
333}
334div.toclevel3 {
335 margin-left: 4em;
336 font-size: 0.9em;
337}
338div.toclevel4 {
339 margin-left: 6em;
340 font-size: 0.9em;
341}
Junio C Hamano103b5722011-01-31 05:03:45342/* Overrides for manpage documents */
343h1 {
344 padding-top: 0.5em;
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver;
347 border-bottom: 2px solid silver;
348}
349h2 {
350 border-style: none;
351}
352div.sectionbody {
353 margin-left: 5%;
354}
355
356@media print {
357 div#toc { display: none; }
358}
359
Junio C Hamano1a4e8412005-12-27 08:17:23360/* Workarounds for IE6's broken and incomplete CSS2. */
361
362div.sidebar-content {
363 background: #ffffee;
364 border: 1px solid silver;
365 padding: 0.5em;
366}
367div.sidebar-title, div.image-title {
Junio C Hamano103b5722011-01-31 05:03:45368 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23369 font-family: sans-serif;
370 font-weight: bold;
371 margin-top: 0.0em;
372 margin-bottom: 0.5em;
373}
374
375div.listingblock div.content {
376 border: 1px solid silver;
377 background: #f4f4f4;
378 padding: 0.5em;
379}
380
Junio C Hamano103b5722011-01-31 05:03:45381div.quoteblock-attribution {
382 padding-top: 0.5em;
383 text-align: right;
384}
385
386div.verseblock-content {
387 white-space: pre;
388}
389div.verseblock-attribution {
390 padding-top: 0.75em;
391 text-align: left;
Junio C Hamano1a4e8412005-12-27 08:17:23392}
393
394div.exampleblock-content {
395 border-left: 2px solid silver;
396 padding-left: 0.5em;
397}
Junio C Hamano4604fe52008-09-19 06:37:10398
399/* IE6 sets dynamically generated links as visited. */
400div#toc a:visited { color: blue; }
Junio C Hamano1a4e8412005-12-27 08:17:23401</style>
Junio C Hamano1a4e8412005-12-27 08:17:23402</head>
403<body>
404<div id="header">
405<h1>
406git-http-push(1) Manual Page
407</h1>
408<h2>NAME</h2>
409<div class="sectionbody">
410<p>git-http-push -
Junio C Hamano7c73c662007-01-19 00:37:50411 Push objects over HTTP/DAV to another repository
Junio C Hamano1a4e8412005-12-27 08:17:23412</p>
413</div>
414</div>
Junio C Hamano103b5722011-01-31 05:03:45415<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23416<div class="sectionbody">
Junio C Hamano15567bc2011-07-23 00:51:59417<div class="verseblock">
418<div class="verseblock-content"><em>git http-push</em> [--all] [--dry-run] [--force] [--verbose] &lt;url&gt; &lt;ref&gt; [&lt;ref&gt;&#8230;]</div>
419<div class="verseblock-attribution">
420</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23421</div>
Junio C Hamano4604fe52008-09-19 06:37:10422<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23423<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45424<div class="paragraph"><p>Sends missing objects to remote repository, and updates the
Junio C Hamano4604fe52008-09-19 06:37:10425remote branch.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45426<div class="paragraph"><p><strong>NOTE</strong>: This command is temporarily disabled if your libcurl
Junio C Hamanod47c7c22008-06-16 01:52:47427is older than 7.16, as the combination has been reported
Junio C Hamano4604fe52008-09-19 06:37:10428not to work and sometimes corrupts repository.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23429</div>
Junio C Hamano4604fe52008-09-19 06:37:10430<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23431<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45432<div class="dlist"><dl>
433<dt class="hdlist1">
Junio C Hamano9882a522007-04-27 08:22:22434--all
Junio C Hamano1a4e8412005-12-27 08:17:23435</dt>
436<dd>
437<p>
438 Do not assume that the remote repository is complete in its
439 current state, and verify all objects in the entire local
Junio C Hamano103b5722011-01-31 05:03:45440 ref&#8217;s history exist in the remote repository.
Junio C Hamano1a4e8412005-12-27 08:17:23441</p>
442</dd>
Junio C Hamano103b5722011-01-31 05:03:45443<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23444--force
445</dt>
446<dd>
447<p>
448 Usually, the command refuses to update a remote ref that
449 is not an ancestor of the local ref used to overwrite it.
450 This flag disables the check. What this means is that
451 the remote repository can lose commits; use it with
452 care.
453</p>
454</dd>
Junio C Hamano103b5722011-01-31 05:03:45455<dt class="hdlist1">
Junio C Hamanoc2b47092007-10-25 06:50:31456--dry-run
457</dt>
458<dd>
459<p>
460 Do everything except actually send the updates.
461</p>
462</dd>
Junio C Hamano103b5722011-01-31 05:03:45463<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23464--verbose
465</dt>
466<dd>
467<p>
468 Report the list of objects being walked locally and the
469 list of objects successfully sent to the remote repository.
470</p>
471</dd>
Junio C Hamano103b5722011-01-31 05:03:45472<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47473-d
474</dt>
Junio C Hamano103b5722011-01-31 05:03:45475<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47476-D
Junio C Hamano9882a522007-04-27 08:22:22477</dt>
478<dd>
479<p>
480 Remove &lt;ref&gt; from remote repository. The specified branch
481 cannot be the remote HEAD. If -d is specified the following
482 other conditions must also be met:
483</p>
Junio C Hamano103b5722011-01-31 05:03:45484<div class="ulist"><ul>
Junio C Hamano9882a522007-04-27 08:22:22485<li>
486<p>
487Remote HEAD must resolve to an object that exists locally
488</p>
489</li>
490<li>
491<p>
492Specified branch resolves to an object that exists locally
493</p>
494</li>
495<li>
496<p>
497Specified branch is an ancestor of the remote HEAD
498</p>
499</li>
Junio C Hamano4604fe52008-09-19 06:37:10500</ul></div>
Junio C Hamano9882a522007-04-27 08:22:22501</dd>
Junio C Hamano103b5722011-01-31 05:03:45502<dt class="hdlist1">
Junio C Hamano21c0b422006-10-12 19:10:36503&lt;ref&gt;&#8230;
504</dt>
505<dd>
506<p>
507 The remote refs to update.
508</p>
509</dd>
Junio C Hamano4604fe52008-09-19 06:37:10510</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23511</div>
Junio C Hamano4604fe52008-09-19 06:37:10512<h2 id="_specifying_the_refs">Specifying the Refs</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23513<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45514<div class="paragraph"><p>A <em>&lt;ref&gt;</em> specification can be either a single pattern, or a pair
Junio C Hamano1a4e8412005-12-27 08:17:23515of such patterns separated by a colon ":" (this means that a ref name
516cannot have a colon in it). A single pattern <em>&lt;name&gt;</em> is just a
Junio C Hamano4604fe52008-09-19 06:37:10517shorthand for <em>&lt;name&gt;:&lt;name&gt;</em>.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45518<div class="paragraph"><p>Each pattern pair consists of the source side (before the colon)
Junio C Hamano1a4e8412005-12-27 08:17:23519and the destination side (after the colon). The ref to be
520pushed is determined by finding a match that matches the source
521side, and where it is pushed is determined by using the
Junio C Hamano4604fe52008-09-19 06:37:10522destination side.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45523<div class="ulist"><ul>
Junio C Hamano1a4e8412005-12-27 08:17:23524<li>
525<p>
526It is an error if &lt;src&gt; does not match exactly one of the
527 local refs.
528</p>
529</li>
530<li>
531<p>
532If &lt;dst&gt; does not match any remote ref, either
533</p>
Junio C Hamano103b5722011-01-31 05:03:45534<div class="ulist"><ul>
Junio C Hamano1a4e8412005-12-27 08:17:23535<li>
536<p>
537it has to start with "refs/"; &lt;dst&gt; is used as the
538 destination literally in this case.
539</p>
540</li>
541<li>
542<p>
543&lt;src&gt; == &lt;dst&gt; and the ref that matched the &lt;src&gt; must not
544 exist in the set of remote refs; the ref matched &lt;src&gt;
545 locally is used as the name of the destination.
546</p>
547</li>
Junio C Hamano4604fe52008-09-19 06:37:10548</ul></div>
Junio C Hamano1a4e8412005-12-27 08:17:23549</li>
Junio C Hamano4604fe52008-09-19 06:37:10550</ul></div>
Junio C Hamano103b5722011-01-31 05:03:45551<div class="paragraph"><p>Without <em>--force</em>, the &lt;src&gt; ref is stored at the remote only if
Junio C Hamano1a4e8412005-12-27 08:17:23552&lt;dst&gt; does not exist, or &lt;dst&gt; is a proper subset (i.e. an
Junio C Hamano3f680f32009-11-16 02:10:54553ancestor) of &lt;src&gt;. This check, known as "fast-forward check",
Junio C Hamano1a4e8412005-12-27 08:17:23554is performed in order to avoid accidentally overwriting the
Junio C Hamano4604fe52008-09-19 06:37:10555remote ref and lose other peoples' commits from there.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45556<div class="paragraph"><p>With <em>--force</em>, the fast-forward check is disabled for all refs.</p></div>
557<div class="paragraph"><p>Optionally, a &lt;ref&gt; parameter can be prefixed with a plus <em>+</em> sign
Junio C Hamano4604fe52008-09-19 06:37:10558to disable the fast-forward check only on that ref.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23559</div>
Junio C Hamano4604fe52008-09-19 06:37:10560<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23561<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45562<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23563</div>
564<div id="footer">
565<div id="footer-text">
Junio C Hamano15567bc2011-07-23 00:51:59566Last updated 2011-07-23 00:49:30 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23567</div>
568</div>
569</body>
570</html>