"Fossies" - the Fresh Open Source Software Archive

Member "git-clone.html" (15 Dec 2018, 38153 Bytes) of package /linux/misc/git-htmldocs-2.20.1.tar.xz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) HTML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <?xml version="1.0" encoding="UTF-8"?>
    2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    3     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
    4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
    5 <head>
    6 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
    7 <meta name="generator" content="AsciiDoc 8.6.10" />
    8 <title>git-clone(1)</title>
    9 <style type="text/css">
   10 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
   11 
   12 /* Default font. */
   13 body {
   14   font-family: Georgia,serif;
   15 }
   16 
   17 /* Title font. */
   18 h1, h2, h3, h4, h5, h6,
   19 div.title, caption.title,
   20 thead, p.table.header,
   21 #toctitle,
   22 #author, #revnumber, #revdate, #revremark,
   23 #footer {
   24   font-family: Arial,Helvetica,sans-serif;
   25 }
   26 
   27 body {
   28   margin: 1em 5% 1em 5%;
   29 }
   30 
   31 a {
   32   color: blue;
   33   text-decoration: underline;
   34 }
   35 a:visited {
   36   color: fuchsia;
   37 }
   38 
   39 em {
   40   font-style: italic;
   41   color: navy;
   42 }
   43 
   44 strong {
   45   font-weight: bold;
   46   color: #083194;
   47 }
   48 
   49 h1, h2, h3, h4, h5, h6 {
   50   color: #527bbd;
   51   margin-top: 1.2em;
   52   margin-bottom: 0.5em;
   53   line-height: 1.3;
   54 }
   55 
   56 h1, h2, h3 {
   57   border-bottom: 2px solid silver;
   58 }
   59 h2 {
   60   padding-top: 0.5em;
   61 }
   62 h3 {
   63   float: left;
   64 }
   65 h3 + * {
   66   clear: left;
   67 }
   68 h5 {
   69   font-size: 1.0em;
   70 }
   71 
   72 div.sectionbody {
   73   margin-left: 0;
   74 }
   75 
   76 hr {
   77   border: 1px solid silver;
   78 }
   79 
   80 p {
   81   margin-top: 0.5em;
   82   margin-bottom: 0.5em;
   83 }
   84 
   85 ul, ol, li > p {
   86   margin-top: 0;
   87 }
   88 ul > li     { color: #aaa; }
   89 ul > li > * { color: black; }
   90 
   91 .monospaced, code, pre {
   92   font-family: "Courier New", Courier, monospace;
   93   font-size: inherit;
   94   color: navy;
   95   padding: 0;
   96   margin: 0;
   97 }
   98 pre {
   99   white-space: pre-wrap;
  100 }
  101 
  102 #author {
  103   color: #527bbd;
  104   font-weight: bold;
  105   font-size: 1.1em;
  106 }
  107 #email {
  108 }
  109 #revnumber, #revdate, #revremark {
  110 }
  111 
  112 #footer {
  113   font-size: small;
  114   border-top: 2px solid silver;
  115   padding-top: 0.5em;
  116   margin-top: 4.0em;
  117 }
  118 #footer-text {
  119   float: left;
  120   padding-bottom: 0.5em;
  121 }
  122 #footer-badges {
  123   float: right;
  124   padding-bottom: 0.5em;
  125 }
  126 
  127 #preamble {
  128   margin-top: 1.5em;
  129   margin-bottom: 1.5em;
  130 }
  131 div.imageblock, div.exampleblock, div.verseblock,
  132 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
  133 div.admonitionblock {
  134   margin-top: 1.0em;
  135   margin-bottom: 1.5em;
  136 }
  137 div.admonitionblock {
  138   margin-top: 2.0em;
  139   margin-bottom: 2.0em;
  140   margin-right: 10%;
  141   color: #606060;
  142 }
  143 
  144 div.content { /* Block element content. */
  145   padding: 0;
  146 }
  147 
  148 /* Block element titles. */
  149 div.title, caption.title {
  150   color: #527bbd;
  151   font-weight: bold;
  152   text-align: left;
  153   margin-top: 1.0em;
  154   margin-bottom: 0.5em;
  155 }
  156 div.title + * {
  157   margin-top: 0;
  158 }
  159 
  160 td div.title:first-child {
  161   margin-top: 0.0em;
  162 }
  163 div.content div.title:first-child {
  164   margin-top: 0.0em;
  165 }
  166 div.content + div.title {
  167   margin-top: 0.0em;
  168 }
  169 
  170 div.sidebarblock > div.content {
  171   background: #ffffee;
  172   border: 1px solid #dddddd;
  173   border-left: 4px solid #f0f0f0;
  174   padding: 0.5em;
  175 }
  176 
  177 div.listingblock > div.content {
  178   border: 1px solid #dddddd;
  179   border-left: 5px solid #f0f0f0;
  180   background: #f8f8f8;
  181   padding: 0.5em;
  182 }
  183 
  184 div.quoteblock, div.verseblock {
  185   padding-left: 1.0em;
  186   margin-left: 1.0em;
  187   margin-right: 10%;
  188   border-left: 5px solid #f0f0f0;
  189   color: #888;
  190 }
  191 
  192 div.quoteblock > div.attribution {
  193   padding-top: 0.5em;
  194   text-align: right;
  195 }
  196 
  197 div.verseblock > pre.content {
  198   font-family: inherit;
  199   font-size: inherit;
  200 }
  201 div.verseblock > div.attribution {
  202   padding-top: 0.75em;
  203   text-align: left;
  204 }
  205 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
  206 div.verseblock + div.attribution {
  207   text-align: left;
  208 }
  209 
  210 div.admonitionblock .icon {
  211   vertical-align: top;
  212   font-size: 1.1em;
  213   font-weight: bold;
  214   text-decoration: underline;
  215   color: #527bbd;
  216   padding-right: 0.5em;
  217 }
  218 div.admonitionblock td.content {
  219   padding-left: 0.5em;
  220   border-left: 3px solid #dddddd;
  221 }
  222 
  223 div.exampleblock > div.content {
  224   border-left: 3px solid #dddddd;
  225   padding-left: 0.5em;
  226 }
  227 
  228 div.imageblock div.content { padding-left: 0; }
  229 span.image img { border-style: none; vertical-align: text-bottom; }
  230 a.image:visited { color: white; }
  231 
  232 dl {
  233   margin-top: 0.8em;
  234   margin-bottom: 0.8em;
  235 }
  236 dt {
  237   margin-top: 0.5em;
  238   margin-bottom: 0;
  239   font-style: normal;
  240   color: navy;
  241 }
  242 dd > *:first-child {
  243   margin-top: 0.1em;
  244 }
  245 
  246 ul, ol {
  247     list-style-position: outside;
  248 }
  249 ol.arabic {
  250   list-style-type: decimal;
  251 }
  252 ol.loweralpha {
  253   list-style-type: lower-alpha;
  254 }
  255 ol.upperalpha {
  256   list-style-type: upper-alpha;
  257 }
  258 ol.lowerroman {
  259   list-style-type: lower-roman;
  260 }
  261 ol.upperroman {
  262   list-style-type: upper-roman;
  263 }
  264 
  265 div.compact ul, div.compact ol,
  266 div.compact p, div.compact p,
  267 div.compact div, div.compact div {
  268   margin-top: 0.1em;
  269   margin-bottom: 0.1em;
  270 }
  271 
  272 tfoot {
  273   font-weight: bold;
  274 }
  275 td > div.verse {
  276   white-space: pre;
  277 }
  278 
  279 div.hdlist {
  280   margin-top: 0.8em;
  281   margin-bottom: 0.8em;
  282 }
  283 div.hdlist tr {
  284   padding-bottom: 15px;
  285 }
  286 dt.hdlist1.strong, td.hdlist1.strong {
  287   font-weight: bold;
  288 }
  289 td.hdlist1 {
  290   vertical-align: top;
  291   font-style: normal;
  292   padding-right: 0.8em;
  293   color: navy;
  294 }
  295 td.hdlist2 {
  296   vertical-align: top;
  297 }
  298 div.hdlist.compact tr {
  299   margin: 0;
  300   padding-bottom: 0;
  301 }
  302 
  303 .comment {
  304   background: yellow;
  305 }
  306 
  307 .footnote, .footnoteref {
  308   font-size: 0.8em;
  309 }
  310 
  311 span.footnote, span.footnoteref {
  312   vertical-align: super;
  313 }
  314 
  315 #footnotes {
  316   margin: 20px 0 20px 0;
  317   padding: 7px 0 0 0;
  318 }
  319 
  320 #footnotes div.footnote {
  321   margin: 0 0 5px 0;
  322 }
  323 
  324 #footnotes hr {
  325   border: none;
  326   border-top: 1px solid silver;
  327   height: 1px;
  328   text-align: left;
  329   margin-left: 0;
  330   width: 20%;
  331   min-width: 100px;
  332 }
  333 
  334 div.colist td {
  335   padding-right: 0.5em;
  336   padding-bottom: 0.3em;
  337   vertical-align: top;
  338 }
  339 div.colist td img {
  340   margin-top: 0.3em;
  341 }
  342 
  343 @media print {
  344   #footer-badges { display: none; }
  345 }
  346 
  347 #toc {
  348   margin-bottom: 2.5em;
  349 }
  350 
  351 #toctitle {
  352   color: #527bbd;
  353   font-size: 1.1em;
  354   font-weight: bold;
  355   margin-top: 1.0em;
  356   margin-bottom: 0.1em;
  357 }
  358 
  359 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  360   margin-top: 0;
  361   margin-bottom: 0;
  362 }
  363 div.toclevel2 {
  364   margin-left: 2em;
  365   font-size: 0.9em;
  366 }
  367 div.toclevel3 {
  368   margin-left: 4em;
  369   font-size: 0.9em;
  370 }
  371 div.toclevel4 {
  372   margin-left: 6em;
  373   font-size: 0.9em;
  374 }
  375 
  376 span.aqua { color: aqua; }
  377 span.black { color: black; }
  378 span.blue { color: blue; }
  379 span.fuchsia { color: fuchsia; }
  380 span.gray { color: gray; }
  381 span.green { color: green; }
  382 span.lime { color: lime; }
  383 span.maroon { color: maroon; }
  384 span.navy { color: navy; }
  385 span.olive { color: olive; }
  386 span.purple { color: purple; }
  387 span.red { color: red; }
  388 span.silver { color: silver; }
  389 span.teal { color: teal; }
  390 span.white { color: white; }
  391 span.yellow { color: yellow; }
  392 
  393 span.aqua-background { background: aqua; }
  394 span.black-background { background: black; }
  395 span.blue-background { background: blue; }
  396 span.fuchsia-background { background: fuchsia; }
  397 span.gray-background { background: gray; }
  398 span.green-background { background: green; }
  399 span.lime-background { background: lime; }
  400 span.maroon-background { background: maroon; }
  401 span.navy-background { background: navy; }
  402 span.olive-background { background: olive; }
  403 span.purple-background { background: purple; }
  404 span.red-background { background: red; }
  405 span.silver-background { background: silver; }
  406 span.teal-background { background: teal; }
  407 span.white-background { background: white; }
  408 span.yellow-background { background: yellow; }
  409 
  410 span.big { font-size: 2em; }
  411 span.small { font-size: 0.6em; }
  412 
  413 span.underline { text-decoration: underline; }
  414 span.overline { text-decoration: overline; }
  415 span.line-through { text-decoration: line-through; }
  416 
  417 div.unbreakable { page-break-inside: avoid; }
  418 
  419 
  420 /*
  421  * xhtml11 specific
  422  *
  423  * */
  424 
  425 div.tableblock {
  426   margin-top: 1.0em;
  427   margin-bottom: 1.5em;
  428 }
  429 div.tableblock > table {
  430   border: 3px solid #527bbd;
  431 }
  432 thead, p.table.header {
  433   font-weight: bold;
  434   color: #527bbd;
  435 }
  436 p.table {
  437   margin-top: 0;
  438 }
  439 /* Because the table frame attribute is overriden by CSS in most browsers. */
  440 div.tableblock > table[frame="void"] {
  441   border-style: none;
  442 }
  443 div.tableblock > table[frame="hsides"] {
  444   border-left-style: none;
  445   border-right-style: none;
  446 }
  447 div.tableblock > table[frame="vsides"] {
  448   border-top-style: none;
  449   border-bottom-style: none;
  450 }
  451 
  452 
  453 /*
  454  * html5 specific
  455  *
  456  * */
  457 
  458 table.tableblock {
  459   margin-top: 1.0em;
  460   margin-bottom: 1.5em;
  461 }
  462 thead, p.tableblock.header {
  463   font-weight: bold;
  464   color: #527bbd;
  465 }
  466 p.tableblock {
  467   margin-top: 0;
  468 }
  469 table.tableblock {
  470   border-width: 3px;
  471   border-spacing: 0px;
  472   border-style: solid;
  473   border-color: #527bbd;
  474   border-collapse: collapse;
  475 }
  476 th.tableblock, td.tableblock {
  477   border-width: 1px;
  478   padding: 4px;
  479   border-style: solid;
  480   border-color: #527bbd;
  481 }
  482 
  483 table.tableblock.frame-topbot {
  484   border-left-style: hidden;
  485   border-right-style: hidden;
  486 }
  487 table.tableblock.frame-sides {
  488   border-top-style: hidden;
  489   border-bottom-style: hidden;
  490 }
  491 table.tableblock.frame-none {
  492   border-style: hidden;
  493 }
  494 
  495 th.tableblock.halign-left, td.tableblock.halign-left {
  496   text-align: left;
  497 }
  498 th.tableblock.halign-center, td.tableblock.halign-center {
  499   text-align: center;
  500 }
  501 th.tableblock.halign-right, td.tableblock.halign-right {
  502   text-align: right;
  503 }
  504 
  505 th.tableblock.valign-top, td.tableblock.valign-top {
  506   vertical-align: top;
  507 }
  508 th.tableblock.valign-middle, td.tableblock.valign-middle {
  509   vertical-align: middle;
  510 }
  511 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
  512   vertical-align: bottom;
  513 }
  514 
  515 
  516 /*
  517  * manpage specific
  518  *
  519  * */
  520 
  521 body.manpage h1 {
  522   padding-top: 0.5em;
  523   padding-bottom: 0.5em;
  524   border-top: 2px solid silver;
  525   border-bottom: 2px solid silver;
  526 }
  527 body.manpage h2 {
  528   border-style: none;
  529 }
  530 body.manpage div.sectionbody {
  531   margin-left: 3em;
  532 }
  533 
  534 @media print {
  535   body.manpage div#toc { display: none; }
  536 }
  537 
  538 
  539 </style>
  540 <script type="text/javascript">
  541 /*<![CDATA[*/
  542 var asciidoc = {  // Namespace.
  543 
  544 /////////////////////////////////////////////////////////////////////
  545 // Table Of Contents generator
  546 /////////////////////////////////////////////////////////////////////
  547 
  548 /* Author: Mihai Bazon, September 2002
  549  * http://students.infoiasi.ro/~mishoo
  550  *
  551  * Table Of Content generator
  552  * Version: 0.4
  553  *
  554  * Feel free to use this script under the terms of the GNU General Public
  555  * License, as long as you do not remove or alter this notice.
  556  */
  557 
  558  /* modified by Troy D. Hanson, September 2006. License: GPL */
  559  /* modified by Stuart Rackham, 2006, 2009. License: GPL */
  560 
  561 // toclevels = 1..4.
  562 toc: function (toclevels) {
  563 
  564   function getText(el) {
  565     var text = "";
  566     for (var i = el.firstChild; i != null; i = i.nextSibling) {
  567       if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
  568         text += i.data;
  569       else if (i.firstChild != null)
  570         text += getText(i);
  571     }
  572     return text;
  573   }
  574 
  575   function TocEntry(el, text, toclevel) {
  576     this.element = el;
  577     this.text = text;
  578     this.toclevel = toclevel;
  579   }
  580 
  581   function tocEntries(el, toclevels) {
  582     var result = new Array;
  583     var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
  584     // Function that scans the DOM tree for header elements (the DOM2
  585     // nodeIterator API would be a better technique but not supported by all
  586     // browsers).
  587     var iterate = function (el) {
  588       for (var i = el.firstChild; i != null; i = i.nextSibling) {
  589         if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
  590           var mo = re.exec(i.tagName);
  591           if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
  592             result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
  593           }
  594           iterate(i);
  595         }
  596       }
  597     }
  598     iterate(el);
  599     return result;
  600   }
  601 
  602   var toc = document.getElementById("toc");
  603   if (!toc) {
  604     return;
  605   }
  606 
  607   // Delete existing TOC entries in case we're reloading the TOC.
  608   var tocEntriesToRemove = [];
  609   var i;
  610   for (i = 0; i < toc.childNodes.length; i++) {
  611     var entry = toc.childNodes[i];
  612     if (entry.nodeName.toLowerCase() == 'div'
  613      && entry.getAttribute("class")
  614      && entry.getAttribute("class").match(/^toclevel/))
  615       tocEntriesToRemove.push(entry);
  616   }
  617   for (i = 0; i < tocEntriesToRemove.length; i++) {
  618     toc.removeChild(tocEntriesToRemove[i]);
  619   }
  620 
  621   // Rebuild TOC entries.
  622   var entries = tocEntries(document.getElementById("content"), toclevels);
  623   for (var i = 0; i < entries.length; ++i) {
  624     var entry = entries[i];
  625     if (entry.element.id == "")
  626       entry.element.id = "_toc_" + i;
  627     var a = document.createElement("a");
  628     a.href = "#" + entry.element.id;
  629     a.appendChild(document.createTextNode(entry.text));
  630     var div = document.createElement("div");
  631     div.appendChild(a);
  632     div.className = "toclevel" + entry.toclevel;
  633     toc.appendChild(div);
  634   }
  635   if (entries.length == 0)
  636     toc.parentNode.removeChild(toc);
  637 },
  638 
  639 
  640 /////////////////////////////////////////////////////////////////////
  641 // Footnotes generator
  642 /////////////////////////////////////////////////////////////////////
  643 
  644 /* Based on footnote generation code from:
  645  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
  646  */
  647 
  648 footnotes: function () {
  649   // Delete existing footnote entries in case we're reloading the footnodes.
  650   var i;
  651   var noteholder = document.getElementById("footnotes");
  652   if (!noteholder) {
  653     return;
  654   }
  655   var entriesToRemove = [];
  656   for (i = 0; i < noteholder.childNodes.length; i++) {
  657     var entry = noteholder.childNodes[i];
  658     if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
  659       entriesToRemove.push(entry);
  660   }
  661   for (i = 0; i < entriesToRemove.length; i++) {
  662     noteholder.removeChild(entriesToRemove[i]);
  663   }
  664 
  665   // Rebuild footnote entries.
  666   var cont = document.getElementById("content");
  667   var spans = cont.getElementsByTagName("span");
  668   var refs = {};
  669   var n = 0;
  670   for (i=0; i<spans.length; i++) {
  671     if (spans[i].className == "footnote") {
  672       n++;
  673       var note = spans[i].getAttribute("data-note");
  674       if (!note) {
  675         // Use [\s\S] in place of . so multi-line matches work.
  676         // Because JavaScript has no s (dotall) regex flag.
  677         note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
  678         spans[i].innerHTML =
  679           "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
  680           "' title='View footnote' class='footnote'>" + n + "</a>]";
  681         spans[i].setAttribute("data-note", note);
  682       }
  683       noteholder.innerHTML +=
  684         "<div class='footnote' id='_footnote_" + n + "'>" +
  685         "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
  686         n + "</a>. " + note + "</div>";
  687       var id =spans[i].getAttribute("id");
  688       if (id != null) refs["#"+id] = n;
  689     }
  690   }
  691   if (n == 0)
  692     noteholder.parentNode.removeChild(noteholder);
  693   else {
  694     // Process footnoterefs.
  695     for (i=0; i<spans.length; i++) {
  696       if (spans[i].className == "footnoteref") {
  697         var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
  698         href = href.match(/#.*/)[0];  // Because IE return full URL.
  699         n = refs[href];
  700         spans[i].innerHTML =
  701           "[<a href='#_footnote_" + n +
  702           "' title='View footnote' class='footnote'>" + n + "</a>]";
  703       }
  704     }
  705   }
  706 },
  707 
  708 install: function(toclevels) {
  709   var timerId;
  710 
  711   function reinstall() {
  712     asciidoc.footnotes();
  713     if (toclevels) {
  714       asciidoc.toc(toclevels);
  715     }
  716   }
  717 
  718   function reinstallAndRemoveTimer() {
  719     clearInterval(timerId);
  720     reinstall();
  721   }
  722 
  723   timerId = setInterval(reinstall, 500);
  724   if (document.addEventListener)
  725     document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
  726   else
  727     window.onload = reinstallAndRemoveTimer;
  728 }
  729 
  730 }
  731 asciidoc.install();
  732 /*]]>*/
  733 </script>
  734 </head>
  735 <body class="manpage">
  736 <div id="header">
  737 <h1>
  738 git-clone(1) Manual Page
  739 </h1>
  740 <h2>NAME</h2>
  741 <div class="sectionbody">
  742 <p>git-clone -
  743    Clone a repository into a new directory
  744 </p>
  745 </div>
  746 </div>
  747 <div id="content">
  748 <div class="sect1">
  749 <h2 id="_synopsis">SYNOPSIS</h2>
  750 <div class="sectionbody">
  751 <div class="verseblock">
  752 <pre class="content"><em>git clone</em> [--template=&lt;template_directory&gt;]
  753           [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror]
  754           [-o &lt;name&gt;] [-b &lt;name&gt;] [-u &lt;upload-pack&gt;] [--reference &lt;repository&gt;]
  755           [--dissociate] [--separate-git-dir &lt;git dir&gt;]
  756           [--depth &lt;depth&gt;] [--[no-]single-branch] [--no-tags]
  757           [--recurse-submodules[=&lt;pathspec&gt;]] [--[no-]shallow-submodules]
  758           [--jobs &lt;n&gt;] [--] &lt;repository&gt; [&lt;directory&gt;]</pre>
  759 <div class="attribution">
  760 </div></div>
  761 </div>
  762 </div>
  763 <div class="sect1">
  764 <h2 id="_description">DESCRIPTION</h2>
  765 <div class="sectionbody">
  766 <div class="paragraph"><p>Clones a repository into a newly created directory, creates
  767 remote-tracking branches for each branch in the cloned repository
  768 (visible using <code>git branch -r</code>), and creates and checks out an
  769 initial branch that is forked from the cloned repository&#8217;s
  770 currently active branch.</p></div>
  771 <div class="paragraph"><p>After the clone, a plain <code>git fetch</code> without arguments will update
  772 all the remote-tracking branches, and a <code>git pull</code> without
  773 arguments will in addition merge the remote master branch into the
  774 current master branch, if any (this is untrue when "--single-branch"
  775 is given; see below).</p></div>
  776 <div class="paragraph"><p>This default configuration is achieved by creating references to
  777 the remote branch heads under <code>refs/remotes/origin</code> and
  778 by initializing <code>remote.origin.url</code> and <code>remote.origin.fetch</code>
  779 configuration variables.</p></div>
  780 </div>
  781 </div>
  782 <div class="sect1">
  783 <h2 id="_options">OPTIONS</h2>
  784 <div class="sectionbody">
  785 <div class="dlist"><dl>
  786 <dt class="hdlist1">
  787 --local
  788 </dt>
  789 <dt class="hdlist1">
  790 -l
  791 </dt>
  792 <dd>
  793 <p>
  794         When the repository to clone from is on a local machine,
  795         this flag bypasses the normal "Git aware" transport
  796         mechanism and clones the repository by making a copy of
  797         HEAD and everything under objects and refs directories.
  798         The files under <code>.git/objects/</code> directory are hardlinked
  799         to save space when possible.
  800 </p>
  801 <div class="paragraph"><p>If the repository is specified as a local path (e.g., <code>/path/to/repo</code>),
  802 this is the default, and --local is essentially a no-op.  If the
  803 repository is specified as a URL, then this flag is ignored (and we
  804 never use the local optimizations).  Specifying <code>--no-local</code> will
  805 override the default when <code>/path/to/repo</code> is given, using the regular
  806 Git transport instead.</p></div>
  807 </dd>
  808 <dt class="hdlist1">
  809 --no-hardlinks
  810 </dt>
  811 <dd>
  812 <p>
  813         Force the cloning process from a repository on a local
  814         filesystem to copy the files under the <code>.git/objects</code>
  815         directory instead of using hardlinks. This may be desirable
  816         if you are trying to make a back-up of your repository.
  817 </p>
  818 </dd>
  819 <dt class="hdlist1">
  820 --shared
  821 </dt>
  822 <dt class="hdlist1">
  823 -s
  824 </dt>
  825 <dd>
  826 <p>
  827         When the repository to clone is on the local machine,
  828         instead of using hard links, automatically setup
  829         <code>.git/objects/info/alternates</code> to share the objects
  830         with the source repository.  The resulting repository
  831         starts out without any object of its own.
  832 </p>
  833 <div class="paragraph"><p><strong>NOTE</strong>: this is a possibly dangerous operation; do <strong>not</strong> use
  834 it unless you understand what it does. If you clone your
  835 repository using this option and then delete branches (or use any
  836 other Git command that makes any existing commit unreferenced) in the
  837 source repository, some objects may become unreferenced (or dangling).
  838 These objects may be removed by normal Git operations (such as <code>git commit</code>)
  839 which automatically call <code>git gc --auto</code>. (See <a href="git-gc.html">git-gc(1)</a>.)
  840 If these objects are removed and were referenced by the cloned repository,
  841 then the cloned repository will become corrupt.</p></div>
  842 <div class="paragraph"><p>Note that running <code>git repack</code> without the <code>-l</code> option in a repository
  843 cloned with <code>-s</code> will copy objects from the source repository into a pack
  844 in the cloned repository, removing the disk space savings of <code>clone -s</code>.
  845 It is safe, however, to run <code>git gc</code>, which uses the <code>-l</code> option by
  846 default.</p></div>
  847 <div class="paragraph"><p>If you want to break the dependency of a repository cloned with <code>-s</code> on
  848 its source repository, you can simply run <code>git repack -a</code> to copy all
  849 objects from the source repository into a pack in the cloned repository.</p></div>
  850 </dd>
  851 <dt class="hdlist1">
  852 --reference[-if-able] &lt;repository&gt;
  853 </dt>
  854 <dd>
  855 <p>
  856         If the reference repository is on the local machine,
  857         automatically setup <code>.git/objects/info/alternates</code> to
  858         obtain objects from the reference repository.  Using
  859         an already existing repository as an alternate will
  860         require fewer objects to be copied from the repository
  861         being cloned, reducing network and local storage costs.
  862         When using the <code>--reference-if-able</code>, a non existing
  863         directory is skipped with a warning instead of aborting
  864         the clone.
  865 </p>
  866 <div class="paragraph"><p><strong>NOTE</strong>: see the NOTE for the <code>--shared</code> option, and also the
  867 <code>--dissociate</code> option.</p></div>
  868 </dd>
  869 <dt class="hdlist1">
  870 --dissociate
  871 </dt>
  872 <dd>
  873 <p>
  874         Borrow the objects from reference repositories specified
  875         with the <code>--reference</code> options only to reduce network
  876         transfer, and stop borrowing from them after a clone is made
  877         by making necessary local copies of borrowed objects.  This
  878         option can also be used when cloning locally from a
  879         repository that already borrows objects from another
  880         repository&#8212;the new repository will borrow objects from the
  881         same repository, and this option can be used to stop the
  882         borrowing.
  883 </p>
  884 </dd>
  885 <dt class="hdlist1">
  886 --quiet
  887 </dt>
  888 <dt class="hdlist1">
  889 -q
  890 </dt>
  891 <dd>
  892 <p>
  893         Operate quietly.  Progress is not reported to the standard
  894         error stream.
  895 </p>
  896 </dd>
  897 <dt class="hdlist1">
  898 --verbose
  899 </dt>
  900 <dt class="hdlist1">
  901 -v
  902 </dt>
  903 <dd>
  904 <p>
  905         Run verbosely. Does not affect the reporting of progress status
  906         to the standard error stream.
  907 </p>
  908 </dd>
  909 <dt class="hdlist1">
  910 --progress
  911 </dt>
  912 <dd>
  913 <p>
  914         Progress status is reported on the standard error stream
  915         by default when it is attached to a terminal, unless -q
  916         is specified. This flag forces progress status even if the
  917         standard error stream is not directed to a terminal.
  918 </p>
  919 </dd>
  920 <dt class="hdlist1">
  921 --no-checkout
  922 </dt>
  923 <dt class="hdlist1">
  924 -n
  925 </dt>
  926 <dd>
  927 <p>
  928         No checkout of HEAD is performed after the clone is complete.
  929 </p>
  930 </dd>
  931 <dt class="hdlist1">
  932 --bare
  933 </dt>
  934 <dd>
  935 <p>
  936         Make a <em>bare</em> Git repository.  That is, instead of
  937         creating <code>&lt;directory&gt;</code> and placing the administrative
  938         files in <code>&lt;directory&gt;/.git</code>, make the <code>&lt;directory&gt;</code>
  939         itself the <code>$GIT_DIR</code>. This obviously implies the <code>-n</code>
  940         because there is nowhere to check out the working tree.
  941         Also the branch heads at the remote are copied directly
  942         to corresponding local branch heads, without mapping
  943         them to <code>refs/remotes/origin/</code>.  When this option is
  944         used, neither remote-tracking branches nor the related
  945         configuration variables are created.
  946 </p>
  947 </dd>
  948 <dt class="hdlist1">
  949 --mirror
  950 </dt>
  951 <dd>
  952 <p>
  953         Set up a mirror of the source repository.  This implies <code>--bare</code>.
  954         Compared to <code>--bare</code>, <code>--mirror</code> not only maps local branches of the
  955         source to local branches of the target, it maps all refs (including
  956         remote-tracking branches, notes etc.) and sets up a refspec configuration such
  957         that all these refs are overwritten by a <code>git remote update</code> in the
  958         target repository.
  959 </p>
  960 </dd>
  961 <dt class="hdlist1">
  962 --origin &lt;name&gt;
  963 </dt>
  964 <dt class="hdlist1">
  965 -o &lt;name&gt;
  966 </dt>
  967 <dd>
  968 <p>
  969         Instead of using the remote name <code>origin</code> to keep track
  970         of the upstream repository, use <code>&lt;name&gt;</code>.
  971 </p>
  972 </dd>
  973 <dt class="hdlist1">
  974 --branch &lt;name&gt;
  975 </dt>
  976 <dt class="hdlist1">
  977 -b &lt;name&gt;
  978 </dt>
  979 <dd>
  980 <p>
  981         Instead of pointing the newly created HEAD to the branch pointed
  982         to by the cloned repository&#8217;s HEAD, point to <code>&lt;name&gt;</code> branch
  983         instead. In a non-bare repository, this is the branch that will
  984         be checked out.
  985         <code>--branch</code> can also take tags and detaches the HEAD at that commit
  986         in the resulting repository.
  987 </p>
  988 </dd>
  989 <dt class="hdlist1">
  990 --upload-pack &lt;upload-pack&gt;
  991 </dt>
  992 <dt class="hdlist1">
  993 -u &lt;upload-pack&gt;
  994 </dt>
  995 <dd>
  996 <p>
  997         When given, and the repository to clone from is accessed
  998         via ssh, this specifies a non-default path for the command
  999         run on the other end.
 1000 </p>
 1001 </dd>
 1002 <dt class="hdlist1">
 1003 --template=&lt;template_directory&gt;
 1004 </dt>
 1005 <dd>
 1006 <p>
 1007         Specify the directory from which templates will be used;
 1008         (See the "TEMPLATE DIRECTORY" section of <a href="git-init.html">git-init(1)</a>.)
 1009 </p>
 1010 </dd>
 1011 <dt class="hdlist1">
 1012 --config &lt;key&gt;=&lt;value&gt;
 1013 </dt>
 1014 <dt class="hdlist1">
 1015 -c &lt;key&gt;=&lt;value&gt;
 1016 </dt>
 1017 <dd>
 1018 <p>
 1019         Set a configuration variable in the newly-created repository;
 1020         this takes effect immediately after the repository is
 1021         initialized, but before the remote history is fetched or any
 1022         files checked out.  The key is in the same format as expected by
 1023         <a href="git-config.html">git-config(1)</a> (e.g., <code>core.eol=true</code>). If multiple
 1024         values are given for the same key, each value will be written to
 1025         the config file. This makes it safe, for example, to add
 1026         additional fetch refspecs to the origin remote.
 1027 </p>
 1028 </dd>
 1029 <dt class="hdlist1">
 1030 --depth &lt;depth&gt;
 1031 </dt>
 1032 <dd>
 1033 <p>
 1034         Create a <em>shallow</em> clone with a history truncated to the
 1035         specified number of commits. Implies <code>--single-branch</code> unless
 1036         <code>--no-single-branch</code> is given to fetch the histories near the
 1037         tips of all branches. If you want to clone submodules shallowly,
 1038         also pass <code>--shallow-submodules</code>.
 1039 </p>
 1040 </dd>
 1041 <dt class="hdlist1">
 1042 --shallow-since=&lt;date&gt;
 1043 </dt>
 1044 <dd>
 1045 <p>
 1046         Create a shallow clone with a history after the specified time.
 1047 </p>
 1048 </dd>
 1049 <dt class="hdlist1">
 1050 --shallow-exclude=&lt;revision&gt;
 1051 </dt>
 1052 <dd>
 1053 <p>
 1054         Create a shallow clone with a history, excluding commits
 1055         reachable from a specified remote branch or tag.  This option
 1056         can be specified multiple times.
 1057 </p>
 1058 </dd>
 1059 <dt class="hdlist1">
 1060 --[no-]single-branch
 1061 </dt>
 1062 <dd>
 1063 <p>
 1064         Clone only the history leading to the tip of a single branch,
 1065         either specified by the <code>--branch</code> option or the primary
 1066         branch remote&#8217;s <code>HEAD</code> points at.
 1067         Further fetches into the resulting repository will only update the
 1068         remote-tracking branch for the branch this option was used for the
 1069         initial cloning.  If the HEAD at the remote did not point at any
 1070         branch when <code>--single-branch</code> clone was made, no remote-tracking
 1071         branch is created.
 1072 </p>
 1073 </dd>
 1074 <dt class="hdlist1">
 1075 --no-tags
 1076 </dt>
 1077 <dd>
 1078 <p>
 1079         Don&#8217;t clone any tags, and set
 1080         <code>remote.&lt;remote&gt;.tagOpt=--no-tags</code> in the config, ensuring
 1081         that future <code>git pull</code> and <code>git fetch</code> operations won&#8217;t follow
 1082         any tags. Subsequent explicit tag fetches will still work,
 1083         (see <a href="git-fetch.html">git-fetch(1)</a>).
 1084 </p>
 1085 <div class="paragraph"><p>Can be used in conjunction with <code>--single-branch</code> to clone and
 1086 maintain a branch with no references other than a single cloned
 1087 branch. This is useful e.g. to maintain minimal clones of the default
 1088 branch of some repository for search indexing.</p></div>
 1089 </dd>
 1090 <dt class="hdlist1">
 1091 --recurse-submodules[=&lt;pathspec]
 1092 </dt>
 1093 <dd>
 1094 <p>
 1095         After the clone is created, initialize and clone submodules
 1096         within based on the provided pathspec.  If no pathspec is
 1097         provided, all submodules are initialized and cloned.
 1098         This option can be given multiple times for pathspecs consisting
 1099         of multiple entries.  The resulting clone has <code>submodule.active</code> set to
 1100         the provided pathspec, or "." (meaning all submodules) if no
 1101         pathspec is provided.
 1102 </p>
 1103 <div class="paragraph"><p>Submodules are initialized and cloned using their default settings. This is
 1104 equivalent to running
 1105 <code>git submodule update --init --recursive &lt;pathspec&gt;</code> immediately after
 1106 the clone is finished. This option is ignored if the cloned repository does
 1107 not have a worktree/checkout (i.e. if any of <code>--no-checkout</code>/<code>-n</code>, <code>--bare</code>,
 1108 or <code>--mirror</code> is given)</p></div>
 1109 </dd>
 1110 <dt class="hdlist1">
 1111 --[no-]shallow-submodules
 1112 </dt>
 1113 <dd>
 1114 <p>
 1115         All submodules which are cloned will be shallow with a depth of 1.
 1116 </p>
 1117 </dd>
 1118 <dt class="hdlist1">
 1119 --separate-git-dir=&lt;git dir&gt;
 1120 </dt>
 1121 <dd>
 1122 <p>
 1123         Instead of placing the cloned repository where it is supposed
 1124         to be, place the cloned repository at the specified directory,
 1125         then make a filesystem-agnostic Git symbolic link to there.
 1126         The result is Git repository can be separated from working
 1127         tree.
 1128 </p>
 1129 </dd>
 1130 <dt class="hdlist1">
 1131 -j &lt;n&gt;
 1132 </dt>
 1133 <dt class="hdlist1">
 1134 --jobs &lt;n&gt;
 1135 </dt>
 1136 <dd>
 1137 <p>
 1138         The number of submodules fetched at the same time.
 1139         Defaults to the <code>submodule.fetchJobs</code> option.
 1140 </p>
 1141 </dd>
 1142 <dt class="hdlist1">
 1143 &lt;repository&gt;
 1144 </dt>
 1145 <dd>
 1146 <p>
 1147         The (possibly remote) repository to clone from.  See the
 1148         <a href="#URLS">GIT URLS</a> section below for more information on specifying
 1149         repositories.
 1150 </p>
 1151 </dd>
 1152 <dt class="hdlist1">
 1153 &lt;directory&gt;
 1154 </dt>
 1155 <dd>
 1156 <p>
 1157         The name of a new directory to clone into.  The "humanish"
 1158         part of the source repository is used if no directory is
 1159         explicitly given (<code>repo</code> for <code>/path/to/repo.git</code> and <code>foo</code>
 1160         for <code>host.xz:foo/.git</code>).  Cloning into an existing directory
 1161         is only allowed if the directory is empty.
 1162 </p>
 1163 </dd>
 1164 </dl></div>
 1165 </div>
 1166 </div>
 1167 <div class="sect1">
 1168 <h2 id="_git_urls_a_id_urls_a">GIT URLS<a id="URLS"></a></h2>
 1169 <div class="sectionbody">
 1170 <div class="paragraph"><p>In general, URLs contain information about the transport protocol, the
 1171 address of the remote server, and the path to the repository.
 1172 Depending on the transport protocol, some of this information may be
 1173 absent.</p></div>
 1174 <div class="paragraph"><p>Git supports ssh, git, http, and https protocols (in addition, ftp,
 1175 and ftps can be used for fetching, but this is inefficient and
 1176 deprecated; do not use it).</p></div>
 1177 <div class="paragraph"><p>The native transport (i.e. git:// URL) does no authentication and
 1178 should be used with caution on unsecured networks.</p></div>
 1179 <div class="paragraph"><p>The following syntaxes may be used with them:</p></div>
 1180 <div class="ulist"><ul>
 1181 <li>
 1182 <p>
 1183 ssh://&#91;user@&#93;host.xz&#91;:port&#93;/path/to/repo.git/
 1184 </p>
 1185 </li>
 1186 <li>
 1187 <p>
 1188 git://host.xz&#91;:port&#93;/path/to/repo.git/
 1189 </p>
 1190 </li>
 1191 <li>
 1192 <p>
 1193 http&#91;s&#93;://host.xz&#91;:port&#93;/path/to/repo.git/
 1194 </p>
 1195 </li>
 1196 <li>
 1197 <p>
 1198 ftp&#91;s&#93;://host.xz&#91;:port&#93;/path/to/repo.git/
 1199 </p>
 1200 </li>
 1201 </ul></div>
 1202 <div class="paragraph"><p>An alternative scp-like syntax may also be used with the ssh protocol:</p></div>
 1203 <div class="ulist"><ul>
 1204 <li>
 1205 <p>
 1206 &#91;user@&#93;host.xz:path/to/repo.git/
 1207 </p>
 1208 </li>
 1209 </ul></div>
 1210 <div class="paragraph"><p>This syntax is only recognized if there are no slashes before the
 1211 first colon. This helps differentiate a local path that contains a
 1212 colon. For example the local path <code>foo:bar</code> could be specified as an
 1213 absolute path or <code>./foo:bar</code> to avoid being misinterpreted as an ssh
 1214 url.</p></div>
 1215 <div class="paragraph"><p>The ssh and git protocols additionally support ~username expansion:</p></div>
 1216 <div class="ulist"><ul>
 1217 <li>
 1218 <p>
 1219 ssh://&#91;user@&#93;host.xz&#91;:port&#93;/~&#91;user&#93;/path/to/repo.git/
 1220 </p>
 1221 </li>
 1222 <li>
 1223 <p>
 1224 git://host.xz&#91;:port&#93;/~&#91;user&#93;/path/to/repo.git/
 1225 </p>
 1226 </li>
 1227 <li>
 1228 <p>
 1229 &#91;user@&#93;host.xz:/~&#91;user&#93;/path/to/repo.git/
 1230 </p>
 1231 </li>
 1232 </ul></div>
 1233 <div class="paragraph"><p>For local repositories, also supported by Git natively, the following
 1234 syntaxes may be used:</p></div>
 1235 <div class="ulist"><ul>
 1236 <li>
 1237 <p>
 1238 /path/to/repo.git/
 1239 </p>
 1240 </li>
 1241 <li>
 1242 <p>
 1243 file:///path/to/repo.git/
 1244 </p>
 1245 </li>
 1246 </ul></div>
 1247 <div class="paragraph"><p>These two syntaxes are mostly equivalent, except the former implies
 1248 --local option.</p></div>
 1249 <div class="paragraph"><p>When Git doesn&#8217;t know how to handle a certain transport protocol, it
 1250 attempts to use the <em>remote-&lt;transport&gt;</em> remote helper, if one
 1251 exists. To explicitly request a remote helper, the following syntax
 1252 may be used:</p></div>
 1253 <div class="ulist"><ul>
 1254 <li>
 1255 <p>
 1256 &lt;transport&gt;::&lt;address&gt;
 1257 </p>
 1258 </li>
 1259 </ul></div>
 1260 <div class="paragraph"><p>where &lt;address&gt; may be a path, a server and path, or an arbitrary
 1261 URL-like string recognized by the specific remote helper being
 1262 invoked. See <a href="gitremote-helpers.html">gitremote-helpers(1)</a> for details.</p></div>
 1263 <div class="paragraph"><p>If there are a large number of similarly-named remote repositories and
 1264 you want to use a different format for them (such that the URLs you
 1265 use will be rewritten into URLs that work), you can create a
 1266 configuration section of the form:</p></div>
 1267 <div class="listingblock">
 1268 <div class="content">
 1269 <pre><code>        [url "&lt;actual url base&gt;"]
 1270                 insteadOf = &lt;other url base&gt;</code></pre>
 1271 </div></div>
 1272 <div class="paragraph"><p>For example, with this:</p></div>
 1273 <div class="listingblock">
 1274 <div class="content">
 1275 <pre><code>        [url "git://git.host.xz/"]
 1276                 insteadOf = host.xz:/path/to/
 1277                 insteadOf = work:</code></pre>
 1278 </div></div>
 1279 <div class="paragraph"><p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be
 1280 rewritten in any context that takes a URL to be "git://git.host.xz/repo.git".</p></div>
 1281 <div class="paragraph"><p>If you want to rewrite URLs for push only, you can create a
 1282 configuration section of the form:</p></div>
 1283 <div class="listingblock">
 1284 <div class="content">
 1285 <pre><code>        [url "&lt;actual url base&gt;"]
 1286                 pushInsteadOf = &lt;other url base&gt;</code></pre>
 1287 </div></div>
 1288 <div class="paragraph"><p>For example, with this:</p></div>
 1289 <div class="listingblock">
 1290 <div class="content">
 1291 <pre><code>        [url "ssh://example.org/"]
 1292                 pushInsteadOf = git://example.org/</code></pre>
 1293 </div></div>
 1294 <div class="paragraph"><p>a URL like "git://example.org/path/to/repo.git" will be rewritten to
 1295 "ssh://example.org/path/to/repo.git" for pushes, but pulls will still
 1296 use the original URL.</p></div>
 1297 </div>
 1298 </div>
 1299 <div class="sect1">
 1300 <h2 id="_examples">EXAMPLES</h2>
 1301 <div class="sectionbody">
 1302 <div class="ulist"><ul>
 1303 <li>
 1304 <p>
 1305 Clone from upstream:
 1306 </p>
 1307 <div class="listingblock">
 1308 <div class="content">
 1309 <pre><code>$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux
 1310 $ cd my-linux
 1311 $ make</code></pre>
 1312 </div></div>
 1313 </li>
 1314 <li>
 1315 <p>
 1316 Make a local clone that borrows from the current directory, without checking things out:
 1317 </p>
 1318 <div class="listingblock">
 1319 <div class="content">
 1320 <pre><code>$ git clone -l -s -n . ../copy
 1321 $ cd ../copy
 1322 $ git show-branch</code></pre>
 1323 </div></div>
 1324 </li>
 1325 <li>
 1326 <p>
 1327 Clone from upstream while borrowing from an existing local directory:
 1328 </p>
 1329 <div class="listingblock">
 1330 <div class="content">
 1331 <pre><code>$ git clone --reference /git/linux.git \
 1332         git://git.kernel.org/pub/scm/.../linux.git \
 1333         my-linux
 1334 $ cd my-linux</code></pre>
 1335 </div></div>
 1336 </li>
 1337 <li>
 1338 <p>
 1339 Create a bare repository to publish your changes to the public:
 1340 </p>
 1341 <div class="listingblock">
 1342 <div class="content">
 1343 <pre><code>$ git clone --bare -l /home/proj/.git /pub/scm/proj.git</code></pre>
 1344 </div></div>
 1345 </li>
 1346 </ul></div>
 1347 </div>
 1348 </div>
 1349 <div class="sect1">
 1350 <h2 id="_git">GIT</h2>
 1351 <div class="sectionbody">
 1352 <div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
 1353 </div>
 1354 </div>
 1355 </div>
 1356 <div id="footnotes"><hr /></div>
 1357 <div id="footer">
 1358 <div id="footer-text">
 1359 Last updated
 1360  2018-12-15 13:06:11 JST
 1361 </div>
 1362 </div>
 1363 </body>
 1364 </html>