blob: 83c6dac83489a6d4a96fe7069dc14068849f06cc [file] [log] [blame]
Junio C Hamano6ac2f142007-03-01 01:24:561<!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>
Junio C Hamano9d971152012-12-19 00:43:115<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
Junio C Hamanoc14e6ad2014-10-31 20:25:536<meta name="generator" content="AsciiDoc 8.6.9" />
Junio C Hamano68cf15a2010-11-06 01:01:597<title>git-bundle(1)</title>
Junio C Hamano6ac2f142007-03-01 01:24:568<style type="text/css">
Junio C Hamano9d971152012-12-19 00:43:119/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
10
11/* Default font. */
12body {
13 font-family: Georgia,serif;
14}
15
16/* Title font. */
17h1, h2, h3, h4, h5, h6,
18div.title, caption.title,
19thead, p.table.header,
20#toctitle,
21#author, #revnumber, #revdate, #revremark,
22#footer {
23 font-family: Arial,Helvetica,sans-serif;
Junio C Hamano6ac2f142007-03-01 01:24:5624}
25
26body {
27 margin: 1em 5% 1em 5%;
28}
29
Junio C Hamanoba4b9282008-07-06 05:20:3130a {
31 color: blue;
32 text-decoration: underline;
33}
34a:visited {
35 color: fuchsia;
36}
Junio C Hamano6ac2f142007-03-01 01:24:5637
38em {
39 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:5940 color: navy;
Junio C Hamano6ac2f142007-03-01 01:24:5641}
42
43strong {
44 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:5945 color: #083194;
Junio C Hamano6ac2f142007-03-01 01:24:5646}
47
Junio C Hamano6ac2f142007-03-01 01:24:5648h1, h2, h3, h4, h5, h6 {
49 color: #527bbd;
Junio C Hamano6ac2f142007-03-01 01:24:5650 margin-top: 1.2em;
51 margin-bottom: 0.5em;
52 line-height: 1.3;
53}
54
Junio C Hamanoba4b9282008-07-06 05:20:3155h1, h2, h3 {
Junio C Hamano6ac2f142007-03-01 01:24:5656 border-bottom: 2px solid silver;
57}
58h2 {
Junio C Hamano6ac2f142007-03-01 01:24:5659 padding-top: 0.5em;
60}
Junio C Hamanoba4b9282008-07-06 05:20:3161h3 {
62 float: left;
63}
64h3 + * {
65 clear: left;
66}
Junio C Hamano9d971152012-12-19 00:43:1167h5 {
68 font-size: 1.0em;
69}
Junio C Hamano6ac2f142007-03-01 01:24:5670
71div.sectionbody {
Junio C Hamano6ac2f142007-03-01 01:24:5672 margin-left: 0;
73}
74
75hr {
76 border: 1px solid silver;
77}
78
79p {
80 margin-top: 0.5em;
81 margin-bottom: 0.5em;
82}
83
Junio C Hamano68cf15a2010-11-06 01:01:5984ul, ol, li > p {
85 margin-top: 0;
86}
Junio C Hamano9d971152012-12-19 00:43:1187ul > li { color: #aaa; }
88ul > li > * { color: black; }
Junio C Hamano68cf15a2010-11-06 01:01:5989
Junio C Hamanoc14e6ad2014-10-31 20:25:5390.monospaced, code, pre {
91 font-family: "Courier New", Courier, monospace;
92 font-size: inherit;
93 color: navy;
Junio C Hamano6ac2f142007-03-01 01:24:5694 padding: 0;
95 margin: 0;
96}
Junio C Hamanoc14e6ad2014-10-31 20:25:5397pre {
98 white-space: pre-wrap;
99}
Junio C Hamano6ac2f142007-03-01 01:24:56100
Junio C Hamano9d971152012-12-19 00:43:11101#author {
Junio C Hamano6ac2f142007-03-01 01:24:56102 color: #527bbd;
Junio C Hamano6ac2f142007-03-01 01:24:56103 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31104 font-size: 1.1em;
Junio C Hamano6ac2f142007-03-01 01:24:56105}
Junio C Hamano9d971152012-12-19 00:43:11106#email {
Junio C Hamano6ac2f142007-03-01 01:24:56107}
Junio C Hamano9d971152012-12-19 00:43:11108#revnumber, #revdate, #revremark {
Junio C Hamano6ac2f142007-03-01 01:24:56109}
110
Junio C Hamano9d971152012-12-19 00:43:11111#footer {
Junio C Hamano6ac2f142007-03-01 01:24:56112 font-size: small;
113 border-top: 2px solid silver;
114 padding-top: 0.5em;
115 margin-top: 4.0em;
116}
Junio C Hamano9d971152012-12-19 00:43:11117#footer-text {
Junio C Hamano6ac2f142007-03-01 01:24:56118 float: left;
119 padding-bottom: 0.5em;
120}
Junio C Hamano9d971152012-12-19 00:43:11121#footer-badges {
Junio C Hamano6ac2f142007-03-01 01:24:56122 float: right;
123 padding-bottom: 0.5em;
124}
125
Junio C Hamano9d971152012-12-19 00:43:11126#preamble {
Junio C Hamano68cf15a2010-11-06 01:01:59127 margin-top: 1.5em;
128 margin-bottom: 1.5em;
129}
Junio C Hamano9d971152012-12-19 00:43:11130div.imageblock, div.exampleblock, div.verseblock,
Junio C Hamano6ac2f142007-03-01 01:24:56131div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
132div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22133 margin-top: 1.0em;
Junio C Hamano6ac2f142007-03-01 01:24:56134 margin-bottom: 1.5em;
135}
136div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22137 margin-top: 2.0em;
138 margin-bottom: 2.0em;
139 margin-right: 10%;
140 color: #606060;
Junio C Hamano6ac2f142007-03-01 01:24:56141}
142
143div.content { /* Block element content. */
144 padding: 0;
145}
146
147/* Block element titles. */
148div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59149 color: #527bbd;
Junio C Hamano6ac2f142007-03-01 01:24:56150 font-weight: bold;
151 text-align: left;
152 margin-top: 1.0em;
153 margin-bottom: 0.5em;
154}
155div.title + * {
156 margin-top: 0;
157}
158
159td div.title:first-child {
160 margin-top: 0.0em;
161}
162div.content div.title:first-child {
163 margin-top: 0.0em;
164}
165div.content + div.title {
166 margin-top: 0.0em;
167}
168
169div.sidebarblock > div.content {
170 background: #ffffee;
Junio C Hamano9d971152012-12-19 00:43:11171 border: 1px solid #dddddd;
172 border-left: 4px solid #f0f0f0;
Junio C Hamano6ac2f142007-03-01 01:24:56173 padding: 0.5em;
174}
175
176div.listingblock > div.content {
Junio C Hamano9d971152012-12-19 00:43:11177 border: 1px solid #dddddd;
178 border-left: 5px solid #f0f0f0;
179 background: #f8f8f8;
Junio C Hamano6ac2f142007-03-01 01:24:56180 padding: 0.5em;
181}
182
Junio C Hamano7bd050f2011-09-22 06:32:22183div.quoteblock, div.verseblock {
184 padding-left: 1.0em;
185 margin-left: 1.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59186 margin-right: 10%;
Junio C Hamano9d971152012-12-19 00:43:11187 border-left: 5px solid #f0f0f0;
188 color: #888;
Junio C Hamano6ac2f142007-03-01 01:24:56189}
Junio C Hamano7bd050f2011-09-22 06:32:22190
Junio C Hamano68cf15a2010-11-06 01:01:59191div.quoteblock > div.attribution {
192 padding-top: 0.5em;
Junio C Hamano6ac2f142007-03-01 01:24:56193 text-align: right;
194}
Junio C Hamano68cf15a2010-11-06 01:01:59195
Junio C Hamano9d971152012-12-19 00:43:11196div.verseblock > pre.content {
197 font-family: inherit;
198 font-size: inherit;
Junio C Hamano68cf15a2010-11-06 01:01:59199}
200div.verseblock > div.attribution {
201 padding-top: 0.75em;
202 text-align: left;
203}
204/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31205div.verseblock + div.attribution {
206 text-align: left;
207}
Junio C Hamano6ac2f142007-03-01 01:24:56208
209div.admonitionblock .icon {
210 vertical-align: top;
211 font-size: 1.1em;
212 font-weight: bold;
213 text-decoration: underline;
214 color: #527bbd;
215 padding-right: 0.5em;
216}
217div.admonitionblock td.content {
218 padding-left: 0.5em;
Junio C Hamano7bd050f2011-09-22 06:32:22219 border-left: 3px solid #dddddd;
Junio C Hamano6ac2f142007-03-01 01:24:56220}
221
222div.exampleblock > div.content {
Junio C Hamano7bd050f2011-09-22 06:32:22223 border-left: 3px solid #dddddd;
224 padding-left: 0.5em;
Junio C Hamano6ac2f142007-03-01 01:24:56225}
226
Junio C Hamano6ac2f142007-03-01 01:24:56227div.imageblock div.content { padding-left: 0; }
Junio C Hamanoc14e6ad2014-10-31 20:25:53228span.image img { border-style: none; vertical-align: text-bottom; }
Junio C Hamano68cf15a2010-11-06 01:01:59229a.image:visited { color: white; }
Junio C Hamano6ac2f142007-03-01 01:24:56230
231dl {
232 margin-top: 0.8em;
233 margin-bottom: 0.8em;
234}
235dt {
236 margin-top: 0.5em;
237 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59238 font-style: normal;
239 color: navy;
Junio C Hamano6ac2f142007-03-01 01:24:56240}
241dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59242 margin-top: 0.1em;
Junio C Hamano6ac2f142007-03-01 01:24:56243}
244
245ul, ol {
246 list-style-position: outside;
247}
Junio C Hamano68cf15a2010-11-06 01:01:59248ol.arabic {
249 list-style-type: decimal;
250}
251ol.loweralpha {
Junio C Hamano6ac2f142007-03-01 01:24:56252 list-style-type: lower-alpha;
253}
Junio C Hamano68cf15a2010-11-06 01:01:59254ol.upperalpha {
255 list-style-type: upper-alpha;
256}
257ol.lowerroman {
258 list-style-type: lower-roman;
259}
260ol.upperroman {
261 list-style-type: upper-roman;
262}
263
264div.compact ul, div.compact ol,
265div.compact p, div.compact p,
266div.compact div, div.compact div {
267 margin-top: 0.1em;
268 margin-bottom: 0.1em;
269}
Junio C Hamano6ac2f142007-03-01 01:24:56270
Junio C Hamano6ac2f142007-03-01 01:24:56271tfoot {
272 font-weight: bold;
273}
Junio C Hamano68cf15a2010-11-06 01:01:59274td > div.verse {
275 white-space: pre;
276}
Junio C Hamano68cf15a2010-11-06 01:01:59277
278div.hdlist {
Junio C Hamano6ac2f142007-03-01 01:24:56279 margin-top: 0.8em;
280 margin-bottom: 0.8em;
281}
Junio C Hamano68cf15a2010-11-06 01:01:59282div.hdlist tr {
283 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31284}
Junio C Hamano68cf15a2010-11-06 01:01:59285dt.hdlist1.strong, td.hdlist1.strong {
286 font-weight: bold;
287}
288td.hdlist1 {
Junio C Hamano6ac2f142007-03-01 01:24:56289 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59290 font-style: normal;
Junio C Hamano6ac2f142007-03-01 01:24:56291 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59292 color: navy;
Junio C Hamano6ac2f142007-03-01 01:24:56293}
Junio C Hamano68cf15a2010-11-06 01:01:59294td.hdlist2 {
Junio C Hamano6ac2f142007-03-01 01:24:56295 vertical-align: top;
296}
Junio C Hamano68cf15a2010-11-06 01:01:59297div.hdlist.compact tr {
298 margin: 0;
299 padding-bottom: 0;
300}
301
302.comment {
303 background: yellow;
304}
Junio C Hamano6ac2f142007-03-01 01:24:56305
Junio C Hamano7bd050f2011-09-22 06:32:22306.footnote, .footnoteref {
307 font-size: 0.8em;
308}
309
310span.footnote, span.footnoteref {
311 vertical-align: super;
312}
313
314#footnotes {
315 margin: 20px 0 20px 0;
316 padding: 7px 0 0 0;
317}
318
319#footnotes div.footnote {
320 margin: 0 0 5px 0;
321}
322
323#footnotes hr {
324 border: none;
325 border-top: 1px solid silver;
326 height: 1px;
327 text-align: left;
328 margin-left: 0;
329 width: 20%;
330 min-width: 100px;
331}
332
Junio C Hamano9d971152012-12-19 00:43:11333div.colist td {
334 padding-right: 0.5em;
335 padding-bottom: 0.3em;
336 vertical-align: top;
337}
338div.colist td img {
339 margin-top: 0.3em;
Junio C Hamano6ac2f142007-03-01 01:24:56340}
Junio C Hamanoba4b9282008-07-06 05:20:31341
Junio C Hamano9d971152012-12-19 00:43:11342@media print {
343 #footer-badges { display: none; }
344}
345
346#toc {
Junio C Hamano7bd050f2011-09-22 06:32:22347 margin-bottom: 2.5em;
348}
349
Junio C Hamano9d971152012-12-19 00:43:11350#toctitle {
Junio C Hamanoba4b9282008-07-06 05:20:31351 color: #527bbd;
Junio C Hamanoba4b9282008-07-06 05:20:31352 font-size: 1.1em;
353 font-weight: bold;
354 margin-top: 1.0em;
355 margin-bottom: 0.1em;
356}
357
Junio C Hamanoc14e6ad2014-10-31 20:25:53358div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
Junio C Hamanoba4b9282008-07-06 05:20:31359 margin-top: 0;
360 margin-bottom: 0;
361}
362div.toclevel2 {
363 margin-left: 2em;
364 font-size: 0.9em;
365}
366div.toclevel3 {
367 margin-left: 4em;
368 font-size: 0.9em;
369}
370div.toclevel4 {
371 margin-left: 6em;
372 font-size: 0.9em;
373}
Junio C Hamano9d971152012-12-19 00:43:11374
375span.aqua { color: aqua; }
376span.black { color: black; }
377span.blue { color: blue; }
378span.fuchsia { color: fuchsia; }
379span.gray { color: gray; }
380span.green { color: green; }
381span.lime { color: lime; }
382span.maroon { color: maroon; }
383span.navy { color: navy; }
384span.olive { color: olive; }
385span.purple { color: purple; }
386span.red { color: red; }
387span.silver { color: silver; }
388span.teal { color: teal; }
389span.white { color: white; }
390span.yellow { color: yellow; }
391
392span.aqua-background { background: aqua; }
393span.black-background { background: black; }
394span.blue-background { background: blue; }
395span.fuchsia-background { background: fuchsia; }
396span.gray-background { background: gray; }
397span.green-background { background: green; }
398span.lime-background { background: lime; }
399span.maroon-background { background: maroon; }
400span.navy-background { background: navy; }
401span.olive-background { background: olive; }
402span.purple-background { background: purple; }
403span.red-background { background: red; }
404span.silver-background { background: silver; }
405span.teal-background { background: teal; }
406span.white-background { background: white; }
407span.yellow-background { background: yellow; }
408
409span.big { font-size: 2em; }
410span.small { font-size: 0.6em; }
411
412span.underline { text-decoration: underline; }
413span.overline { text-decoration: overline; }
414span.line-through { text-decoration: line-through; }
415
Junio C Hamanoc14e6ad2014-10-31 20:25:53416div.unbreakable { page-break-inside: avoid; }
417
Junio C Hamano9d971152012-12-19 00:43:11418
419/*
420 * xhtml11 specific
421 *
422 * */
423
424div.tableblock {
425 margin-top: 1.0em;
426 margin-bottom: 1.5em;
427}
428div.tableblock > table {
429 border: 3px solid #527bbd;
430}
431thead, p.table.header {
432 font-weight: bold;
433 color: #527bbd;
434}
435p.table {
436 margin-top: 0;
437}
438/* Because the table frame attribute is overriden by CSS in most browsers. */
439div.tableblock > table[frame="void"] {
440 border-style: none;
441}
442div.tableblock > table[frame="hsides"] {
443 border-left-style: none;
444 border-right-style: none;
445}
446div.tableblock > table[frame="vsides"] {
447 border-top-style: none;
448 border-bottom-style: none;
449}
450
451
452/*
453 * html5 specific
454 *
455 * */
456
457table.tableblock {
458 margin-top: 1.0em;
459 margin-bottom: 1.5em;
460}
461thead, p.tableblock.header {
462 font-weight: bold;
463 color: #527bbd;
464}
465p.tableblock {
466 margin-top: 0;
467}
468table.tableblock {
469 border-width: 3px;
470 border-spacing: 0px;
471 border-style: solid;
472 border-color: #527bbd;
473 border-collapse: collapse;
474}
475th.tableblock, td.tableblock {
476 border-width: 1px;
477 padding: 4px;
478 border-style: solid;
479 border-color: #527bbd;
480}
481
482table.tableblock.frame-topbot {
483 border-left-style: hidden;
484 border-right-style: hidden;
485}
486table.tableblock.frame-sides {
487 border-top-style: hidden;
488 border-bottom-style: hidden;
489}
490table.tableblock.frame-none {
491 border-style: hidden;
492}
493
494th.tableblock.halign-left, td.tableblock.halign-left {
495 text-align: left;
496}
497th.tableblock.halign-center, td.tableblock.halign-center {
498 text-align: center;
499}
500th.tableblock.halign-right, td.tableblock.halign-right {
501 text-align: right;
502}
503
504th.tableblock.valign-top, td.tableblock.valign-top {
505 vertical-align: top;
506}
507th.tableblock.valign-middle, td.tableblock.valign-middle {
508 vertical-align: middle;
509}
510th.tableblock.valign-bottom, td.tableblock.valign-bottom {
511 vertical-align: bottom;
512}
513
514
515/*
516 * manpage specific
517 *
518 * */
519
520body.manpage h1 {
Junio C Hamano68cf15a2010-11-06 01:01:59521 padding-top: 0.5em;
522 padding-bottom: 0.5em;
523 border-top: 2px solid silver;
524 border-bottom: 2px solid silver;
525}
Junio C Hamano9d971152012-12-19 00:43:11526body.manpage h2 {
Junio C Hamano68cf15a2010-11-06 01:01:59527 border-style: none;
528}
Junio C Hamano9d971152012-12-19 00:43:11529body.manpage div.sectionbody {
530 margin-left: 3em;
Junio C Hamano68cf15a2010-11-06 01:01:59531}
532
533@media print {
Junio C Hamano9d971152012-12-19 00:43:11534 body.manpage div#toc { display: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59535}
Junio C Hamanoc14e6ad2014-10-31 20:25:53536
537
Junio C Hamano6ac2f142007-03-01 01:24:56538</style>
Junio C Hamano7bd050f2011-09-22 06:32:22539<script type="text/javascript">
540/*<![CDATA[*/
Junio C Hamano7bd050f2011-09-22 06:32:22541var asciidoc = { // Namespace.
542
543/////////////////////////////////////////////////////////////////////
544// Table Of Contents generator
545/////////////////////////////////////////////////////////////////////
546
547/* Author: Mihai Bazon, September 2002
548 * http://students.infoiasi.ro/~mishoo
549 *
550 * Table Of Content generator
551 * Version: 0.4
552 *
553 * Feel free to use this script under the terms of the GNU General Public
554 * License, as long as you do not remove or alter this notice.
555 */
556
557 /* modified by Troy D. Hanson, September 2006. License: GPL */
558 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
559
560// toclevels = 1..4.
561toc: function (toclevels) {
562
563 function getText(el) {
564 var text = "";
565 for (var i = el.firstChild; i != null; i = i.nextSibling) {
566 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
567 text += i.data;
568 else if (i.firstChild != null)
569 text += getText(i);
570 }
571 return text;
572 }
573
574 function TocEntry(el, text, toclevel) {
575 this.element = el;
576 this.text = text;
577 this.toclevel = toclevel;
578 }
579
580 function tocEntries(el, toclevels) {
581 var result = new Array;
Junio C Hamanoc14e6ad2014-10-31 20:25:53582 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
Junio C Hamano7bd050f2011-09-22 06:32:22583 // Function that scans the DOM tree for header elements (the DOM2
584 // nodeIterator API would be a better technique but not supported by all
585 // browsers).
586 var iterate = function (el) {
587 for (var i = el.firstChild; i != null; i = i.nextSibling) {
588 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
589 var mo = re.exec(i.tagName);
590 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
591 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
592 }
593 iterate(i);
594 }
595 }
596 }
597 iterate(el);
598 return result;
599 }
600
601 var toc = document.getElementById("toc");
Junio C Hamano9d971152012-12-19 00:43:11602 if (!toc) {
603 return;
604 }
605
606 // Delete existing TOC entries in case we're reloading the TOC.
607 var tocEntriesToRemove = [];
608 var i;
609 for (i = 0; i < toc.childNodes.length; i++) {
610 var entry = toc.childNodes[i];
Junio C Hamanoc14e6ad2014-10-31 20:25:53611 if (entry.nodeName.toLowerCase() == 'div'
Junio C Hamano9d971152012-12-19 00:43:11612 && entry.getAttribute("class")
613 && entry.getAttribute("class").match(/^toclevel/))
614 tocEntriesToRemove.push(entry);
615 }
616 for (i = 0; i < tocEntriesToRemove.length; i++) {
617 toc.removeChild(tocEntriesToRemove[i]);
618 }
619
620 // Rebuild TOC entries.
Junio C Hamano7bd050f2011-09-22 06:32:22621 var entries = tocEntries(document.getElementById("content"), toclevels);
622 for (var i = 0; i < entries.length; ++i) {
623 var entry = entries[i];
624 if (entry.element.id == "")
625 entry.element.id = "_toc_" + i;
626 var a = document.createElement("a");
627 a.href = "#" + entry.element.id;
628 a.appendChild(document.createTextNode(entry.text));
629 var div = document.createElement("div");
630 div.appendChild(a);
631 div.className = "toclevel" + entry.toclevel;
632 toc.appendChild(div);
633 }
634 if (entries.length == 0)
635 toc.parentNode.removeChild(toc);
636},
637
638
639/////////////////////////////////////////////////////////////////////
640// Footnotes generator
641/////////////////////////////////////////////////////////////////////
642
643/* Based on footnote generation code from:
644 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
645 */
646
647footnotes: function () {
Junio C Hamano9d971152012-12-19 00:43:11648 // Delete existing footnote entries in case we're reloading the footnodes.
649 var i;
Junio C Hamano7bd050f2011-09-22 06:32:22650 var noteholder = document.getElementById("footnotes");
Junio C Hamano9d971152012-12-19 00:43:11651 if (!noteholder) {
652 return;
653 }
654 var entriesToRemove = [];
655 for (i = 0; i < noteholder.childNodes.length; i++) {
656 var entry = noteholder.childNodes[i];
Junio C Hamanoc14e6ad2014-10-31 20:25:53657 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
Junio C Hamano9d971152012-12-19 00:43:11658 entriesToRemove.push(entry);
659 }
660 for (i = 0; i < entriesToRemove.length; i++) {
661 noteholder.removeChild(entriesToRemove[i]);
662 }
663
664 // Rebuild footnote entries.
665 var cont = document.getElementById("content");
Junio C Hamano7bd050f2011-09-22 06:32:22666 var spans = cont.getElementsByTagName("span");
667 var refs = {};
668 var n = 0;
669 for (i=0; i<spans.length; i++) {
670 if (spans[i].className == "footnote") {
671 n++;
Junio C Hamano9d971152012-12-19 00:43:11672 var note = spans[i].getAttribute("data-note");
673 if (!note) {
674 // Use [\s\S] in place of . so multi-line matches work.
675 // Because JavaScript has no s (dotall) regex flag.
676 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
677 spans[i].innerHTML =
678 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
679 "' title='View footnote' class='footnote'>" + n + "</a>]";
680 spans[i].setAttribute("data-note", note);
681 }
Junio C Hamano7bd050f2011-09-22 06:32:22682 noteholder.innerHTML +=
683 "<div class='footnote' id='_footnote_" + n + "'>" +
684 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
685 n + "</a>. " + note + "</div>";
Junio C Hamano7bd050f2011-09-22 06:32:22686 var id =spans[i].getAttribute("id");
687 if (id != null) refs["#"+id] = n;
688 }
689 }
690 if (n == 0)
691 noteholder.parentNode.removeChild(noteholder);
692 else {
693 // Process footnoterefs.
694 for (i=0; i<spans.length; i++) {
695 if (spans[i].className == "footnoteref") {
696 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
697 href = href.match(/#.*/)[0]; // Because IE return full URL.
698 n = refs[href];
699 spans[i].innerHTML =
700 "[<a href='#_footnote_" + n +
701 "' title='View footnote' class='footnote'>" + n + "</a>]";
702 }
703 }
704 }
Junio C Hamano9d971152012-12-19 00:43:11705},
706
707install: function(toclevels) {
708 var timerId;
709
710 function reinstall() {
711 asciidoc.footnotes();
712 if (toclevels) {
713 asciidoc.toc(toclevels);
714 }
715 }
716
717 function reinstallAndRemoveTimer() {
718 clearInterval(timerId);
719 reinstall();
720 }
721
722 timerId = setInterval(reinstall, 500);
723 if (document.addEventListener)
724 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
725 else
726 window.onload = reinstallAndRemoveTimer;
Junio C Hamano7bd050f2011-09-22 06:32:22727}
728
729}
Junio C Hamano9d971152012-12-19 00:43:11730asciidoc.install();
Junio C Hamano7bd050f2011-09-22 06:32:22731/*]]>*/
732</script>
Junio C Hamano6ac2f142007-03-01 01:24:56733</head>
Junio C Hamano9d971152012-12-19 00:43:11734<body class="manpage">
Junio C Hamano6ac2f142007-03-01 01:24:56735<div id="header">
736<h1>
737git-bundle(1) Manual Page
738</h1>
739<h2>NAME</h2>
740<div class="sectionbody">
741<p>git-bundle -
742 Move objects and refs by archive
743</p>
744</div>
745</div>
Junio C Hamano7bd050f2011-09-22 06:32:22746<div id="content">
Junio C Hamano9d971152012-12-19 00:43:11747<div class="sect1">
Junio C Hamano68cf15a2010-11-06 01:01:59748<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56749<div class="sectionbody">
Junio C Hamanoa9b8d242007-05-19 04:51:55750<div class="verseblock">
Junio C Hamano9d971152012-12-19 00:43:11751<pre class="content"><em>git bundle</em> create &lt;file&gt; &lt;git-rev-list-args&gt;
Junio C Hamanofce7c7e2008-07-02 03:06:38752<em>git bundle</em> verify &lt;file&gt;
Junio C Hamanod2179ef2010-10-22 04:12:17753<em>git bundle</em> list-heads &lt;file&gt; [&lt;refname&gt;&#8230;]
Junio C Hamano9d971152012-12-19 00:43:11754<em>git bundle</em> unbundle &lt;file&gt; [&lt;refname&gt;&#8230;]</pre>
755<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59756</div></div>
Junio C Hamano6ac2f142007-03-01 01:24:56757</div>
Junio C Hamano9d971152012-12-19 00:43:11758</div>
759<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31760<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56761<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59762<div class="paragraph"><p>Some workflows require that one or more branches of development on one
Junio C Hamano6ac2f142007-03-01 01:24:56763machine be replicated on another machine, but the two machines cannot
Junio C Hamano076ffcc2013-02-06 05:13:21764be directly connected, and therefore the interactive Git protocols (git,
Junio C Hamano1de75722009-03-26 08:39:38765ssh, rsync, http) cannot be used. This command provides support for
Junio C Hamano1aa40d22010-01-21 17:46:43766<em>git fetch</em> and <em>git pull</em> to operate by packaging objects and references
Junio C Hamano6ac2f142007-03-01 01:24:56767in an archive at the originating machine, then importing those into
Junio C Hamano1aa40d22010-01-21 17:46:43768another repository using <em>git fetch</em> and <em>git pull</em>
Junio C Hamano2bd8a742009-12-01 21:16:59769after moving the archive by some means (e.g., by sneakernet). As no
Junio C Hamano1de75722009-03-26 08:39:38770direct connection between the repositories exists, the user must specify a
Junio C Hamano6ac2f142007-03-01 01:24:56771basis for the bundle that is held by the destination repository: the
772bundle assumes that all objects in the basis are already in the
Junio C Hamanoba4b9282008-07-06 05:20:31773destination repository.</p></div>
Junio C Hamano6ac2f142007-03-01 01:24:56774</div>
Junio C Hamano9d971152012-12-19 00:43:11775</div>
776<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31777<h2 id="_options">OPTIONS</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56778<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59779<div class="dlist"><dl>
780<dt class="hdlist1">
Junio C Hamano6ac2f142007-03-01 01:24:56781create &lt;file&gt;
782</dt>
783<dd>
784<p>
Junio C Hamano2db3e752010-09-03 21:33:06785 Used to create a bundle named <em>file</em>. This requires the
786 <em>git-rev-list-args</em> arguments to define the bundle contents.
Junio C Hamano6ac2f142007-03-01 01:24:56787</p>
788</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59789<dt class="hdlist1">
Junio C Hamano6ac2f142007-03-01 01:24:56790verify &lt;file&gt;
791</dt>
792<dd>
793<p>
Junio C Hamano2db3e752010-09-03 21:33:06794 Used to check that a bundle file is valid and will apply
795 cleanly to the current repository. This includes checks on the
796 bundle format itself as well as checking that the prerequisite
797 commits exist and are fully linked in the current repository.
798 <em>git bundle</em> prints a list of missing commits, if any, and exits
799 with a non-zero status.
Junio C Hamano6ac2f142007-03-01 01:24:56800</p>
801</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59802<dt class="hdlist1">
Junio C Hamano6ac2f142007-03-01 01:24:56803list-heads &lt;file&gt;
804</dt>
805<dd>
806<p>
Junio C Hamano2db3e752010-09-03 21:33:06807 Lists the references defined in the bundle. If followed by a
808 list of references, only references matching those given are
809 printed out.
Junio C Hamano6ac2f142007-03-01 01:24:56810</p>
811</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59812<dt class="hdlist1">
Junio C Hamano6ac2f142007-03-01 01:24:56813unbundle &lt;file&gt;
814</dt>
815<dd>
816<p>
Junio C Hamano2db3e752010-09-03 21:33:06817 Passes the objects in the bundle to <em>git index-pack</em>
818 for storage in the repository, then prints the names of all
819 defined references. If a list of references is given, only
820 references matching those in the list are printed. This command is
821 really plumbing, intended to be called only by <em>git fetch</em>.
Junio C Hamano6ac2f142007-03-01 01:24:56822</p>
823</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59824<dt class="hdlist1">
Junio C Hamano2db3e752010-09-03 21:33:06825&lt;git-rev-list-args&gt;
Junio C Hamano6ac2f142007-03-01 01:24:56826</dt>
827<dd>
828<p>
Junio C Hamano2db3e752010-09-03 21:33:06829 A list of arguments, acceptable to <em>git rev-parse</em> and
Junio C Hamano7165bf72011-01-04 22:06:18830 <em>git rev-list</em> (and containing a named ref, see SPECIFYING REFERENCES
Junio C Hamano2db3e752010-09-03 21:33:06831 below), that specifies the specific objects and references
Junio C Hamanoc14e6ad2014-10-31 20:25:53832 to transport. For example, <code>master~10..master</code> causes the
Junio C Hamano2db3e752010-09-03 21:33:06833 current master reference to be packaged along with all objects
834 added since its 10th ancestor commit. There is no explicit
835 limit to the number of references and objects that may be
836 packaged.
Junio C Hamano6ac2f142007-03-01 01:24:56837</p>
838</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59839<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17840[&lt;refname&gt;&#8230;]
Junio C Hamano6ac2f142007-03-01 01:24:56841</dt>
842<dd>
843<p>
Junio C Hamano2db3e752010-09-03 21:33:06844 A list of references used to limit the references reported as
845 available. This is principally of use to <em>git fetch</em>, which
846 expects to receive only those references asked for and not
847 necessarily everything in the pack (in this case, <em>git bundle</em> acts
848 like <em>git fetch-pack</em>).
Junio C Hamano6ac2f142007-03-01 01:24:56849</p>
850</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31851</dl></div>
Junio C Hamano6ac2f142007-03-01 01:24:56852</div>
Junio C Hamano9d971152012-12-19 00:43:11853</div>
854<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31855<h2 id="_specifying_references">SPECIFYING REFERENCES</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56856<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59857<div class="paragraph"><p><em>git bundle</em> will only package references that are shown by
Junio C Hamano1aa40d22010-01-21 17:46:43858<em>git show-ref</em>: this includes heads, tags, and remote heads. References
Junio C Hamanoc14e6ad2014-10-31 20:25:53859such as <code>master~1</code> cannot be packaged, but are perfectly suitable for
Junio C Hamano6ac2f142007-03-01 01:24:56860defining the basis. More than one reference may be packaged, and more
861than one basis can be specified. The objects packaged are those not
862contained in the union of the given bases. Each basis can be
Junio C Hamanoc14e6ad2014-10-31 20:25:53863specified explicitly (e.g. <code>^master~10</code>), or implicitly (e.g.
864<code>master~10..master</code>, <code>--since=10.days.ago master</code>).</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59865<div class="paragraph"><p>It is very important that the basis used be held by the destination.
Junio C Hamano1de75722009-03-26 08:39:38866It is okay to err on the side of caution, causing the bundle file
867to contain objects already in the destination, as these are ignored
Junio C Hamanoba4b9282008-07-06 05:20:31868when unpacking at the destination.</p></div>
Junio C Hamano6ac2f142007-03-01 01:24:56869</div>
Junio C Hamano9d971152012-12-19 00:43:11870</div>
871<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31872<h2 id="_example">EXAMPLE</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56873<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59874<div class="paragraph"><p>Assume you want to transfer the history from a repository R1 on machine A
Junio C Hamanoa3bb6eb2009-02-05 01:26:33875to another repository R2 on machine B.
Junio C Hamano6ac2f142007-03-01 01:24:56876For whatever reason, direct connection between A and B is not allowed,
Junio C Hamano1de75722009-03-26 08:39:38877but we can move data from A to B via some mechanism (CD, email, etc.).
878We want to update R2 with development made on the branch master in R1.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59879<div class="paragraph"><p>To bootstrap the process, you can first create a bundle that does not have
Junio C Hamano1de75722009-03-26 08:39:38880any basis. You can use a tag to remember up to what commit you last
881processed, in order to make it easy to later update the other repository
882with an incremental bundle:</p></div>
Junio C Hamano601f3e52008-02-25 08:40:42883<div class="listingblock">
884<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53885<pre><code>machineA$ cd R1
Junio C Hamano61169122009-02-09 18:05:49886machineA$ git bundle create file.bundle master
Junio C Hamanoc14e6ad2014-10-31 20:25:53887machineA$ git tag -f lastR2bundle master</code></pre>
Junio C Hamano601f3e52008-02-25 08:40:42888</div></div>
Junio C Hamano6bdcc7d2013-01-09 00:15:42889<div class="paragraph"><p>Then you transfer file.bundle to the target machine B. Because this
890bundle does not require any existing object to be extracted, you can
891create a new repository on machine B by cloning from it:</p></div>
Junio C Hamano4fd58d42007-09-30 00:51:14892<div class="listingblock">
893<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53894<pre><code>machineB$ git clone -b master /home/me/tmp/file.bundle R2</code></pre>
Junio C Hamano4fd58d42007-09-30 00:51:14895</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59896<div class="paragraph"><p>This will define a remote called "origin" in the resulting repository that
Junio C Hamano1de75722009-03-26 08:39:38897lets you fetch and pull from the bundle. The $GIT_DIR/config file in R2 will
Junio C Hamanoa3bb6eb2009-02-05 01:26:33898have an entry like this:</p></div>
Junio C Hamano601f3e52008-02-25 08:40:42899<div class="listingblock">
900<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53901<pre><code>[remote "origin"]
Junio C Hamano61169122009-02-09 18:05:49902 url = /home/me/tmp/file.bundle
Junio C Hamanoc14e6ad2014-10-31 20:25:53903 fetch = refs/heads/*:refs/remotes/origin/*</code></pre>
Junio C Hamano6ac2f142007-03-01 01:24:56904</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59905<div class="paragraph"><p>To update the resulting mine.git repository, you can fetch or pull after
Junio C Hamano1de75722009-03-26 08:39:38906replacing the bundle stored at /home/me/tmp/file.bundle with incremental
907updates.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59908<div class="paragraph"><p>After working some more in the original repository, you can create an
Junio C Hamano1de75722009-03-26 08:39:38909incremental bundle to update the other repository:</p></div>
Junio C Hamano4fd58d42007-09-30 00:51:14910<div class="listingblock">
911<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53912<pre><code>machineA$ cd R1
Junio C Hamano61169122009-02-09 18:05:49913machineA$ git bundle create file.bundle lastR2bundle..master
Junio C Hamanoc14e6ad2014-10-31 20:25:53914machineA$ git tag -f lastR2bundle master</code></pre>
Junio C Hamano4fd58d42007-09-30 00:51:14915</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59916<div class="paragraph"><p>You then transfer the bundle to the other machine to replace
Junio C Hamano1de75722009-03-26 08:39:38917/home/me/tmp/file.bundle, and pull from it.</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33918<div class="listingblock">
919<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53920<pre><code>machineB$ cd R2
921machineB$ git pull</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33922</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59923<div class="paragraph"><p>If you know up to what commit the intended recipient repository should
Junio C Hamano1de75722009-03-26 08:39:38924have the necessary objects, you can use that knowledge to specify the
Junio C Hamanoa3bb6eb2009-02-05 01:26:33925basis, giving a cut-off point to limit the revisions and objects that go
Junio C Hamano2db3e752010-09-03 21:33:06926in the resulting bundle. The previous example used the lastR2bundle tag
Junio C Hamano1de75722009-03-26 08:39:38927for this purpose, but you can use any other options that you would give to
Junio C Hamanoa28a9202012-06-21 07:08:23928the <a href="git-log.html">git-log(1)</a> command. Here are more examples:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59929<div class="paragraph"><p>You can use a tag that is present in both:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33930<div class="listingblock">
931<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53932<pre><code>$ git bundle create mybundle v1.0.0..master</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33933</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59934<div class="paragraph"><p>You can use a basis based on time:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33935<div class="listingblock">
936<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53937<pre><code>$ git bundle create mybundle --since=10.days master</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33938</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59939<div class="paragraph"><p>You can use the number of commits:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33940<div class="listingblock">
941<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53942<pre><code>$ git bundle create mybundle -10 master</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33943</div></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53944<div class="paragraph"><p>You can run <code>git-bundle verify</code> to see if you can extract from a bundle
Junio C Hamano1de75722009-03-26 08:39:38945that was created with a basis:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33946<div class="listingblock">
947<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53948<pre><code>$ git bundle verify mybundle</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33949</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59950<div class="paragraph"><p>This will list what commits you must have in order to extract from the
Junio C Hamano1de75722009-03-26 08:39:38951bundle and will error out if you do not have them.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59952<div class="paragraph"><p>A bundle from a recipient repository&#8217;s point of view is just like a
Junio C Hamano1de75722009-03-26 08:39:38953regular repository which it fetches or pulls from. You can, for example, map
954references when fetching:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33955<div class="listingblock">
956<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53957<pre><code>$ git fetch mybundle master:localRef</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33958</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59959<div class="paragraph"><p>You can also see what references it offers:</p></div>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33960<div class="listingblock">
961<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53962<pre><code>$ git ls-remote mybundle</code></pre>
Junio C Hamanoa3bb6eb2009-02-05 01:26:33963</div></div>
Junio C Hamano6ac2f142007-03-01 01:24:56964</div>
Junio C Hamano9d971152012-12-19 00:43:11965</div>
966<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31967<h2 id="_git">GIT</h2>
Junio C Hamano6ac2f142007-03-01 01:24:56968<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23969<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano6ac2f142007-03-01 01:24:56970</div>
Junio C Hamano7bd050f2011-09-22 06:32:22971</div>
Junio C Hamano9d971152012-12-19 00:43:11972</div>
Junio C Hamano7bd050f2011-09-22 06:32:22973<div id="footnotes"><hr /></div>
Junio C Hamano6ac2f142007-03-01 01:24:56974<div id="footer">
975<div id="footer-text">
Junio C Hamano683a8612013-08-23 20:50:09976Last updated 2013-08-20 08:40:27 PDT
Junio C Hamano6ac2f142007-03-01 01:24:56977</div>
978</div>
979</body>
980</html>