blob: 1c88116e270e6cc867f1dec8502e6201c9614ab2 [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>
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-clone(1)</title>
Junio C Hamano1a4e8412005-12-27 08:17:238<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 Hamano1a4e8412005-12-27 08:17:2324}
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 Hamano1a4e8412005-12-27 08:17:2337
38em {
39 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:5940 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:2341}
42
43strong {
44 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:5945 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:2346}
47
Junio C Hamano1a4e8412005-12-27 08:17:2348h1, h2, h3, h4, h5, h6 {
49 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:2350 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 Hamano1a4e8412005-12-27 08:17:2356 border-bottom: 2px solid silver;
57}
58h2 {
Junio C Hamano1a4e8412005-12-27 08:17:2359 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 Hamano1a4e8412005-12-27 08:17:2370
71div.sectionbody {
Junio C Hamano1a4e8412005-12-27 08:17:2372 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 Hamano1a4e8412005-12-27 08:17:2394 padding: 0;
95 margin: 0;
96}
Junio C Hamanoc14e6ad2014-10-31 20:25:5397pre {
98 white-space: pre-wrap;
99}
Junio C Hamano1a4e8412005-12-27 08:17:23100
Junio C Hamano9d971152012-12-19 00:43:11101#author {
Junio C Hamano1a4e8412005-12-27 08:17:23102 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23103 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31104 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23105}
Junio C Hamano9d971152012-12-19 00:43:11106#email {
Junio C Hamano1a4e8412005-12-27 08:17:23107}
Junio C Hamano9d971152012-12-19 00:43:11108#revnumber, #revdate, #revremark {
Junio C Hamano1a4e8412005-12-27 08:17:23109}
110
Junio C Hamano9d971152012-12-19 00:43:11111#footer {
Junio C Hamano1a4e8412005-12-27 08:17:23112 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 Hamano1a4e8412005-12-27 08:17:23118 float: left;
119 padding-bottom: 0.5em;
120}
Junio C Hamano9d971152012-12-19 00:43:11121#footer-badges {
Junio C Hamano1a4e8412005-12-27 08:17:23122 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 Hamano1a4e8412005-12-27 08:17:23131div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
132div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22133 margin-top: 1.0em;
Junio C Hamano1a4e8412005-12-27 08:17:23134 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 Hamano1a4e8412005-12-27 08:17:23141}
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 Hamano1a4e8412005-12-27 08:17:23150 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 Hamano1a4e8412005-12-27 08:17:23173 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 Hamano1a4e8412005-12-27 08:17:23180 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 Hamano1a4e8412005-12-27 08:17:23189}
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 Hamano1a4e8412005-12-27 08:17:23193 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 Hamano1a4e8412005-12-27 08:17:23208
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 Hamano1a4e8412005-12-27 08:17:23220}
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 Hamano1a4e8412005-12-27 08:17:23225}
226
Junio C Hamano1a4e8412005-12-27 08:17:23227div.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 Hamano1a4e8412005-12-27 08:17:23230
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 Hamano1a4e8412005-12-27 08:17:23240}
241dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59242 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23243}
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 Hamano1a4e8412005-12-27 08:17:23252 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 Hamano1a4e8412005-12-27 08:17:23270
Junio C Hamano1a4e8412005-12-27 08:17:23271tfoot {
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 Hamano1a4e8412005-12-27 08:17:23279 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 Hamano1a4e8412005-12-27 08:17:23289 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59290 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23291 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59292 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23293}
Junio C Hamano68cf15a2010-11-06 01:01:59294td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23295 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 Hamano1a4e8412005-12-27 08:17:23305
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 Hamano1a4e8412005-12-27 08:17:23340}
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 Hamano1a4e8412005-12-27 08:17:23538</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 Hamano1a4e8412005-12-27 08:17:23733</head>
Junio C Hamano9d971152012-12-19 00:43:11734<body class="manpage">
Junio C Hamano1a4e8412005-12-27 08:17:23735<div id="header">
736<h1>
737git-clone(1) Manual Page
738</h1>
739<h2>NAME</h2>
740<div class="sectionbody">
741<p>git-clone -
Junio C Hamano4ec06712007-06-09 20:39:33742 Clone a repository into a new directory
Junio C Hamano1a4e8412005-12-27 08:17:23743</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 Hamano1a4e8412005-12-27 08:17:23749<div class="sectionbody">
Junio C Hamano235a91e2006-01-07 01:13:58750<div class="verseblock">
Junio C Hamano9d971152012-12-19 00:43:11751<pre class="content"><em>git clone</em> [--template=&lt;template_directory&gt;]
Junio C Hamanoaf1987f2008-08-03 07:58:19752 [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror]
Junio C Hamano2bd8a742009-12-01 21:16:59753 [-o &lt;name&gt;] [-b &lt;name&gt;] [-u &lt;upload-pack&gt;] [--reference &lt;repository&gt;]
Junio C Hamanoc9394b22015-01-07 22:45:48754 [--dissociate] [--separate-git-dir &lt;git dir&gt;]
Junio C Hamanob5be0522012-01-29 22:20:19755 [--depth &lt;depth&gt;] [--[no-]single-branch]
Junio C Hamanoccdabca2016-05-06 22:27:09756 [--recursive | --recurse-submodules] [--[no-]shallow-submodules]
757 [--jobs &lt;n&gt;] [--] &lt;repository&gt; [&lt;directory&gt;]</pre>
Junio C Hamano9d971152012-12-19 00:43:11758<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59759</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23760</div>
Junio C Hamano9d971152012-12-19 00:43:11761</div>
762<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31763<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23764<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59765<div class="paragraph"><p>Clones a repository into a newly created directory, creates
Junio C Hamano5102d9a2006-12-08 07:23:46766remote-tracking branches for each branch in the cloned repository
Junio C Hamanoc14e6ad2014-10-31 20:25:53767(visible using <code>git branch -r</code>), and creates and checks out an
Junio C Hamano68cf15a2010-11-06 01:01:59768initial branch that is forked from the cloned repository&#8217;s
Junio C Hamanoc0e55e72009-10-10 00:56:29769currently active branch.</p></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53770<div class="paragraph"><p>After the clone, a plain <code>git fetch</code> without arguments will update
771all the remote-tracking branches, and a <code>git pull</code> without
Junio C Hamano5102d9a2006-12-08 07:23:46772arguments will in addition merge the remote master branch into the
Junio C Hamano6a8a8482012-10-01 20:59:41773current master branch, if any (this is untrue when "--single-branch"
774is given; see below).</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59775<div class="paragraph"><p>This default configuration is achieved by creating references to
Junio C Hamanoc14e6ad2014-10-31 20:25:53776the remote branch heads under <code>refs/remotes/origin</code> and
777by initializing <code>remote.origin.url</code> and <code>remote.origin.fetch</code>
Junio C Hamanoba4b9282008-07-06 05:20:31778configuration variables.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23779</div>
Junio C Hamano9d971152012-12-19 00:43:11780</div>
781<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31782<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23783<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59784<div class="dlist"><dl>
785<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23786--local
787</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59788<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23789-l
790</dt>
791<dd>
792<p>
793 When the repository to clone from is on a local machine,
Junio C Hamano076ffcc2013-02-06 05:13:21794 this flag bypasses the normal "Git aware" transport
Junio C Hamano1a4e8412005-12-27 08:17:23795 mechanism and clones the repository by making a copy of
796 HEAD and everything under objects and refs directories.
Junio C Hamanoc14e6ad2014-10-31 20:25:53797 The files under <code>.git/objects/</code> directory are hardlinked
Junio C Hamano7f2b3cb2012-06-22 22:42:39798 to save space when possible.
Junio C Hamanob1d6e882007-08-11 08:30:16799</p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53800<div class="paragraph"><p>If the repository is specified as a local path (e.g., <code>/path/to/repo</code>),
Junio C Hamano7f2b3cb2012-06-22 22:42:39801this is the default, and --local is essentially a no-op. If the
802repository is specified as a URL, then this flag is ignored (and we
Junio C Hamanoc14e6ad2014-10-31 20:25:53803never use the local optimizations). Specifying <code>--no-local</code> will
804override the default when <code>/path/to/repo</code> is given, using the regular
Junio C Hamano076ffcc2013-02-06 05:13:21805Git transport instead.</p></div>
Junio C Hamanob1d6e882007-08-11 08:30:16806</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59807<dt class="hdlist1">
Junio C Hamanob1d6e882007-08-11 08:30:16808--no-hardlinks
809</dt>
810<dd>
811<p>
Junio C Hamano5b3533d2014-02-27 23:07:15812 Force the cloning process from a repository on a local
Junio C Hamanoc14e6ad2014-10-31 20:25:53813 filesystem to copy the files under the <code>.git/objects</code>
Junio C Hamano5b3533d2014-02-27 23:07:15814 directory instead of using hardlinks. This may be desirable
815 if you are trying to make a back-up of your repository.
Junio C Hamano1a4e8412005-12-27 08:17:23816</p>
817</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59818<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23819--shared
820</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59821<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23822-s
823</dt>
824<dd>
825<p>
826 When the repository to clone is on the local machine,
827 instead of using hard links, automatically setup
Junio C Hamanoc14e6ad2014-10-31 20:25:53828 <code>.git/objects/info/alternates</code> to share the objects
Junio C Hamano1a4e8412005-12-27 08:17:23829 with the source repository. The resulting repository
830 starts out without any object of its own.
831</p>
Junio C Hamano68cf15a2010-11-06 01:01:59832<div class="paragraph"><p><strong>NOTE</strong>: this is a possibly dangerous operation; do <strong>not</strong> use
Junio C Hamanoefe3c632008-02-14 00:51:31833it unless you understand what it does. If you clone your
Junio C Hamanoa9aee782008-04-23 16:09:20834repository using this option and then delete branches (or use any
Junio C Hamano076ffcc2013-02-06 05:13:21835other Git command that makes any existing commit unreferenced) in the
Junio C Hamanoa9aee782008-04-23 16:09:20836source repository, some objects may become unreferenced (or dangling).
Junio C Hamanoc14e6ad2014-10-31 20:25:53837These objects may be removed by normal Git operations (such as <code>git commit</code>)
838which automatically call <code>git gc --auto</code>. (See <a href="git-gc.html">git-gc(1)</a>.)
Junio C Hamanofce7c7e2008-07-02 03:06:38839If these objects are removed and were referenced by the cloned repository,
Junio C Hamanoba4b9282008-07-06 05:20:31840then the cloned repository will become corrupt.</p></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53841<div class="paragraph"><p>Note that running <code>git repack</code> without the <code>-l</code> option in a repository
842cloned with <code>-s</code> will copy objects from the source repository into a pack
843in the cloned repository, removing the disk space savings of <code>clone -s</code>.
844It is safe, however, to run <code>git gc</code>, which uses the <code>-l</code> option by
Junio C Hamanob9376922009-08-19 00:09:13845default.</p></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53846<div class="paragraph"><p>If you want to break the dependency of a repository cloned with <code>-s</code> on
847its source repository, you can simply run <code>git repack -a</code> to copy all
Junio C Hamanob9376922009-08-19 00:09:13848objects from the source repository into a pack in the cloned repository.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23849</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59850<dt class="hdlist1">
Junio C Hamanof50bfec2006-04-19 09:44:12851--reference &lt;repository&gt;
852</dt>
853<dd>
854<p>
Junio C Hamano35b47ca2009-09-03 18:11:54855 If the reference repository is on the local machine,
Junio C Hamanoc14e6ad2014-10-31 20:25:53856 automatically setup <code>.git/objects/info/alternates</code> to
Junio C Hamanof50bfec2006-04-19 09:44:12857 obtain objects from the reference repository. Using
858 an already existing repository as an alternate will
Junio C Hamano250f03e2007-09-10 01:33:28859 require fewer objects to be copied from the repository
Junio C Hamanof50bfec2006-04-19 09:44:12860 being cloned, reducing network and local storage costs.
861</p>
Junio C Hamanoc9394b22015-01-07 22:45:48862<div class="paragraph"><p><strong>NOTE</strong>: see the NOTE for the <code>--shared</code> option, and also the
863<code>--dissociate</code> option.</p></div>
864</dd>
865<dt class="hdlist1">
866--dissociate
867</dt>
868<dd>
869<p>
870 Borrow the objects from reference repositories specified
871 with the <code>--reference</code> options only to reduce network
Junio C Hamano448d1322015-10-30 21:57:54872 transfer, and stop borrowing from them after a clone is made
873 by making necessary local copies of borrowed objects. This
874 option can also be used when cloning locally from a
875 repository that already borrows objects from another
876 repository&#8212;the new repository will borrow objects from the
877 same repository, and this option can be used to stop the
878 borrowing.
Junio C Hamanoc9394b22015-01-07 22:45:48879</p>
Junio C Hamanof50bfec2006-04-19 09:44:12880</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59881<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23882--quiet
883</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59884<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23885-q
886</dt>
887<dd>
888<p>
Junio C Hamano6ce6b6c2010-01-18 01:25:50889 Operate quietly. Progress is not reported to the standard
Junio C Hamanof85ef632016-02-17 22:31:06890 error stream.
Junio C Hamano1a4e8412005-12-27 08:17:23891</p>
892</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59893<dt class="hdlist1">
Junio C Hamano7d06a8a2008-10-20 05:42:33894--verbose
895</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59896<dt class="hdlist1">
Junio C Hamano7d06a8a2008-10-20 05:42:33897-v
898</dt>
899<dd>
900<p>
Junio C Hamanoea90ab32010-03-15 20:32:55901 Run verbosely. Does not affect the reporting of progress status
902 to the standard error stream.
Junio C Hamano6ce6b6c2010-01-18 01:25:50903</p>
904</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59905<dt class="hdlist1">
Junio C Hamano6ce6b6c2010-01-18 01:25:50906--progress
907</dt>
908<dd>
909<p>
910 Progress status is reported on the standard error stream
911 by default when it is attached to a terminal, unless -q
912 is specified. This flag forces progress status even if the
913 standard error stream is not directed to a terminal.
Junio C Hamano7d06a8a2008-10-20 05:42:33914</p>
915</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59916<dt class="hdlist1">
Junio C Hamano1e6e0062007-07-13 05:33:25917--no-checkout
918</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59919<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23920-n
921</dt>
922<dd>
923<p>
924 No checkout of HEAD is performed after the clone is complete.
925</p>
926</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59927<dt class="hdlist1">
Junio C Hamanoe663a7a2006-01-25 12:37:28928--bare
Junio C Hamano38064d52006-01-15 10:13:49929</dt>
930<dd>
931<p>
Junio C Hamano076ffcc2013-02-06 05:13:21932 Make a <em>bare</em> Git repository. That is, instead of
Junio C Hamanoc14e6ad2014-10-31 20:25:53933 creating <code>&lt;directory&gt;</code> and placing the administrative
934 files in <code>&lt;directory&gt;/.git</code>, make the <code>&lt;directory&gt;</code>
935 itself the <code>$GIT_DIR</code>. This obviously implies the <code>-n</code>
Junio C Hamano9f292e72006-11-24 11:37:29936 because there is nowhere to check out the working tree.
937 Also the branch heads at the remote are copied directly
938 to corresponding local branch heads, without mapping
Junio C Hamanoc14e6ad2014-10-31 20:25:53939 them to <code>refs/remotes/origin/</code>. When this option is
Junio C Hamanod3361ad2007-01-01 03:20:24940 used, neither remote-tracking branches nor the related
941 configuration variables are created.
Junio C Hamano38064d52006-01-15 10:13:49942</p>
943</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59944<dt class="hdlist1">
Junio C Hamanoaf1987f2008-08-03 07:58:19945--mirror
946</dt>
947<dd>
948<p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53949 Set up a mirror of the source repository. This implies <code>--bare</code>.
950 Compared to <code>--bare</code>, <code>--mirror</code> not only maps local branches of the
Junio C Hamano657fd8a2010-10-07 00:01:24951 source to local branches of the target, it maps all refs (including
Junio C Hamano97bcb482010-11-25 03:16:07952 remote-tracking branches, notes etc.) and sets up a refspec configuration such
Junio C Hamanoc14e6ad2014-10-31 20:25:53953 that all these refs are overwritten by a <code>git remote update</code> in the
Junio C Hamano657fd8a2010-10-07 00:01:24954 target repository.
Junio C Hamanoaf1987f2008-08-03 07:58:19955</p>
956</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59957<dt class="hdlist1">
Junio C Hamanodcc22ee2006-11-03 02:40:13958--origin &lt;name&gt;
959</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59960<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23961-o &lt;name&gt;
962</dt>
963<dd>
964<p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53965 Instead of using the remote name <code>origin</code> to keep track
966 of the upstream repository, use <code>&lt;name&gt;</code>.
Junio C Hamano1a4e8412005-12-27 08:17:23967</p>
968</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59969<dt class="hdlist1">
Junio C Hamanoc28068f2009-09-08 00:55:23970--branch &lt;name&gt;
971</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59972<dt class="hdlist1">
Junio C Hamanoc28068f2009-09-08 00:55:23973-b &lt;name&gt;
974</dt>
975<dd>
976<p>
977 Instead of pointing the newly created HEAD to the branch pointed
Junio C Hamanoc14e6ad2014-10-31 20:25:53978 to by the cloned repository&#8217;s HEAD, point to <code>&lt;name&gt;</code> branch
Junio C Hamano6a8a8482012-10-01 20:59:41979 instead. In a non-bare repository, this is the branch that will
980 be checked out.
Junio C Hamanoc14e6ad2014-10-31 20:25:53981 <code>--branch</code> can also take tags and detaches the HEAD at that commit
Junio C Hamano6a8a8482012-10-01 20:59:41982 in the resulting repository.
Junio C Hamanoc28068f2009-09-08 00:55:23983</p>
984</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59985<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23986--upload-pack &lt;upload-pack&gt;
987</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59988<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23989-u &lt;upload-pack&gt;
990</dt>
991<dd>
992<p>
Junio C Hamano3db8b412008-07-26 06:45:59993 When given, and the repository to clone from is accessed
994 via ssh, this specifies a non-default path for the command
Junio C Hamano1a4e8412005-12-27 08:17:23995 run on the other end.
996</p>
997</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59998<dt class="hdlist1">
Junio C Hamanof31d9f52006-05-28 20:58:09999--template=&lt;template_directory&gt;
1000</dt>
1001<dd>
1002<p>
1003 Specify the directory from which templates will be used;
Junio C Hamanoa28a9202012-06-21 07:08:231004 (See the "TEMPLATE DIRECTORY" section of <a href="git-init.html">git-init(1)</a>.)
Junio C Hamanof31d9f52006-05-28 20:58:091005</p>
1006</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591007<dt class="hdlist1">
Junio C Hamano708376e2011-07-19 20:02:131008--config &lt;key&gt;=&lt;value&gt;
1009</dt>
1010<dt class="hdlist1">
1011-c &lt;key&gt;=&lt;value&gt;
1012</dt>
1013<dd>
1014<p>
1015 Set a configuration variable in the newly-created repository;
1016 this takes effect immediately after the repository is
1017 initialized, but before the remote history is fetched or any
1018 files checked out. The key is in the same format as expected by
Junio C Hamanoc14e6ad2014-10-31 20:25:531019 <a href="git-config.html">git-config(1)</a> (e.g., <code>core.eol=true</code>). If multiple
Junio C Hamano708376e2011-07-19 20:02:131020 values are given for the same key, each value will be written to
1021 the config file. This makes it safe, for example, to add
1022 additional fetch refspecs to the origin remote.
1023</p>
1024</dd>
1025<dt class="hdlist1">
Junio C Hamano0bbd4672007-02-20 04:52:141026--depth &lt;depth&gt;
Junio C Hamanob288d9e2007-01-02 00:04:151027</dt>
1028<dd>
1029<p>
1030 Create a <em>shallow</em> clone with a history truncated to the
Junio C Hamano4e6ba272016-01-20 23:23:191031 specified number of commits. Implies <code>--single-branch</code> unless
1032 <code>--no-single-branch</code> is given to fetch the histories near the
Junio C Hamanoc6c919b2016-07-06 21:34:151033 tips of all branches. If you want to clone submodules shallowly,
1034 also pass <code>--shallow-submodules</code>.
Junio C Hamanob288d9e2007-01-02 00:04:151035</p>
1036</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591037<dt class="hdlist1">
Junio C Hamano3d1b5a12013-05-17 23:34:021038--[no-]single-branch
Junio C Hamanob5be0522012-01-29 22:20:191039</dt>
1040<dd>
1041<p>
1042 Clone only the history leading to the tip of a single branch,
Junio C Hamanoc14e6ad2014-10-31 20:25:531043 either specified by the <code>--branch</code> option or the primary
Junio C Hamano4e6ba272016-01-20 23:23:191044 branch remote&#8217;s <code>HEAD</code> points at.
Junio C Hamano6a8a8482012-10-01 20:59:411045 Further fetches into the resulting repository will only update the
Junio C Hamanoa1295452012-11-13 22:32:041046 remote-tracking branch for the branch this option was used for the
Junio C Hamano6a8a8482012-10-01 20:59:411047 initial cloning. If the HEAD at the remote did not point at any
Junio C Hamanoc14e6ad2014-10-31 20:25:531048 branch when <code>--single-branch</code> clone was made, no remote-tracking
Junio C Hamano6a8a8482012-10-01 20:59:411049 branch is created.
Junio C Hamanob5be0522012-01-29 22:20:191050</p>
1051</dd>
1052<dt class="hdlist1">
Junio C Hamano0e066b92009-08-28 01:08:411053--recursive
1054</dt>
Junio C Hamanoed69a742010-12-01 03:09:231055<dt class="hdlist1">
1056--recurse-submodules
1057</dt>
Junio C Hamano0e066b92009-08-28 01:08:411058<dd>
1059<p>
1060 After the clone is created, initialize all submodules within,
1061 using their default settings. This is equivalent to running
Junio C Hamanoc14e6ad2014-10-31 20:25:531062 <code>git submodule update --init --recursive</code> immediately after
Junio C Hamano0e066b92009-08-28 01:08:411063 the clone is finished. This option is ignored if the cloned
1064 repository does not have a worktree/checkout (i.e. if any of
Junio C Hamanoc14e6ad2014-10-31 20:25:531065 <code>--no-checkout</code>/<code>-n</code>, <code>--bare</code>, or <code>--mirror</code> is given)
Junio C Hamano0e066b92009-08-28 01:08:411066</p>
1067</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591068<dt class="hdlist1">
Junio C Hamanoccdabca2016-05-06 22:27:091069--[no-]shallow-submodules
1070</dt>
1071<dd>
1072<p>
1073 All submodules which are cloned will be shallow with a depth of 1.
1074</p>
1075</dd>
1076<dt class="hdlist1">
Junio C Hamanoa03ac862011-04-02 04:32:291077--separate-git-dir=&lt;git dir&gt;
1078</dt>
1079<dd>
1080<p>
1081 Instead of placing the cloned repository where it is supposed
1082 to be, place the cloned repository at the specified directory,
Junio C Hamano826f5c42014-02-07 20:33:301083 then make a filesystem-agnostic Git symbolic link to there.
Junio C Hamano076ffcc2013-02-06 05:13:211084 The result is Git repository can be separated from working
Junio C Hamanoa03ac862011-04-02 04:32:291085 tree.
1086</p>
1087</dd>
1088<dt class="hdlist1">
Junio C Hamanobec5da42016-04-06 22:58:211089-j &lt;n&gt;
1090</dt>
1091<dt class="hdlist1">
1092--jobs &lt;n&gt;
1093</dt>
1094<dd>
1095<p>
1096 The number of submodules fetched at the same time.
1097 Defaults to the <code>submodule.fetchJobs</code> option.
1098</p>
1099</dd>
1100<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:231101&lt;repository&gt;
1102</dt>
1103<dd>
1104<p>
Junio C Hamano330aae62007-07-06 17:01:581105 The (possibly remote) repository to clone from. See the
1106 <a href="#URLS">URLS</a> section below for more information on specifying
1107 repositories.
Junio C Hamano1a4e8412005-12-27 08:17:231108</p>
1109</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591110<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:231111&lt;directory&gt;
1112</dt>
1113<dd>
1114<p>
1115 The name of a new directory to clone into. The "humanish"
1116 part of the source repository is used if no directory is
Junio C Hamanoc14e6ad2014-10-31 20:25:531117 explicitly given (<code>repo</code> for <code>/path/to/repo.git</code> and <code>foo</code>
1118 for <code>host.xz:foo/.git</code>). Cloning into an existing directory
Junio C Hamano89bdb3b2009-05-10 06:48:141119 is only allowed if the directory is empty.
Junio C Hamano1a4e8412005-12-27 08:17:231120</p>
1121</dd>
Junio C Hamanoba4b9282008-07-06 05:20:311122</dl></div>
Junio C Hamano1bb569e2006-05-05 23:14:251123</div>
Junio C Hamano9d971152012-12-19 00:43:111124</div>
1125<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:311126<h2 id="_git_urls_a_id_urls_a">GIT URLS<a id="URLS"></a></h2>
Junio C Hamano330aae62007-07-06 17:01:581127<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:591128<div class="paragraph"><p>In general, URLs contain information about the transport protocol, the
Junio C Hamano0c053e82010-04-19 06:46:341129address of the remote server, and the path to the repository.
1130Depending on the transport protocol, some of this information may be
1131absent.</p></div>
Junio C Hamano6631a092012-10-10 22:50:571132<div class="paragraph"><p>Git supports ssh, git, http, and https protocols (in addition, ftp,
Junio C Hamanof85ef632016-02-17 22:31:061133and ftps can be used for fetching, but this is inefficient and
1134deprecated; do not use it).</p></div>
Junio C Hamanoa1952302013-07-01 21:31:181135<div class="paragraph"><p>The native transport (i.e. git:// URL) does no authentication and
1136should be used with caution on unsecured networks.</p></div>
Junio C Hamano6631a092012-10-10 22:50:571137<div class="paragraph"><p>The following syntaxes may be used with them:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591138<div class="ulist"><ul>
Junio C Hamano330aae62007-07-06 17:01:581139<li>
1140<p>
Junio C Hamano0c053e82010-04-19 06:46:341141ssh://&#91;user@&#93;host.xz&#91;:port&#93;/path/to/repo.git/
Junio C Hamano330aae62007-07-06 17:01:581142</p>
1143</li>
1144<li>
1145<p>
Junio C Hamanoa3bb6eb2009-02-05 01:26:331146git://host.xz&#91;:port&#93;/path/to/repo.git/
Junio C Hamano330aae62007-07-06 17:01:581147</p>
1148</li>
1149<li>
1150<p>
Junio C Hamano0c053e82010-04-19 06:46:341151http&#91;s&#93;://host.xz&#91;:port&#93;/path/to/repo.git/
Junio C Hamano330aae62007-07-06 17:01:581152</p>
1153</li>
1154<li>
1155<p>
Junio C Hamano0c053e82010-04-19 06:46:341156ftp&#91;s&#93;://host.xz&#91;:port&#93;/path/to/repo.git/
Junio C Hamanodbb64592007-09-01 11:17:391157</p>
1158</li>
Junio C Hamanoba4b9282008-07-06 05:20:311159</ul></div>
Junio C Hamano68cf15a2010-11-06 01:01:591160<div class="paragraph"><p>An alternative scp-like syntax may also be used with the ssh protocol:</p></div>
1161<div class="ulist"><ul>
Junio C Hamano330aae62007-07-06 17:01:581162<li>
1163<p>
Junio C Hamano0c053e82010-04-19 06:46:341164&#91;user@&#93;host.xz:path/to/repo.git/
Junio C Hamano330aae62007-07-06 17:01:581165</p>
1166</li>
Junio C Hamanoba4b9282008-07-06 05:20:311167</ul></div>
Junio C Hamano7e590a12013-06-02 23:46:521168<div class="paragraph"><p>This syntax is only recognized if there are no slashes before the
1169first colon. This helps differentiate a local path that contains a
Junio C Hamanoc14e6ad2014-10-31 20:25:531170colon. For example the local path <code>foo:bar</code> could be specified as an
1171absolute path or <code>./foo:bar</code> to avoid being misinterpreted as an ssh
Junio C Hamano7e590a12013-06-02 23:46:521172url.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591173<div class="paragraph"><p>The ssh and git protocols additionally support ~username expansion:</p></div>
1174<div class="ulist"><ul>
Junio C Hamano0c053e82010-04-19 06:46:341175<li>
1176<p>
1177ssh://&#91;user@&#93;host.xz&#91;:port&#93;/~&#91;user&#93;/path/to/repo.git/
1178</p>
1179</li>
1180<li>
1181<p>
1182git://host.xz&#91;:port&#93;/~&#91;user&#93;/path/to/repo.git/
1183</p>
1184</li>
1185<li>
1186<p>
1187&#91;user@&#93;host.xz:/~&#91;user&#93;/path/to/repo.git/
1188</p>
1189</li>
1190</ul></div>
Junio C Hamano076ffcc2013-02-06 05:13:211191<div class="paragraph"><p>For local repositories, also supported by Git natively, the following
Junio C Hamano0c053e82010-04-19 06:46:341192syntaxes may be used:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591193<div class="ulist"><ul>
Junio C Hamano330aae62007-07-06 17:01:581194<li>
1195<p>
1196/path/to/repo.git/
1197</p>
1198</li>
Junio C Hamanob1d6e882007-08-11 08:30:161199<li>
1200<p>
Junio C Hamanodc8f8de2013-06-05 22:58:071201file:///path/to/repo.git/
Junio C Hamanob1d6e882007-08-11 08:30:161202</p>
1203</li>
Junio C Hamanoba4b9282008-07-06 05:20:311204</ul></div>
Junio C Hamano68cf15a2010-11-06 01:01:591205<div class="paragraph"><p>These two syntaxes are mostly equivalent, except the former implies
Junio C Hamano0c053e82010-04-19 06:46:341206--local option.</p></div>
Junio C Hamano076ffcc2013-02-06 05:13:211207<div class="paragraph"><p>When Git doesn&#8217;t know how to handle a certain transport protocol, it
Junio C Hamano0c053e82010-04-19 06:46:341208attempts to use the <em>remote-&lt;transport&gt;</em> remote helper, if one
1209exists. To explicitly request a remote helper, the following syntax
1210may be used:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591211<div class="ulist"><ul>
Junio C Hamano0c053e82010-04-19 06:46:341212<li>
1213<p>
1214&lt;transport&gt;::&lt;address&gt;
1215</p>
1216</li>
1217</ul></div>
Junio C Hamano68cf15a2010-11-06 01:01:591218<div class="paragraph"><p>where &lt;address&gt; may be a path, a server and path, or an arbitrary
Junio C Hamano0c053e82010-04-19 06:46:341219URL-like string recognized by the specific remote helper being
Junio C Hamanob5e079f2013-02-08 00:02:521220invoked. See <a href="gitremote-helpers.html">gitremote-helpers(1)</a> for details.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591221<div class="paragraph"><p>If there are a large number of similarly-named remote repositories and
Junio C Hamano24bc09a2008-02-28 00:27:441222you want to use a different format for them (such that the URLs you
1223use will be rewritten into URLs that work), you can create a
Junio C Hamanoba4b9282008-07-06 05:20:311224configuration section of the form:</p></div>
Junio C Hamano24bc09a2008-02-28 00:27:441225<div class="listingblock">
1226<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531227<pre><code> [url "&lt;actual url base&gt;"]
1228 insteadOf = &lt;other url base&gt;</code></pre>
Junio C Hamano24bc09a2008-02-28 00:27:441229</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591230<div class="paragraph"><p>For example, with this:</p></div>
Junio C Hamano24bc09a2008-02-28 00:27:441231<div class="listingblock">
1232<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531233<pre><code> [url "git://git.host.xz/"]
Junio C Hamano24bc09a2008-02-28 00:27:441234 insteadOf = host.xz:/path/to/
Junio C Hamanoc14e6ad2014-10-31 20:25:531235 insteadOf = work:</code></pre>
Junio C Hamano24bc09a2008-02-28 00:27:441236</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591237<div class="paragraph"><p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be
Junio C Hamanoba4b9282008-07-06 05:20:311238rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591239<div class="paragraph"><p>If you want to rewrite URLs for push only, you can create a
Junio C Hamano7df6dcf2009-09-13 09:51:171240configuration section of the form:</p></div>
1241<div class="listingblock">
1242<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531243<pre><code> [url "&lt;actual url base&gt;"]
1244 pushInsteadOf = &lt;other url base&gt;</code></pre>
Junio C Hamano7df6dcf2009-09-13 09:51:171245</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591246<div class="paragraph"><p>For example, with this:</p></div>
Junio C Hamano7df6dcf2009-09-13 09:51:171247<div class="listingblock">
1248<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531249<pre><code> [url "ssh://example.org/"]
1250 pushInsteadOf = git://example.org/</code></pre>
Junio C Hamano7df6dcf2009-09-13 09:51:171251</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591252<div class="paragraph"><p>a URL like "git://example.org/path/to/repo.git" will be rewritten to
Junio C Hamano7df6dcf2009-09-13 09:51:171253"ssh://example.org/path/to/repo.git" for pushes, but pulls will still
1254use the original URL.</p></div>
Junio C Hamano330aae62007-07-06 17:01:581255</div>
Junio C Hamano9d971152012-12-19 00:43:111256</div>
1257<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:311258<h2 id="_examples">Examples</h2>
Junio C Hamano1bb569e2006-05-05 23:14:251259<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:591260<div class="ulist"><ul>
Junio C Hamano9ccf6642010-03-22 01:47:351261<li>
1262<p>
1263Clone from upstream:
1264</p>
Junio C Hamano1a4e8412005-12-27 08:17:231265<div class="listingblock">
1266<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531267<pre><code>$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux
Junio C Hamanoa1952302013-07-01 21:31:181268$ cd my-linux
Junio C Hamanoc14e6ad2014-10-31 20:25:531269$ make</code></pre>
Junio C Hamano1a4e8412005-12-27 08:17:231270</div></div>
Junio C Hamano9ccf6642010-03-22 01:47:351271</li>
1272<li>
1273<p>
1274Make a local clone that borrows from the current directory, without checking things out:
1275</p>
Junio C Hamano1a4e8412005-12-27 08:17:231276<div class="listingblock">
1277<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531278<pre><code>$ git clone -l -s -n . ../copy
Junio C Hamano8638c922007-05-12 20:50:081279$ cd ../copy
Junio C Hamanoc14e6ad2014-10-31 20:25:531280$ git show-branch</code></pre>
Junio C Hamano1a4e8412005-12-27 08:17:231281</div></div>
Junio C Hamano9ccf6642010-03-22 01:47:351282</li>
1283<li>
1284<p>
1285Clone from upstream while borrowing from an existing local directory:
1286</p>
Junio C Hamanof50bfec2006-04-19 09:44:121287<div class="listingblock">
1288<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531289<pre><code>$ git clone --reference /git/linux.git \
Junio C Hamanoa1952302013-07-01 21:31:181290 git://git.kernel.org/pub/scm/.../linux.git \
1291 my-linux
Junio C Hamanoc14e6ad2014-10-31 20:25:531292$ cd my-linux</code></pre>
Junio C Hamanof50bfec2006-04-19 09:44:121293</div></div>
Junio C Hamano9ccf6642010-03-22 01:47:351294</li>
1295<li>
1296<p>
1297Create a bare repository to publish your changes to the public:
1298</p>
Junio C Hamano38064d52006-01-15 10:13:491299<div class="listingblock">
1300<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531301<pre><code>$ git clone --bare -l /home/proj/.git /pub/scm/proj.git</code></pre>
Junio C Hamano38064d52006-01-15 10:13:491302</div></div>
Junio C Hamano9ccf6642010-03-22 01:47:351303</li>
Junio C Hamano9ccf6642010-03-22 01:47:351304</ul></div>
Junio C Hamano1a4e8412005-12-27 08:17:231305</div>
Junio C Hamano9d971152012-12-19 00:43:111306</div>
1307<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:311308<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:231309<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:231310<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:231311</div>
Junio C Hamano7bd050f2011-09-22 06:32:221312</div>
Junio C Hamano9d971152012-12-19 00:43:111313</div>
Junio C Hamano7bd050f2011-09-22 06:32:221314<div id="footnotes"><hr /></div>
Junio C Hamano1a4e8412005-12-27 08:17:231315<div id="footer">
1316<div id="footer-text">
Junio C Hamanoc6c919b2016-07-06 21:34:151317Last updated 2016-07-06 14:33:48 PDT
Junio C Hamano1a4e8412005-12-27 08:17:231318</div>
1319</div>
1320</body>
1321</html>