Google Git
Sign in
chromium / external / gitster / git-htmldocs / 62e7937aa6281c1a23ab8095a102fd558840734a / . / git.html
blob: 9da0185e9627d0f595e97eff5259c1af1d3846b5 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]6<meta name="generator" content="AsciiDoc 8.5.2" />
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]7<title>git(1)</title>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]8<style type="text/css">
9/* Debug borders */
10p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
11/*
12 border: 1px solid red;
13*/
14}
15
16body {
17 margin: 1em 5% 1em 5%;
18}
19
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]20a {
21 color: blue;
22 text-decoration: underline;
23}
24a:visited {
25 color: fuchsia;
26}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]27
28em {
29 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]30 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]31}
32
33strong {
34 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]35 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]36}
37
38tt {
39 color: navy;
40}
41
42h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
48}
49
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]50h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]51 border-bottom: 2px solid silver;
52}
53h2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]54 padding-top: 0.5em;
55}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]56h3 {
57 float: left;
58}
59h3 + * {
60 clear: left;
61}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]62
63div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
66}
67
68hr {
69 border: 1px solid silver;
70}
71
72p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
75}
76
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]77ul, ol, li > p {
78 margin-top: 0;
79}
80
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]81pre {
82 padding: 0;
83 margin: 0;
84}
85
86span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]90 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]91}
92span#email {
93}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]94span#revnumber, span#revdate, span#revremark {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]95 font-family: sans-serif;
96}
97
98div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
104}
105div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
108}
109div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
112}
113
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]114div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
117}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]118div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]121 margin-top: 1.0em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]122 margin-bottom: 1.5em;
123}
124div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]125 margin-top: 2.0em;
126 margin-bottom: 2.0em;
127 margin-right: 10%;
128 color: #606060;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]129}
130
131div.content { /* Block element content. */
132 padding: 0;
133}
134
135/* Block element titles. */
136div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]137 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]138 font-family: sans-serif;
139 font-weight: bold;
140 text-align: left;
141 margin-top: 1.0em;
142 margin-bottom: 0.5em;
143}
144div.title + * {
145 margin-top: 0;
146}
147
148td div.title:first-child {
149 margin-top: 0.0em;
150}
151div.content div.title:first-child {
152 margin-top: 0.0em;
153}
154div.content + div.title {
155 margin-top: 0.0em;
156}
157
158div.sidebarblock > div.content {
159 background: #ffffee;
160 border: 1px solid silver;
161 padding: 0.5em;
162}
163
164div.listingblock > div.content {
165 border: 1px solid silver;
166 background: #f4f4f4;
167 padding: 0.5em;
168}
169
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]170div.quoteblock, div.verseblock {
171 padding-left: 1.0em;
172 margin-left: 1.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]173 margin-right: 10%;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]174 border-left: 5px solid #dddddd;
175 color: #777777;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]176}
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]177
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]178div.quoteblock > div.attribution {
179 padding-top: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]180 text-align: right;
181}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]182
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]183div.verseblock > div.content {
184 white-space: pre;
185}
186div.verseblock > div.attribution {
187 padding-top: 0.75em;
188 text-align: left;
189}
190/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]191div.verseblock + div.attribution {
192 text-align: left;
193}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]194
195div.admonitionblock .icon {
196 vertical-align: top;
197 font-size: 1.1em;
198 font-weight: bold;
199 text-decoration: underline;
200 color: #527bbd;
201 padding-right: 0.5em;
202}
203div.admonitionblock td.content {
204 padding-left: 0.5em;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]205 border-left: 3px solid #dddddd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]206}
207
208div.exampleblock > div.content {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]209 border-left: 3px solid #dddddd;
210 padding-left: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]211}
212
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]213div.imageblock div.content { padding-left: 0; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]214span.image img { border-style: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]215a.image:visited { color: white; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]216
217dl {
218 margin-top: 0.8em;
219 margin-bottom: 0.8em;
220}
221dt {
222 margin-top: 0.5em;
223 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]224 font-style: normal;
225 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]226}
227dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]228 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]229}
230
231ul, ol {
232 list-style-position: outside;
233}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]234ol.arabic {
235 list-style-type: decimal;
236}
237ol.loweralpha {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]238 list-style-type: lower-alpha;
239}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]240ol.upperalpha {
241 list-style-type: upper-alpha;
242}
243ol.lowerroman {
244 list-style-type: lower-roman;
245}
246ol.upperroman {
247 list-style-type: upper-roman;
248}
249
250div.compact ul, div.compact ol,
251div.compact p, div.compact p,
252div.compact div, div.compact div {
253 margin-top: 0.1em;
254 margin-bottom: 0.1em;
255}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]256
257div.tableblock > table {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]258 border: 3px solid #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]259}
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]260thead, p.table.header {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]261 font-family: sans-serif;
262 font-weight: bold;
263}
264tfoot {
265 font-weight: bold;
266}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]267td > div.verse {
268 white-space: pre;
269}
270p.table {
271 margin-top: 0;
272}
273/* Because the table frame attribute is overriden by CSS in most browsers. */
274div.tableblock > table[frame="void"] {
275 border-style: none;
276}
277div.tableblock > table[frame="hsides"] {
278 border-left-style: none;
279 border-right-style: none;
280}
281div.tableblock > table[frame="vsides"] {
282 border-top-style: none;
283 border-bottom-style: none;
284}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]285
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]286
287div.hdlist {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]288 margin-top: 0.8em;
289 margin-bottom: 0.8em;
290}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]291div.hdlist tr {
292 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]293}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]294dt.hdlist1.strong, td.hdlist1.strong {
295 font-weight: bold;
296}
297td.hdlist1 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]298 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]299 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]300 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]301 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]302}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]303td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]304 vertical-align: top;
305}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]306div.hdlist.compact tr {
307 margin: 0;
308 padding-bottom: 0;
309}
310
311.comment {
312 background: yellow;
313}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]314
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]315.footnote, .footnoteref {
316 font-size: 0.8em;
317}
318
319span.footnote, span.footnoteref {
320 vertical-align: super;
321}
322
323#footnotes {
324 margin: 20px 0 20px 0;
325 padding: 7px 0 0 0;
326}
327
328#footnotes div.footnote {
329 margin: 0 0 5px 0;
330}
331
332#footnotes hr {
333 border: none;
334 border-top: 1px solid silver;
335 height: 1px;
336 text-align: left;
337 margin-left: 0;
338 width: 20%;
339 min-width: 100px;
340}
341
342
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]343@media print {
344 div#footer-badges { display: none; }
345}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]346
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]347div#toc {
348 margin-bottom: 2.5em;
349}
350
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]351div#toctitle {
352 color: #527bbd;
353 font-family: sans-serif;
354 font-size: 1.1em;
355 font-weight: bold;
356 margin-top: 1.0em;
357 margin-bottom: 0.1em;
358}
359
360div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
361 margin-top: 0;
362 margin-bottom: 0;
363}
364div.toclevel2 {
365 margin-left: 2em;
366 font-size: 0.9em;
367}
368div.toclevel3 {
369 margin-left: 4em;
370 font-size: 0.9em;
371}
372div.toclevel4 {
373 margin-left: 6em;
374 font-size: 0.9em;
375}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]376/* Overrides for manpage documents */
377h1 {
378 padding-top: 0.5em;
379 padding-bottom: 0.5em;
380 border-top: 2px solid silver;
381 border-bottom: 2px solid silver;
382}
383h2 {
384 border-style: none;
385}
386div.sectionbody {
387 margin-left: 5%;
388}
389
390@media print {
391 div#toc { display: none; }
392}
393
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]394/* Workarounds for IE6's broken and incomplete CSS2. */
395
396div.sidebar-content {
397 background: #ffffee;
398 border: 1px solid silver;
399 padding: 0.5em;
400}
401div.sidebar-title, div.image-title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]402 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]403 font-family: sans-serif;
404 font-weight: bold;
405 margin-top: 0.0em;
406 margin-bottom: 0.5em;
407}
408
409div.listingblock div.content {
410 border: 1px solid silver;
411 background: #f4f4f4;
412 padding: 0.5em;
413}
414
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]415div.quoteblock-attribution {
416 padding-top: 0.5em;
417 text-align: right;
418}
419
420div.verseblock-content {
421 white-space: pre;
422}
423div.verseblock-attribution {
424 padding-top: 0.75em;
425 text-align: left;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]426}
427
428div.exampleblock-content {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]429 border-left: 3px solid #dddddd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]430 padding-left: 0.5em;
431}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]432
433/* IE6 sets dynamically generated links as visited. */
434div#toc a:visited { color: blue; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]435</style>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]436<script type="text/javascript">
437/*<![CDATA[*/
438window.onload = function(){asciidoc.footnotes();}
439var asciidoc = { // Namespace.
440
441/////////////////////////////////////////////////////////////////////
442// Table Of Contents generator
443/////////////////////////////////////////////////////////////////////
444
445/* Author: Mihai Bazon, September 2002
446 * http://students.infoiasi.ro/~mishoo
447 *
448 * Table Of Content generator
449 * Version: 0.4
450 *
451 * Feel free to use this script under the terms of the GNU General Public
452 * License, as long as you do not remove or alter this notice.
453 */
454
455 /* modified by Troy D. Hanson, September 2006. License: GPL */
456 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
457
458// toclevels = 1..4.
459toc: function (toclevels) {
460
461 function getText(el) {
462 var text = "";
463 for (var i = el.firstChild; i != null; i = i.nextSibling) {
464 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
465 text += i.data;
466 else if (i.firstChild != null)
467 text += getText(i);
468 }
469 return text;
470 }
471
472 function TocEntry(el, text, toclevel) {
473 this.element = el;
474 this.text = text;
475 this.toclevel = toclevel;
476 }
477
478 function tocEntries(el, toclevels) {
479 var result = new Array;
480 var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
481 // Function that scans the DOM tree for header elements (the DOM2
482 // nodeIterator API would be a better technique but not supported by all
483 // browsers).
484 var iterate = function (el) {
485 for (var i = el.firstChild; i != null; i = i.nextSibling) {
486 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
487 var mo = re.exec(i.tagName);
488 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
489 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
490 }
491 iterate(i);
492 }
493 }
494 }
495 iterate(el);
496 return result;
497 }
498
499 var toc = document.getElementById("toc");
500 var entries = tocEntries(document.getElementById("content"), toclevels);
501 for (var i = 0; i < entries.length; ++i) {
502 var entry = entries[i];
503 if (entry.element.id == "")
504 entry.element.id = "_toc_" + i;
505 var a = document.createElement("a");
506 a.href = "#" + entry.element.id;
507 a.appendChild(document.createTextNode(entry.text));
508 var div = document.createElement("div");
509 div.appendChild(a);
510 div.className = "toclevel" + entry.toclevel;
511 toc.appendChild(div);
512 }
513 if (entries.length == 0)
514 toc.parentNode.removeChild(toc);
515},
516
517
518/////////////////////////////////////////////////////////////////////
519// Footnotes generator
520/////////////////////////////////////////////////////////////////////
521
522/* Based on footnote generation code from:
523 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
524 */
525
526footnotes: function () {
527 var cont = document.getElementById("content");
528 var noteholder = document.getElementById("footnotes");
529 var spans = cont.getElementsByTagName("span");
530 var refs = {};
531 var n = 0;
532 for (i=0; i<spans.length; i++) {
533 if (spans[i].className == "footnote") {
534 n++;
535 // Use [\s\S] in place of . so multi-line matches work.
536 // Because JavaScript has no s (dotall) regex flag.
537 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
538 noteholder.innerHTML +=
539 "<div class='footnote' id='_footnote_" + n + "'>" +
540 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
541 n + "</a>. " + note + "</div>";
542 spans[i].innerHTML =
543 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
544 "' title='View footnote' class='footnote'>" + n + "</a>]";
545 var id =spans[i].getAttribute("id");
546 if (id != null) refs["#"+id] = n;
547 }
548 }
549 if (n == 0)
550 noteholder.parentNode.removeChild(noteholder);
551 else {
552 // Process footnoterefs.
553 for (i=0; i<spans.length; i++) {
554 if (spans[i].className == "footnoteref") {
555 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
556 href = href.match(/#.*/)[0]; // Because IE return full URL.
557 n = refs[href];
558 spans[i].innerHTML =
559 "[<a href='#_footnote_" + n +
560 "' title='View footnote' class='footnote'>" + n + "</a>]";
561 }
562 }
563 }
564}
565
566}
567/*]]>*/
568</script>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]569</head>
570<body>
571<div id="header">
572<h1>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]573git(1) Manual Page
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]574</h1>
575<h2>NAME</h2>
576<div class="sectionbody">
577<p>git -
578 the stupid content tracker
579</p>
580</div>
581</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]582<div id="content">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]583<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]584<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]585<div class="verseblock">
Junio C Hamano90ff60f2012-02-20 10:25:14[diff] [blame]586<div class="verseblock-content"><em>git</em> [--version] [--help] [-c &lt;name&gt;=&lt;value&gt;]
587 [--exec-path[=&lt;path&gt;]] [--html-path] [--man-path] [--info-path]
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]588 [-p|--paginate|--no-pager] [--no-replace-objects] [--bare]
589 [--git-dir=&lt;path&gt;] [--work-tree=&lt;path&gt;] [--namespace=&lt;name&gt;]
Junio C Hamano90ff60f2012-02-20 10:25:14[diff] [blame]590 &lt;command&gt; [&lt;args&gt;]</div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]591<div class="verseblock-attribution">
592</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]593</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]594<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]595<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]596<div class="paragraph"><p>Git is a fast, scalable, distributed revision control system with an
Junio C Hamanoe27fb932006-04-03 05:34:10[diff] [blame]597unusually rich command set that provides both high-level operations
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]598and full access to internals.</p></div>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]599<div class="paragraph"><p>See <a href="gittutorial.html">gittutorial(7)</a> to get started, then see
Junio C Hamanoe27fb932006-04-03 05:34:10[diff] [blame]600<a href="everyday.html">Everyday Git</a> for a useful minimum set of commands, and
601"man git-commandname" for documentation of each command. CVS users may
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]602also want to read <a href="gitcvs-migration.html">gitcvs-migration(7)</a>. See
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]603the <a href="user-manual.html">Git User&#8217;s Manual</a> for a more in-depth
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]604introduction.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]605<div class="paragraph"><p>The <em>&lt;command&gt;</em> is either a name of a Git command (see below) or an alias
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]606as defined in the configuration file (see <a href="git-config.html">git-config(1)</a>).</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]607<div class="paragraph"><p>Formatted and hyperlinked version of the latest git
Junio C Hamanob63afff2007-05-01 03:05:55[diff] [blame]608documentation can be viewed at
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]609<tt>http://www.kernel.org/pub/software/scm/git/docs/</tt>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]610</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]611<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]612<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]613<div class="dlist"><dl>
614<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]615--version
616</dt>
617<dd>
618<p>
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]619 Prints the git suite version that the <em>git</em> program came from.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]620</p>
621</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]622<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]623--help
624</dt>
625<dd>
626<p>
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]627 Prints the synopsis and a list of the most commonly used
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]628 commands. If the option <em>--all</em> or <em>-a</em> is given then all
629 available commands are printed. If a git command is named this
630 option will bring up the manual page for that command.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]631</p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]632<div class="paragraph"><p>Other options are available to control how the manual page is
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]633displayed. See <a href="git-help.html">git-help(1)</a> for more information,
Junio C Hamano22700fb2012-05-03 23:07:25[diff] [blame]634because <tt>git --help ...</tt> is converted internally into <tt>git
635help ...</tt>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]636</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]637<dt class="hdlist1">
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]638-c &lt;name&gt;=&lt;value&gt;
639</dt>
640<dd>
641<p>
642 Pass a configuration parameter to the command. The value
643 given will override values from configuration files.
644 The &lt;name&gt; is expected in the same format as listed by
645 <em>git config</em> (subkeys separated by dots).
646</p>
647</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]648<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]649--exec-path[=&lt;path&gt;]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]650</dt>
651<dd>
652<p>
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]653 Path to wherever your core git programs are installed.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]654 This can also be controlled by setting the GIT_EXEC_PATH
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]655 environment variable. If no path is given, <em>git</em> will print
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]656 the current setting and then exit.
657</p>
658</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]659<dt class="hdlist1">
Junio C Hamanob4a9ede2009-04-08 07:36:32[diff] [blame]660--html-path
661</dt>
662<dd>
663<p>
Junio C Hamano5f2627d2011-05-06 20:23:48[diff] [blame]664 Print the path, without trailing slash, where git&#8217;s HTML
665 documentation is installed and exit.
666</p>
667</dd>
668<dt class="hdlist1">
669--man-path
670</dt>
671<dd>
672<p>
673 Print the manpath (see <tt>man(1)</tt>) for the man pages for
674 this version of git and exit.
675</p>
676</dd>
677<dt class="hdlist1">
678--info-path
679</dt>
680<dd>
681<p>
682 Print the path where the Info files documenting this
683 version of git are installed and exit.
Junio C Hamanob4a9ede2009-04-08 07:36:32[diff] [blame]684</p>
685</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]686<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]687-p
688</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]689<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]690--paginate
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]691</dt>
692<dd>
693<p>
Junio C Hamano4aa0bcc2010-03-03 05:13:12[diff] [blame]694 Pipe all output into <em>less</em> (or if set, $PAGER) if standard
695 output is a terminal. This overrides the <tt>pager.&lt;cmd&gt;</tt>
696 configuration options (see the "Configuration Mechanism" section
697 below).
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]698</p>
699</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]700<dt class="hdlist1">
Junio C Hamanocae86272007-08-21 02:20:49[diff] [blame]701--no-pager
702</dt>
703<dd>
704<p>
705 Do not pipe git output into a pager.
706</p>
707</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]708<dt class="hdlist1">
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]709--git-dir=&lt;path&gt;
710</dt>
711<dd>
712<p>
713 Set the path to the repository. This can also be controlled by
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]714 setting the GIT_DIR environment variable. It can be an absolute
715 path or relative path to current working directory.
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]716</p>
717</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]718<dt class="hdlist1">
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]719--work-tree=&lt;path&gt;
720</dt>
721<dd>
722<p>
Junio C Hamano80d58462011-01-24 22:52:52[diff] [blame]723 Set the path to the working tree. It can be an absolute path
724 or a path relative to the current working directory.
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]725 This can also be controlled by setting the GIT_WORK_TREE
726 environment variable and the core.worktree configuration
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]727 variable (see core.worktree in <a href="git-config.html">git-config(1)</a> for a
Junio C Hamano80d58462011-01-24 22:52:52[diff] [blame]728 more detailed discussion).
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]729</p>
730</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]731<dt class="hdlist1">
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]732--namespace=&lt;path&gt;
733</dt>
734<dd>
735<p>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]736 Set the git namespace. See <a href="gitnamespaces.html">gitnamespaces(7)</a> for more
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]737 details. Equivalent to setting the <tt>GIT_NAMESPACE</tt> environment
738 variable.
739</p>
740</dd>
741<dt class="hdlist1">
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]742--bare
743</dt>
744<dd>
745<p>
Junio C Hamanoc435b1c2007-08-28 06:25:35[diff] [blame]746 Treat the repository as a bare repository. If GIT_DIR
747 environment is not set, it is set to the current working
748 directory.
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]749</p>
750</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]751<dt class="hdlist1">
Junio C Hamano3d23a0a2009-10-19 08:04:30[diff] [blame]752--no-replace-objects
753</dt>
754<dd>
755<p>
756 Do not use replacement refs to replace git objects. See
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]757 <a href="git-replace.html">git-replace(1)</a> for more information.
Junio C Hamano3d23a0a2009-10-19 08:04:30[diff] [blame]758</p>
759</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]760</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]761</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]762<h2 id="_further_documentation">FURTHER DOCUMENTATION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]763<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]764<div class="paragraph"><p>See the references above to get started using git. The following is
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]765probably more detail than necessary for a first-time user.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]766<div class="paragraph"><p>The <a href="user-manual.html#git-concepts">git concepts chapter of the
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]767user-manual</a> and <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a> both provide
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]768introductions to the underlying git architecture.</p></div>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]769<div class="paragraph"><p>See <a href="gitworkflows.html">gitworkflows(7)</a> for an overview of recommended workflows.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]770<div class="paragraph"><p>See also the <a href="howto-index.html">howto</a> documents for some useful
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]771examples.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]772<div class="paragraph"><p>The internals are documented in the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]773<a href="technical/api-index.html">GIT API documentation</a>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]774</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]775<h2 id="_git_commands">GIT COMMANDS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]776<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]777<div class="paragraph"><p>We divide git into high level ("porcelain") commands and low level
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]778("plumbing") commands.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]779</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]780<h2 id="_high_level_commands_porcelain">High-level commands (porcelain)</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]781<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]782<div class="paragraph"><p>We separate the porcelain commands into the main commands and some
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]783ancillary user utilities.</p></div>
784<h3 id="_main_porcelain_commands">Main porcelain commands</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]785<div class="dlist"><dl>
786<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]787<a href="git-add.html">git-add(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]788</dt>
789<dd>
790<p>
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]791 Add file contents to the index.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]792</p>
793</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]794<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]795<a href="git-am.html">git-am(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]796</dt>
797<dd>
798<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]799 Apply a series of patches from a mailbox.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]800</p>
801</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]802<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]803<a href="git-archive.html">git-archive(1)</a>
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]804</dt>
805<dd>
806<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]807 Create an archive of files from a named tree.
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]808</p>
809</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]810<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]811<a href="git-bisect.html">git-bisect(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]812</dt>
813<dd>
814<p>
Junio C Hamanofd83b8e2009-03-22 08:21:41[diff] [blame]815 Find by binary search the change that introduced a bug.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]816</p>
817</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]818<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]819<a href="git-branch.html">git-branch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]820</dt>
821<dd>
822<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]823 List, create, or delete branches.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]824</p>
825</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]826<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]827<a href="git-bundle.html">git-bundle(1)</a>
Junio C Hamano6ac2f142007-03-01 01:24:56[diff] [blame]828</dt>
829<dd>
830<p>
831 Move objects and refs by archive.
832</p>
833</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]834<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]835<a href="git-checkout.html">git-checkout(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]836</dt>
837<dd>
838<p>
Junio C Hamanoa14a4032008-03-25 09:11:02[diff] [blame]839 Checkout a branch or paths to the working tree.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]840</p>
841</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]842<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]843<a href="git-cherry-pick.html">git-cherry-pick(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]844</dt>
845<dd>
846<p>
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]847 Apply the changes introduced by some existing commits.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]848</p>
849</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]850<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]851<a href="git-citool.html">git-citool(1)</a>
Junio C Hamano58784fc2007-06-23 08:48:57[diff] [blame]852</dt>
853<dd>
854<p>
855 Graphical alternative to git-commit.
856</p>
857</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]858<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]859<a href="git-clean.html">git-clean(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]860</dt>
861<dd>
862<p>
863 Remove untracked files from the working tree.
864</p>
865</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]866<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]867<a href="git-clone.html">git-clone(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]868</dt>
869<dd>
870<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]871 Clone a repository into a new directory.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]872</p>
873</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]874<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]875<a href="git-commit.html">git-commit(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]876</dt>
877<dd>
878<p>
879 Record changes to the repository.
880</p>
881</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]882<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]883<a href="git-describe.html">git-describe(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]884</dt>
885<dd>
886<p>
887 Show the most recent tag that is reachable from a commit.
888</p>
889</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]890<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]891<a href="git-diff.html">git-diff(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]892</dt>
893<dd>
894<p>
895 Show changes between commits, commit and working tree, etc.
896</p>
897</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]898<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]899<a href="git-fetch.html">git-fetch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]900</dt>
901<dd>
902<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]903 Download objects and refs from another repository.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]904</p>
905</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]906<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]907<a href="git-format-patch.html">git-format-patch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]908</dt>
909<dd>
910<p>
911 Prepare patches for e-mail submission.
912</p>
913</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]914<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]915<a href="git-gc.html">git-gc(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]916</dt>
917<dd>
918<p>
919 Cleanup unnecessary files and optimize the local repository.
920</p>
921</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]922<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]923<a href="git-grep.html">git-grep(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]924</dt>
925<dd>
926<p>
927 Print lines matching a pattern.
928</p>
929</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]930<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]931<a href="git-gui.html">git-gui(1)</a>
Junio C Hamano58784fc2007-06-23 08:48:57[diff] [blame]932</dt>
933<dd>
934<p>
935 A portable graphical interface to Git.
936</p>
937</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]938<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]939<a href="git-init.html">git-init(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]940</dt>
941<dd>
942<p>
943 Create an empty git repository or reinitialize an existing one.
944</p>
945</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]946<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]947<a href="git-log.html">git-log(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]948</dt>
949<dd>
950<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]951 Show commit logs.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]952</p>
953</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]954<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]955<a href="git-merge.html">git-merge(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]956</dt>
957<dd>
958<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]959 Join two or more development histories together.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]960</p>
961</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]962<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]963<a href="git-mv.html">git-mv(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]964</dt>
965<dd>
966<p>
967 Move or rename a file, a directory, or a symlink.
968</p>
969</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]970<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]971<a href="git-notes.html">git-notes(1)</a>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]972</dt>
973<dd>
974<p>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]975 Add or inspect object notes.
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]976</p>
977</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]978<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]979<a href="git-pull.html">git-pull(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]980</dt>
981<dd>
982<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]983 Fetch from and merge with another repository or a local branch.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]984</p>
985</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]986<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]987<a href="git-push.html">git-push(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]988</dt>
989<dd>
990<p>
991 Update remote refs along with associated objects.
992</p>
993</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]994<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]995<a href="git-rebase.html">git-rebase(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]996</dt>
997<dd>
998<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]999 Forward-port local commits to the updated upstream head.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1000</p>
1001</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1002<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1003<a href="git-reset.html">git-reset(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1004</dt>
1005<dd>
1006<p>
1007 Reset current HEAD to the specified state.
1008</p>
1009</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1010<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1011<a href="git-revert.html">git-revert(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1012</dt>
1013<dd>
1014<p>
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]1015 Revert some existing commits.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1016</p>
1017</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1018<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1019<a href="git-rm.html">git-rm(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1020</dt>
1021<dd>
1022<p>
1023 Remove files from the working tree and from the index.
1024</p>
1025</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1026<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1027<a href="git-shortlog.html">git-shortlog(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1028</dt>
1029<dd>
1030<p>
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]1031 Summarize <em>git log</em> output.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1032</p>
1033</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1034<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1035<a href="git-show.html">git-show(1)</a>
Junio C Hamano2b135272006-03-18 07:45:42[diff] [blame]1036</dt>
1037<dd>
1038<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1039 Show various types of objects.
Junio C Hamano2b135272006-03-18 07:45:42[diff] [blame]1040</p>
1041</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1042<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1043<a href="git-stash.html">git-stash(1)</a>
Junio C Hamano1d90cb02007-07-03 07:05:31[diff] [blame]1044</dt>
1045<dd>
1046<p>
1047 Stash the changes in a dirty working directory away.
1048</p>
1049</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1050<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1051<a href="git-status.html">git-status(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1052</dt>
1053<dd>
1054<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1055 Show the working tree status.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1056</p>
1057</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1058<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1059<a href="git-submodule.html">git-submodule(1)</a>
Junio C Hamano38b693c2007-06-03 08:40:14[diff] [blame]1060</dt>
1061<dd>
1062<p>
1063 Initialize, update or inspect submodules.
1064</p>
1065</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1066<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1067<a href="git-tag.html">git-tag(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1068</dt>
1069<dd>
1070<p>
Junio C Hamanodb450ba2007-01-21 08:57:14[diff] [blame]1071 Create, list, delete or verify a tag object signed with GPG.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1072</p>
1073</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1074<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1075<a href="gitk.html">gitk(1)</a>
Junio C Hamano0a16b952007-12-02 18:56:34[diff] [blame]1076</dt>
1077<dd>
1078<p>
1079 The git repository browser.
1080</p>
1081</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1082</dl></div>
1083<h3 id="_ancillary_commands">Ancillary Commands</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1084<div class="paragraph"><p>Manipulators:</p></div>
1085<div class="dlist"><dl>
1086<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1087<a href="git-config.html">git-config(1)</a>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1088</dt>
1089<dd>
1090<p>
1091 Get and set repository or global options.
1092</p>
1093</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1094<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1095<a href="git-fast-export.html">git-fast-export(1)</a>
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]1096</dt>
1097<dd>
1098<p>
1099 Git data exporter.
1100</p>
1101</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1102<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1103<a href="git-fast-import.html">git-fast-import(1)</a>
Junio C Hamanodfc4ce72007-02-07 23:17:29[diff] [blame]1104</dt>
1105<dd>
1106<p>
Junio C Hamano053827f2007-02-14 07:23:58[diff] [blame]1107 Backend for fast Git data importers.
Junio C Hamanodfc4ce72007-02-07 23:17:29[diff] [blame]1108</p>
1109</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1110<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1111<a href="git-filter-branch.html">git-filter-branch(1)</a>
Junio C Hamanobb0f4042007-07-04 06:41:40[diff] [blame]1112</dt>
1113<dd>
1114<p>
1115 Rewrite branches.
1116</p>
1117</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1118<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1119<a href="git-lost-found.html">git-lost-found(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1120</dt>
1121<dd>
1122<p>
Junio C Hamano2d7f0272007-11-09 10:03:46[diff] [blame]1123 (deprecated) Recover lost refs that luckily have not yet been pruned.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1124</p>
1125</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1126<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1127<a href="git-mergetool.html">git-mergetool(1)</a>
Junio C Hamano103ad7f2007-03-14 11:19:26[diff] [blame]1128</dt>
1129<dd>
1130<p>
1131 Run merge conflict resolution tools to resolve merge conflicts.
1132</p>
1133</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1134<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1135<a href="git-pack-refs.html">git-pack-refs(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1136</dt>
1137<dd>
1138<p>
1139 Pack heads and tags for efficient repository access.
1140</p>
1141</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1142<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1143<a href="git-prune.html">git-prune(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1144</dt>
1145<dd>
1146<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]1147 Prune all unreachable objects from the object database.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1148</p>
1149</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1150<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1151<a href="git-reflog.html">git-reflog(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1152</dt>
1153<dd>
1154<p>
1155 Manage reflog information.
1156</p>
1157</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1158<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1159<a href="git-relink.html">git-relink(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1160</dt>
1161<dd>
1162<p>
1163 Hardlink common objects in local repositories.
1164</p>
1165</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1166<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1167<a href="git-remote.html">git-remote(1)</a>
Junio C Hamano053827f2007-02-14 07:23:58[diff] [blame]1168</dt>
1169<dd>
1170<p>
1171 manage set of tracked repositories.
1172</p>
1173</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1174<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1175<a href="git-repack.html">git-repack(1)</a>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1176</dt>
1177<dd>
1178<p>
1179 Pack unpacked objects in a repository.
1180</p>
1181</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1182<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1183<a href="git-replace.html">git-replace(1)</a>
Junio C Hamano55295992009-10-13 09:06:33[diff] [blame]1184</dt>
1185<dd>
1186<p>
1187 Create, list, delete refs to replace objects.
1188</p>
1189</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1190<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1191<a href="git-repo-config.html">git-repo-config(1)</a>
Junio C Hamanobe621892008-01-18 10:20:16[diff] [blame]1192</dt>
1193<dd>
1194<p>
1195 (deprecated) Get and set repository or global options.
1196</p>
1197</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1198</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1199<div class="paragraph"><p>Interrogators:</p></div>
1200<div class="dlist"><dl>
1201<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1202<a href="git-annotate.html">git-annotate(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1203</dt>
1204<dd>
1205<p>
Junio C Hamano7924d5e2009-03-03 08:28:48[diff] [blame]1206 Annotate file lines with commit information.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1207</p>
1208</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1209<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1210<a href="git-blame.html">git-blame(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1211</dt>
1212<dd>
1213<p>
1214 Show what revision and author last modified each line of a file.
1215</p>
1216</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1217<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1218<a href="git-cherry.html">git-cherry(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1219</dt>
1220<dd>
1221<p>
1222 Find commits not merged upstream.
1223</p>
1224</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1225<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1226<a href="git-count-objects.html">git-count-objects(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1227</dt>
1228<dd>
1229<p>
1230 Count unpacked number of objects and their disk consumption.
1231</p>
1232</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1233<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1234<a href="git-difftool.html">git-difftool(1)</a>
Junio C Hamano3bd66e92009-04-18 06:17:56[diff] [blame]1235</dt>
1236<dd>
1237<p>
1238 Show changes using common diff tools.
1239</p>
1240</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1241<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1242<a href="git-fsck.html">git-fsck(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1243</dt>
1244<dd>
1245<p>
1246 Verifies the connectivity and validity of the objects in the database.
1247</p>
1248</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1249<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1250<a href="git-get-tar-commit-id.html">git-get-tar-commit-id(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1251</dt>
1252<dd>
1253<p>
Junio C Hamano393e57f2007-11-20 04:53:25[diff] [blame]1254 Extract commit ID from an archive created using git-archive.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1255</p>
1256</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1257<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1258<a href="git-help.html">git-help(1)</a>
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]1259</dt>
1260<dd>
1261<p>
1262 display help information about git.
1263</p>
1264</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1265<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1266<a href="git-instaweb.html">git-instaweb(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1267</dt>
1268<dd>
1269<p>
1270 Instantly browse your working repository in gitweb.
1271</p>
1272</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1273<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1274<a href="git-merge-tree.html">git-merge-tree(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1275</dt>
1276<dd>
1277<p>
1278 Show three-way merge without touching index.
1279</p>
1280</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1281<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1282<a href="git-rerere.html">git-rerere(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1283</dt>
1284<dd>
1285<p>
1286 Reuse recorded resolution of conflicted merges.
1287</p>
1288</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1289<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1290<a href="git-rev-parse.html">git-rev-parse(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1291</dt>
1292<dd>
1293<p>
1294 Pick out and massage parameters.
1295</p>
1296</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1297<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1298<a href="git-show-branch.html">git-show-branch(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1299</dt>
1300<dd>
1301<p>
1302 Show branches and their commits.
1303</p>
1304</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1305<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1306<a href="git-verify-tag.html">git-verify-tag(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1307</dt>
1308<dd>
1309<p>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1310 Check the GPG signature of tags.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1311</p>
1312</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1313<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1314<a href="git-whatchanged.html">git-whatchanged(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1315</dt>
1316<dd>
1317<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1318 Show logs with difference each commit introduces.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1319</p>
1320</dd>
Junio C Hamano11821ed2011-10-19 18:42:09[diff] [blame]1321<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1322<a href="gitweb.html">gitweb(1)</a>
Junio C Hamano11821ed2011-10-19 18:42:09[diff] [blame]1323</dt>
1324<dd>
1325<p>
1326 Git web interface (web frontend to Git repositories).
1327</p>
1328</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1329</dl></div>
1330<h3 id="_interacting_with_others">Interacting with Others</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1331<div class="paragraph"><p>These commands are to interact with foreign SCM and with other
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1332people via patch over e-mail.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1333<div class="dlist"><dl>
1334<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1335<a href="git-archimport.html">git-archimport(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1336</dt>
1337<dd>
1338<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1339 Import an Arch repository into git.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1340</p>
1341</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1342<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1343<a href="git-cvsexportcommit.html">git-cvsexportcommit(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1344</dt>
1345<dd>
1346<p>
1347 Export a single commit to a CVS checkout.
1348</p>
1349</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1350<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1351<a href="git-cvsimport.html">git-cvsimport(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1352</dt>
1353<dd>
1354<p>
1355 Salvage your data out of another SCM people love to hate.
1356</p>
1357</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1358<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1359<a href="git-cvsserver.html">git-cvsserver(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1360</dt>
1361<dd>
1362<p>
1363 A CVS server emulator for git.
1364</p>
1365</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1366<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1367<a href="git-imap-send.html">git-imap-send(1)</a>
Junio C Hamano52299462006-12-28 00:59:38[diff] [blame]1368</dt>
1369<dd>
1370<p>
Junio C Hamano5cf43ca2008-08-20 09:14:14[diff] [blame]1371 Send a collection of patches from stdin to an IMAP folder.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1372</p>
1373</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1374<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1375<a href="git-p4.html">git-p4(1)</a>
Junio C Hamano4eda1362012-04-23 20:55:49[diff] [blame]1376</dt>
1377<dd>
1378<p>
1379 Import from and submit to Perforce repositories.
1380</p>
1381</dd>
1382<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1383<a href="git-quiltimport.html">git-quiltimport(1)</a>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]1384</dt>
1385<dd>
1386<p>
1387 Applies a quilt patchset onto the current branch.
1388</p>
1389</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1390<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1391<a href="git-request-pull.html">git-request-pull(1)</a>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]1392</dt>
1393<dd>
1394<p>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1395 Generates a summary of pending changes.
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]1396</p>
1397</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1398<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1399<a href="git-send-email.html">git-send-email(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1400</dt>
1401<dd>
1402<p>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1403 Send a collection of patches as emails.
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1404</p>
1405</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1406<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1407<a href="git-svn.html">git-svn(1)</a>
Junio C Hamanob518f452006-08-04 00:18:06[diff] [blame]1408</dt>
1409<dd>
1410<p>
Junio C Hamano688eae02009-06-28 05:19:50[diff] [blame]1411 Bidirectional operation between a Subversion repository and git.
Junio C Hamanob518f452006-08-04 00:18:06[diff] [blame]1412</p>
1413</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1414</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1415</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1416<h2 id="_low_level_commands_plumbing">Low-level commands (plumbing)</h2>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1417<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1418<div class="paragraph"><p>Although git includes its
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1419own porcelain layer, its low-level commands are sufficient to support
1420development of alternative porcelains. Developers of such porcelains
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1421might start by reading about <a href="git-update-index.html">git-update-index(1)</a> and
1422<a href="git-read-tree.html">git-read-tree(1)</a>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1423<div class="paragraph"><p>The interface (input, output, set of options and the semantics)
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1424to these low-level commands are meant to be a lot more stable
1425than Porcelain level commands, because these commands are
1426primarily for scripted use. The interface to Porcelain commands
1427on the other hand are subject to change in order to improve the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1428end user experience.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1429<div class="paragraph"><p>The following description divides
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1430the low-level commands into commands that manipulate objects (in
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1431the repository, index, and working tree), commands that interrogate and
1432compare objects, and commands that move objects and references between
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1433repositories.</p></div>
1434<h3 id="_manipulation_commands">Manipulation commands</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1435<div class="dlist"><dl>
1436<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1437<a href="git-apply.html">git-apply(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1438</dt>
1439<dd>
1440<p>
Junio C Hamano5706e0b2009-11-24 10:54:16[diff] [blame]1441 Apply a patch to files and/or to the index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1442</p>
1443</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1444<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1445<a href="git-checkout-index.html">git-checkout-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1446</dt>
1447<dd>
1448<p>
1449 Copy files from the index to the working tree.
1450</p>
1451</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1452<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1453<a href="git-commit-tree.html">git-commit-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1454</dt>
1455<dd>
1456<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1457 Create a new commit object.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1458</p>
1459</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1460<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1461<a href="git-hash-object.html">git-hash-object(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1462</dt>
1463<dd>
1464<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1465 Compute object ID and optionally creates a blob from a file.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1466</p>
1467</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1468<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1469<a href="git-index-pack.html">git-index-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1470</dt>
1471<dd>
1472<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1473 Build pack index file for an existing packed archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1474</p>
1475</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1476<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1477<a href="git-merge-file.html">git-merge-file(1)</a>
Junio C Hamano1de7bc62006-12-17 19:31:54[diff] [blame]1478</dt>
1479<dd>
1480<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1481 Run a three-way file merge.
Junio C Hamano1de7bc62006-12-17 19:31:54[diff] [blame]1482</p>
1483</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1484<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1485<a href="git-merge-index.html">git-merge-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1486</dt>
1487<dd>
1488<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1489 Run a merge for files needing merging.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1490</p>
1491</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1492<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1493<a href="git-mktag.html">git-mktag(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1494</dt>
1495<dd>
1496<p>
1497 Creates a tag object.
1498</p>
1499</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1500<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1501<a href="git-mktree.html">git-mktree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1502</dt>
1503<dd>
1504<p>
1505 Build a tree-object from ls-tree formatted text.
1506</p>
1507</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1508<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1509<a href="git-pack-objects.html">git-pack-objects(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1510</dt>
1511<dd>
1512<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1513 Create a packed archive of objects.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1514</p>
1515</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1516<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1517<a href="git-prune-packed.html">git-prune-packed(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1518</dt>
1519<dd>
1520<p>
1521 Remove extra objects that are already in pack files.
1522</p>
1523</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1524<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1525<a href="git-read-tree.html">git-read-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1526</dt>
1527<dd>
1528<p>
1529 Reads tree information into the index.
1530</p>
1531</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1532<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1533<a href="git-symbolic-ref.html">git-symbolic-ref(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1534</dt>
1535<dd>
1536<p>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1537 Read and modify symbolic refs.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1538</p>
1539</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1540<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1541<a href="git-unpack-objects.html">git-unpack-objects(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1542</dt>
1543<dd>
1544<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1545 Unpack objects from a packed archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1546</p>
1547</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1548<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1549<a href="git-update-index.html">git-update-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1550</dt>
1551<dd>
1552<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1553 Register file contents in the working tree to the index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1554</p>
1555</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1556<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1557<a href="git-update-ref.html">git-update-ref(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1558</dt>
1559<dd>
1560<p>
1561 Update the object name stored in a ref safely.
1562</p>
1563</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1564<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1565<a href="git-write-tree.html">git-write-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1566</dt>
1567<dd>
1568<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1569 Create a tree object from the current index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1570</p>
1571</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1572</dl></div>
1573<h3 id="_interrogation_commands">Interrogation commands</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1574<div class="dlist"><dl>
1575<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1576<a href="git-cat-file.html">git-cat-file(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1577</dt>
1578<dd>
1579<p>
Junio C Hamano1de75722009-03-26 08:39:38[diff] [blame]1580 Provide content or type and size information for repository objects.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1581</p>
1582</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1583<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1584<a href="git-diff-files.html">git-diff-files(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1585</dt>
1586<dd>
1587<p>
1588 Compares files in the working tree and the index.
1589</p>
1590</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1591<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1592<a href="git-diff-index.html">git-diff-index(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1593</dt>
1594<dd>
1595<p>
1596 Compares content and mode of blobs between the index and repository.
1597</p>
1598</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1599<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1600<a href="git-diff-tree.html">git-diff-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1601</dt>
1602<dd>
1603<p>
1604 Compares the content and mode of blobs found via two tree objects.
1605</p>
1606</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1607<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1608<a href="git-for-each-ref.html">git-for-each-ref(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1609</dt>
1610<dd>
1611<p>
1612 Output information on each ref.
1613</p>
1614</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1615<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1616<a href="git-ls-files.html">git-ls-files(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1617</dt>
1618<dd>
1619<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1620 Show information about files in the index and the working tree.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1621</p>
1622</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1623<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1624<a href="git-ls-remote.html">git-ls-remote(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1625</dt>
1626<dd>
1627<p>
1628 List references in a remote repository.
1629</p>
1630</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1631<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1632<a href="git-ls-tree.html">git-ls-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1633</dt>
1634<dd>
1635<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1636 List the contents of a tree object.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1637</p>
1638</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1639<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1640<a href="git-merge-base.html">git-merge-base(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1641</dt>
1642<dd>
1643<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1644 Find as good common ancestors as possible for a merge.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1645</p>
1646</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1647<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1648<a href="git-name-rev.html">git-name-rev(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1649</dt>
1650<dd>
1651<p>
1652 Find symbolic names for given revs.
1653</p>
1654</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1655<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1656<a href="git-pack-redundant.html">git-pack-redundant(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1657</dt>
1658<dd>
1659<p>
1660 Find redundant pack files.
1661</p>
1662</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1663<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1664<a href="git-rev-list.html">git-rev-list(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1665</dt>
1666<dd>
1667<p>
1668 Lists commit objects in reverse chronological order.
1669</p>
1670</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1671<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1672<a href="git-show-index.html">git-show-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1673</dt>
1674<dd>
1675<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1676 Show packed archive index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1677</p>
1678</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1679<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1680<a href="git-show-ref.html">git-show-ref(1)</a>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]1681</dt>
1682<dd>
1683<p>
1684 List references in a local repository.
1685</p>
1686</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1687<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1688<a href="git-tar-tree.html">git-tar-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1689</dt>
1690<dd>
1691<p>
Junio C Hamano2d7f0272007-11-09 10:03:46[diff] [blame]1692 (deprecated) Create a tar archive of the files in the named tree object.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1693</p>
1694</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1695<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1696<a href="git-unpack-file.html">git-unpack-file(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1697</dt>
1698<dd>
1699<p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1700 Creates a temporary file with a blob&#8217;s contents.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1701</p>
1702</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1703<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1704<a href="git-var.html">git-var(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1705</dt>
1706<dd>
1707<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1708 Show a git logical variable.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1709</p>
1710</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1711<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1712<a href="git-verify-pack.html">git-verify-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1713</dt>
1714<dd>
1715<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1716 Validate packed git archive files.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1717</p>
1718</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1719</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1720<div class="paragraph"><p>In general, the interrogate commands do not touch the files in
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1721the working tree.</p></div>
1722<h3 id="_synching_repositories">Synching repositories</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1723<div class="dlist"><dl>
1724<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1725<a href="git-daemon.html">git-daemon(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1726</dt>
1727<dd>
1728<p>
1729 A really simple server for git repositories.
1730</p>
1731</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1732<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1733<a href="git-fetch-pack.html">git-fetch-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1734</dt>
1735<dd>
1736<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1737 Receive missing objects from another repository.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1738</p>
1739</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1740<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1741<a href="git-http-backend.html">git-http-backend(1)</a>
Junio C Hamano096dde22009-12-26 23:14:11[diff] [blame]1742</dt>
1743<dd>
1744<p>
1745 Server side implementation of Git over HTTP.
1746</p>
1747</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1748<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1749<a href="git-send-pack.html">git-send-pack(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1750</dt>
1751<dd>
1752<p>
Junio C Hamanoee1e4282007-02-04 08:32:04[diff] [blame]1753 Push objects over git protocol to another repository.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1754</p>
1755</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1756<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1757<a href="git-update-server-info.html">git-update-server-info(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1758</dt>
1759<dd>
1760<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1761 Update auxiliary info file to help dumb servers.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1762</p>
1763</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1764</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1765<div class="paragraph"><p>The following are helper commands used by the above; end users
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1766typically do not use them directly.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1767<div class="dlist"><dl>
1768<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1769<a href="git-http-fetch.html">git-http-fetch(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1770</dt>
1771<dd>
1772<p>
1773 Download from a remote git repository via HTTP.
1774</p>
1775</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1776<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1777<a href="git-http-push.html">git-http-push(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1778</dt>
1779<dd>
1780<p>
1781 Push objects over HTTP/DAV to another repository.
1782</p>
1783</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1784<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1785<a href="git-parse-remote.html">git-parse-remote(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1786</dt>
1787<dd>
1788<p>
1789 Routines to help parsing remote repository access parameters.
1790</p>
1791</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1792<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1793<a href="git-receive-pack.html">git-receive-pack(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1794</dt>
1795<dd>
1796<p>
1797 Receive what is pushed into the repository.
1798</p>
1799</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1800<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1801<a href="git-shell.html">git-shell(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1802</dt>
1803<dd>
1804<p>
Junio C Hamano3b4609d2010-09-30 00:04:34[diff] [blame]1805 Restricted login shell for Git-only SSH access.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1806</p>
1807</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1808<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1809<a href="git-upload-archive.html">git-upload-archive(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1810</dt>
1811<dd>
1812<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1813 Send archive back to git-archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1814</p>
1815</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1816<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1817<a href="git-upload-pack.html">git-upload-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1818</dt>
1819<dd>
1820<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1821 Send objects packed back to git-fetch-pack.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1822</p>
1823</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1824</dl></div>
1825<h3 id="_internal_helper_commands">Internal helper commands</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1826<div class="paragraph"><p>These are internal helper commands used by other commands; end
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1827users typically do not use them directly.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1828<div class="dlist"><dl>
1829<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1830<a href="git-check-attr.html">git-check-attr(1)</a>
Junio C Hamanoe90436a2007-04-22 07:22:13[diff] [blame]1831</dt>
1832<dd>
1833<p>
Junio C Hamano9bd39c42008-11-13 01:54:44[diff] [blame]1834 Display gitattributes information.
Junio C Hamanoe90436a2007-04-22 07:22:13[diff] [blame]1835</p>
1836</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1837<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1838<a href="git-check-ref-format.html">git-check-ref-format(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1839</dt>
1840<dd>
1841<p>
Junio C Hamano1de75722009-03-26 08:39:38[diff] [blame]1842 Ensures that a reference name is well formed.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1843</p>
1844</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1845<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1846<a href="git-column.html">git-column(1)</a>
Junio C Hamano22700fb2012-05-03 23:07:25[diff] [blame]1847</dt>
1848<dd>
1849<p>
1850 Display data in columns.
1851</p>
1852</dd>
1853<dt class="hdlist1">
Junio C Hamano62e79372012-08-08 22:53:35[diff] [blame^]1854<a href="git-credential.html">git-credential(1)</a>
1855</dt>
1856<dd>
1857<p>
1858 Retrieve and store user credentials.
1859</p>
1860</dd>
1861<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1862<a href="git-fmt-merge-msg.html">git-fmt-merge-msg(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1863</dt>
1864<dd>
1865<p>
1866 Produce a merge commit message.
1867</p>
1868</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1869<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1870<a href="git-mailinfo.html">git-mailinfo(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1871</dt>
1872<dd>
1873<p>
1874 Extracts patch and authorship from a single e-mail message.
1875</p>
1876</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1877<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1878<a href="git-mailsplit.html">git-mailsplit(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1879</dt>
1880<dd>
1881<p>
1882 Simple UNIX mbox splitter program.
1883</p>
1884</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1885<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1886<a href="git-merge-one-file.html">git-merge-one-file(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1887</dt>
1888<dd>
1889<p>
1890 The standard helper program to use with git-merge-index.
1891</p>
1892</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1893<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1894<a href="git-patch-id.html">git-patch-id(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1895</dt>
1896<dd>
1897<p>
1898 Compute unique ID for a patch.
1899</p>
1900</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1901<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1902<a href="git-peek-remote.html">git-peek-remote(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1903</dt>
1904<dd>
1905<p>
Junio C Hamano9d2bbb72007-11-25 04:56:07[diff] [blame]1906 (deprecated) List the references in a remote repository.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1907</p>
1908</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1909<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1910<a href="git-sh-setup.html">git-sh-setup(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1911</dt>
1912<dd>
1913<p>
1914 Common git shell script setup code.
1915</p>
1916</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1917<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1918<a href="git-stripspace.html">git-stripspace(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1919</dt>
1920<dd>
1921<p>
Junio C Hamano0df92712011-12-21 22:30:44[diff] [blame]1922 Remove unnecessary whitespace.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1923</p>
1924</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1925</dl></div>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1926</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1927<h2 id="_configuration_mechanism">Configuration Mechanism</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1928<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1929<div class="paragraph"><p>Starting from 0.99.9 (actually mid 0.99.8.GIT), <tt>.git/config</tt> file
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1930is used to hold per-repository configuration options. It is a
Junio C Hamano51c2ab02006-07-09 20:38:54[diff] [blame]1931simple text file modeled after <tt>.ini</tt> format familiar to some
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1932people. Here is an example:</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1933<div class="listingblock">
1934<div class="content">
1935<pre><tt>#
1936# A '#' or ';' character indicates a comment.
1937#
1938
1939; core variables
1940[core]
1941 ; Don't trust file modes
1942 filemode = false
1943
1944; user identity
1945[user]
1946 name = "Junio C Hamano"
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1947 email = "junkio@twinsun.com"</tt></pre>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1948</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1949<div class="paragraph"><p>Various commands read from the configuration file and adjust
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1950their operation accordingly. See <a href="git-config.html">git-config(1)</a> for a
Junio C Hamano4aa0bcc2010-03-03 05:13:12[diff] [blame]1951list.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1952</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1953<h2 id="_identifier_terminology">Identifier Terminology</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1954<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1955<div class="dlist"><dl>
1956<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1957&lt;object&gt;
1958</dt>
1959<dd>
1960<p>
1961 Indicates the object name for any type of object.
1962</p>
1963</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1964<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1965&lt;blob&gt;
1966</dt>
1967<dd>
1968<p>
1969 Indicates a blob object name.
1970</p>
1971</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1972<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1973&lt;tree&gt;
1974</dt>
1975<dd>
1976<p>
1977 Indicates a tree object name.
1978</p>
1979</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1980<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1981&lt;commit&gt;
1982</dt>
1983<dd>
1984<p>
1985 Indicates a commit object name.
1986</p>
1987</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1988<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1989&lt;tree-ish&gt;
1990</dt>
1991<dd>
1992<p>
1993 Indicates a tree, commit or tag object name. A
1994 command that takes a &lt;tree-ish&gt; argument ultimately wants to
1995 operate on a &lt;tree&gt; object but automatically dereferences
1996 &lt;commit&gt; and &lt;tag&gt; objects that point at a &lt;tree&gt;.
1997</p>
1998</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1999<dt class="hdlist1">
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]2000&lt;commit-ish&gt;
2001</dt>
2002<dd>
2003<p>
2004 Indicates a commit or tag object name. A
2005 command that takes a &lt;commit-ish&gt; argument ultimately wants to
2006 operate on a &lt;commit&gt; object but automatically dereferences
2007 &lt;tag&gt; objects that point at a &lt;commit&gt;.
2008</p>
2009</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2010<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2011&lt;type&gt;
2012</dt>
2013<dd>
2014<p>
2015 Indicates that an object type is required.
2016 Currently one of: <tt>blob</tt>, <tt>tree</tt>, <tt>commit</tt>, or <tt>tag</tt>.
2017</p>
2018</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2019<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2020&lt;file&gt;
2021</dt>
2022<dd>
2023<p>
2024 Indicates a filename - almost always relative to the
2025 root of the tree structure <tt>GIT_INDEX_FILE</tt> describes.
2026</p>
2027</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2028</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2029</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2030<h2 id="_symbolic_identifiers">Symbolic Identifiers</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2031<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2032<div class="paragraph"><p>Any git command accepting any &lt;object&gt; can also use the following
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2033symbolic notation:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2034<div class="dlist"><dl>
2035<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2036HEAD
2037</dt>
2038<dd>
2039<p>
Junio C Hamano360e3a12011-07-13 23:51:56[diff] [blame]2040 indicates the head of the current branch.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2041</p>
2042</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2043<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2044&lt;tag&gt;
2045</dt>
2046<dd>
2047<p>
2048 a valid tag <em>name</em>
Junio C Hamano360e3a12011-07-13 23:51:56[diff] [blame]2049 (i.e. a <tt>refs/tags/&lt;tag&gt;</tt> reference).
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2050</p>
2051</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2052<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2053&lt;head&gt;
2054</dt>
2055<dd>
2056<p>
2057 a valid head <em>name</em>
Junio C Hamano360e3a12011-07-13 23:51:56[diff] [blame]2058 (i.e. a <tt>refs/heads/&lt;head&gt;</tt> reference).
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2059</p>
2060</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2061</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2062<div class="paragraph"><p>For a more complete list of ways to spell object names, see
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2063"SPECIFYING REVISIONS" section in <a href="gitrevisions.html">gitrevisions(7)</a>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2064</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2065<h2 id="_file_directory_structure">File/Directory Structure</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2066<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2067<div class="paragraph"><p>Please see the <a href="gitrepository-layout.html">gitrepository-layout(5)</a> document.</p></div>
2068<div class="paragraph"><p>Read <a href="githooks.html">githooks(5)</a> for more details about each hook.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2069<div class="paragraph"><p>Higher level SCMs may provide and manage additional information in the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2070<tt>$GIT_DIR</tt>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2071</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2072<h2 id="_terminology">Terminology</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2073<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2074<div class="paragraph"><p>Please see <a href="gitglossary.html">gitglossary(7)</a>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2075</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2076<h2 id="_environment_variables">Environment Variables</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2077<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2078<div class="paragraph"><p>Various git commands use the following environment variables:</p></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2079<h3 id="_the_git_repository">The git Repository</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2080<div class="paragraph"><p>These environment variables apply to <em>all</em> core git commands. Nb: it
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2081is worth noting that they may be used/overridden by SCMS sitting above
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2082git so take care if using Cogito etc.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2083<div class="dlist"><dl>
2084<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2085<em>GIT_INDEX_FILE</em>
2086</dt>
2087<dd>
2088<p>
2089 This environment allows the specification of an alternate
2090 index file. If not specified, the default of <tt>$GIT_DIR/index</tt>
2091 is used.
2092</p>
2093</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2094<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2095<em>GIT_OBJECT_DIRECTORY</em>
2096</dt>
2097<dd>
2098<p>
2099 If the object storage directory is specified via this
2100 environment variable then the sha1 directories are created
2101 underneath - otherwise the default <tt>$GIT_DIR/objects</tt>
2102 directory is used.
2103</p>
2104</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2105<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2106<em>GIT_ALTERNATE_OBJECT_DIRECTORIES</em>
2107</dt>
2108<dd>
2109<p>
2110 Due to the immutable nature of git objects, old objects can be
2111 archived into shared, read-only directories. This variable
Junio C Hamano05bf9c52008-07-03 09:21:58[diff] [blame]2112 specifies a ":" separated (on Windows ";" separated) list
2113 of git object directories which can be used to search for git
2114 objects. New objects will not be written to these directories.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2115</p>
2116</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2117<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2118<em>GIT_DIR</em>
2119</dt>
2120<dd>
2121<p>
2122 If the <em>GIT_DIR</em> environment variable is set then it
2123 specifies a path to use instead of the default <tt>.git</tt>
2124 for the base of the repository.
2125</p>
2126</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2127<dt class="hdlist1">
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]2128<em>GIT_WORK_TREE</em>
2129</dt>
2130<dd>
2131<p>
2132 Set the path to the working tree. The value will not be
2133 used in combination with repositories found automatically in
2134 a .git directory (i.e. $GIT_DIR is not set).
2135 This can also be controlled by the <em>--work-tree</em> command line
2136 option and the core.worktree configuration variable.
2137</p>
2138</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2139<dt class="hdlist1">
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]2140<em>GIT_NAMESPACE</em>
2141</dt>
2142<dd>
2143<p>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2144 Set the git namespace; see <a href="gitnamespaces.html">gitnamespaces(7)</a> for details.
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]2145 The <em>--namespace</em> command-line option also sets this value.
2146</p>
2147</dd>
2148<dt class="hdlist1">
Junio C Hamano15048272008-07-07 22:10:48[diff] [blame]2149<em>GIT_CEILING_DIRECTORIES</em>
2150</dt>
2151<dd>
2152<p>
2153 This should be a colon-separated list of absolute paths.
2154 If set, it is a list of directories that git should not chdir
2155 up into while looking for a repository directory.
2156 It will not exclude the current working directory or
2157 a GIT_DIR set on the command line or in the environment.
2158 (Useful for excluding slow-loading network directories.)
2159</p>
2160</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2161<dt class="hdlist1">
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]2162<em>GIT_DISCOVERY_ACROSS_FILESYSTEM</em>
2163</dt>
2164<dd>
2165<p>
2166 When run in a directory that does not have ".git" repository
2167 directory, git tries to find such a directory in the parent
2168 directories to find the top of the working tree, but by default it
2169 does not cross filesystem boundaries. This environment variable
2170 can be set to true to tell git not to stop at filesystem
2171 boundaries. Like <em>GIT_CEILING_DIRECTORIES</em>, this will not affect
2172 an explicit repository directory set via <em>GIT_DIR</em> or on the
2173 command line.
2174</p>
2175</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2176</dl></div>
2177<h3 id="_git_commits">git Commits</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2178<div class="dlist"><dl>
2179<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2180<em>GIT_AUTHOR_NAME</em>
2181</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2182<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2183<em>GIT_AUTHOR_EMAIL</em>
2184</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2185<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2186<em>GIT_AUTHOR_DATE</em>
2187</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2188<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2189<em>GIT_COMMITTER_NAME</em>
2190</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2191<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2192<em>GIT_COMMITTER_EMAIL</em>
2193</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2194<dt class="hdlist1">
Junio C Hamano469d60e2007-04-29 18:30:34[diff] [blame]2195<em>GIT_COMMITTER_DATE</em>
2196</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2197<dt class="hdlist1">
Junio C Hamano469d60e2007-04-29 18:30:34[diff] [blame]2198<em>EMAIL</em>
2199</dt>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2200<dd>
2201<p>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2202 see <a href="git-commit-tree.html">git-commit-tree(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2203</p>
2204</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2205</dl></div>
2206<h3 id="_git_diffs">git Diffs</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2207<div class="dlist"><dl>
2208<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2209<em>GIT_DIFF_OPTS</em>
2210</dt>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2211<dd>
2212<p>
2213 Only valid setting is "--unified=??" or "-u??" to set the
2214 number of context lines shown when a unified diff is created.
2215 This takes precedence over any "-U" or "--unified" option
2216 value passed on the git diff command line.
2217</p>
2218</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2219<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2220<em>GIT_EXTERNAL_DIFF</em>
2221</dt>
2222<dd>
2223<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2224 When the environment variable <em>GIT_EXTERNAL_DIFF</em> is set, the
2225 program named by it is called, instead of the diff invocation
2226 described above. For a path that is added, removed, or modified,
2227 <em>GIT_EXTERNAL_DIFF</em> is called with 7 parameters:
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2228</p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2229<div class="literalblock">
2230<div class="content">
2231<pre><tt>path old-file old-hex old-mode new-file new-hex new-mode</tt></pre>
2232</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2233<div class="paragraph"><p>where:</p></div>
2234</dd>
2235<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2236&lt;old|new&gt;-file
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2237</dt>
2238<dd>
2239<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2240are files GIT_EXTERNAL_DIFF can use to read the
2241 contents of &lt;old|new&gt;,
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2242</p>
2243</dd>
2244<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2245&lt;old|new&gt;-hex
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2246</dt>
2247<dd>
2248<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2249are the 40-hexdigit SHA1 hashes,
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2250</p>
2251</dd>
2252<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2253&lt;old|new&gt;-mode
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2254</dt>
2255<dd>
2256<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2257are the octal representation of the file modes.
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2258</p>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2259<div class="paragraph"><p>The file parameters can point at the user&#8217;s working file
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2260(e.g. <tt>new-file</tt> in "git-diff-files"), <tt>/dev/null</tt> (e.g. <tt>old-file</tt>
2261when a new file is added), or a temporary file (e.g. <tt>old-file</tt> in the
2262index). <em>GIT_EXTERNAL_DIFF</em> should not worry about unlinking the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2263temporary file --- it is removed when <em>GIT_EXTERNAL_DIFF</em> exits.</p></div>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2264<div class="paragraph"><p>For a path that is unmerged, <em>GIT_EXTERNAL_DIFF</em> is called with 1
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2265parameter, &lt;path&gt;.</p></div>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2266</dd>
2267</dl></div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2268<h3 id="_other">other</h3><div style="clear:left"></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2269<div class="dlist"><dl>
2270<dt class="hdlist1">
Junio C Hamano1e6e0062007-07-13 05:33:25[diff] [blame]2271<em>GIT_MERGE_VERBOSITY</em>
2272</dt>
2273<dd>
2274<p>
2275 A number controlling the amount of output shown by
2276 the recursive merge strategy. Overrides merge.verbosity.
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2277 See <a href="git-merge.html">git-merge(1)</a>
Junio C Hamano1e6e0062007-07-13 05:33:25[diff] [blame]2278</p>
2279</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2280<dt class="hdlist1">
Junio C Hamano85e45fa2006-08-13 07:47:41[diff] [blame]2281<em>GIT_PAGER</em>
2282</dt>
2283<dd>
2284<p>
Junio C Hamanof6002a92007-07-20 10:28:22[diff] [blame]2285 This environment variable overrides <tt>$PAGER</tt>. If it is set
2286 to an empty string or to the value "cat", git will not launch
Junio C Hamano0551f6a2008-08-25 00:33:33[diff] [blame]2287 a pager. See also the <tt>core.pager</tt> option in
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2288 <a href="git-config.html">git-config(1)</a>.
Junio C Hamano85e45fa2006-08-13 07:47:41[diff] [blame]2289</p>
2290</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2291<dt class="hdlist1">
Junio C Hamano0ff98162012-03-31 18:19:09[diff] [blame]2292<em>GIT_EDITOR</em>
2293</dt>
2294<dd>
2295<p>
2296 This environment variable overrides <tt>$EDITOR</tt> and <tt>$VISUAL</tt>.
Junio C Hamano010705a2012-06-19 23:37:26[diff] [blame]2297 It is used by several git commands when, on interactive mode,
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2298 an editor is to be launched. See also <a href="git-var.html">git-var(1)</a>
2299 and the <tt>core.editor</tt> option in <a href="git-config.html">git-config(1)</a>.
Junio C Hamano0ff98162012-03-31 18:19:09[diff] [blame]2300</p>
2301</dd>
2302<dt class="hdlist1">
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2303<em>GIT_SSH</em>
2304</dt>
2305<dd>
2306<p>
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]2307 If this environment variable is set then <em>git fetch</em>
2308 and <em>git push</em> will use this command instead
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2309 of <em>ssh</em> when they need to connect to a remote system.
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]2310 The <em>$GIT_SSH</em> command will be given exactly two arguments:
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2311 the <em>username@host</em> (or just <em>host</em>) from the URL and the
2312 shell command to execute on that remote system.
2313</p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2314<div class="paragraph"><p>To pass options to the program that you want to list in GIT_SSH
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2315you will need to wrap the program and options into a shell script,
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2316then set GIT_SSH to refer to the shell script.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2317<div class="paragraph"><p>Usually it is easier to configure any desired options through your
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2318personal <tt>.ssh/config</tt> file. Please consult your ssh documentation
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2319for further details.</p></div>
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2320</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2321<dt class="hdlist1">
Junio C Hamano3fd7b262010-09-08 22:44:20[diff] [blame]2322<em>GIT_ASKPASS</em>
2323</dt>
2324<dd>
2325<p>
2326 If this environment variable is set, then git commands which need to
2327 acquire passwords or passphrases (e.g. for HTTP or IMAP authentication)
2328 will call this program with a suitable prompt as command line argument
2329 and read the password from its STDOUT. See also the <em>core.askpass</em>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2330 option in <a href="git-config.html">git-config(1)</a>.
Junio C Hamano3fd7b262010-09-08 22:44:20[diff] [blame]2331</p>
2332</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2333<dt class="hdlist1">
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]2334<em>GIT_FLUSH</em>
2335</dt>
2336<dd>
2337<p>
2338 If this environment variable is set to "1", then commands such
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]2339 as <em>git blame</em> (in incremental mode), <em>git rev-list</em>, <em>git log</em>,
2340 and <em>git whatchanged</em> will force a flush of the output stream
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]2341 after each commit-oriented record have been flushed. If this
2342 variable is set to "0", the output of these commands will be done
2343 using completely buffered I/O. If this environment variable is
2344 not set, git will choose buffered or record-oriented flushing
2345 based on whether stdout appears to be redirected to a file or not.
2346</p>
2347</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2348<dt class="hdlist1">
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2349<em>GIT_TRACE</em>
2350</dt>
2351<dd>
2352<p>
Junio C Hamanoef4b48b2006-09-04 10:08:34[diff] [blame]2353 If this variable is set to "1", "2" or "true" (comparison
2354 is case insensitive), git will print <tt>trace:</tt> messages on
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2355 stderr telling about alias expansion, built-in command
2356 execution and external command execution.
Junio C Hamanoef4b48b2006-09-04 10:08:34[diff] [blame]2357 If this variable is set to an integer value greater than 1
2358 and lower than 10 (strictly) then git will interpret this
2359 value as an open file descriptor and will try to write the
2360 trace messages into this file descriptor.
2361 Alternatively, if this variable is set to an absolute path
2362 (starting with a <em>/</em> character), git will interpret this
2363 as a file path and will try to write the trace messages
2364 into it.
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2365</p>
2366</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2367</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2368</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2369<h2 id="_discussion_a_id_discussion_a">Discussion<a id="Discussion"></a></h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2370<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2371<div class="paragraph"><p>More detail on the following is available from the
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2372<a href="user-manual.html#git-concepts">git concepts chapter of the
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2373user-manual</a> and <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2374<div class="paragraph"><p>A git project normally consists of a working directory with a ".git"
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2375subdirectory at the top level. The .git directory contains, among other
2376things, a compressed object database representing the complete history
2377of the project, an "index" file which links that history to the current
2378contents of the working tree, and named pointers into that history such
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2379as tags and branch heads.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2380<div class="paragraph"><p>The object database contains objects of three main types: blobs, which
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2381hold file data; trees, which point to blobs and other trees to build up
Junio C Hamanofe986052007-12-19 07:33:38[diff] [blame]2382directory hierarchies; and commits, which each reference a single tree
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2383and some number of parent commits.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2384<div class="paragraph"><p>The commit, equivalent to what other systems call a "changeset" or
2385"version", represents a step in the project&#8217;s history, and each parent
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2386represents an immediately preceding step. Commits with more than one
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2387parent represent merges of independent lines of development.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2388<div class="paragraph"><p>All objects are named by the SHA1 hash of their contents, normally
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2389written as a string of 40 hex digits. Such names are globally unique.
2390The entire history leading up to a commit can be vouched for by signing
2391just that commit. A fourth object type, the tag, is provided for this
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2392purpose.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2393<div class="paragraph"><p>When first created, objects are stored in individual files, but for
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2394efficiency may later be compressed together into "pack files".</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2395<div class="paragraph"><p>Named pointers called refs mark interesting points in history. A ref
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2396may contain the SHA1 name of an object or the name of another ref. Refs
2397with names beginning <tt>ref/head/</tt> contain the SHA1 name of the most
Junio C Hamanofe986052007-12-19 07:33:38[diff] [blame]2398recent commit (or "head") of a branch under development. SHA1 names of
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2399tags of interest are stored under <tt>ref/tags/</tt>. A special ref named
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2400<tt>HEAD</tt> contains the name of the currently checked-out branch.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2401<div class="paragraph"><p>The index file is initialized with a list of all paths and, for each
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2402path, a blob object and a set of attributes. The blob object represents
2403the contents of the file as of the head of the current branch. The
2404attributes (last modified time, size, etc.) are taken from the
2405corresponding file in the working tree. Subsequent changes to the
2406working tree can be found by comparing these attributes. The index may
2407be updated with new content, and new commits may be created from the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2408content stored in the index.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2409<div class="paragraph"><p>The index is also capable of storing multiple entries (called "stages")
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2410for a given pathname. These stages are used to hold the various
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2411unmerged version of a file when a merge is in progress.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2412</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2413<h2 id="_authors">Authors</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2414<div class="sectionbody">
Junio C Hamano5f3d8392011-03-15 23:33:35[diff] [blame]2415<div class="paragraph"><p>Git was started by Linus Torvalds, and is currently maintained by Junio
2416C Hamano. Numerous contributions have come from the git mailing list
2417&lt;<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>&gt;. For a more complete list of contributors, see
2418<a href="http://git-scm.com/about">http://git-scm.com/about</a>. If you have a clone of git.git itself, the
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2419output of <a href="git-shortlog.html">git-shortlog(1)</a> and <a href="git-blame.html">git-blame(1)</a> can show you
Junio C Hamano5f3d8392011-03-15 23:33:35[diff] [blame]2420the authors for specific parts of the project.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2421</div>
Junio C Hamanoa9788762010-08-03 15:15:54[diff] [blame]2422<h2 id="_reporting_bugs">Reporting Bugs</h2>
2423<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2424<div class="paragraph"><p>Report bugs to the Git mailing list &lt;<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>&gt; where the
Junio C Hamanoa9788762010-08-03 15:15:54[diff] [blame]2425development and maintenance is primarily done. You do not have to be
2426subscribed to the list to send a message there.</p></div>
2427</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2428<h2 id="_see_also">SEE ALSO</h2>
Junio C Hamano9e1793f2008-06-02 07:31:16[diff] [blame]2429<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2430<div class="paragraph"><p><a href="gittutorial.html">gittutorial(7)</a>, <a href="gittutorial-2.html">gittutorial-2(7)</a>,
2431<a href="everyday.html">Everyday Git</a>, <a href="gitcvs-migration.html">gitcvs-migration(7)</a>,
2432<a href="gitglossary.html">gitglossary(7)</a>, <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a>,
2433<a href="gitcli.html">gitcli(7)</a>, <a href="user-manual.html">The Git User&#8217;s Manual</a>,
2434<a href="gitworkflows.html">gitworkflows(7)</a></p></div>
Junio C Hamano9e1793f2008-06-02 07:31:16[diff] [blame]2435</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2436<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2437<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2438<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2439</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]2440</div>
2441<div id="footnotes"><hr /></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2442<div id="footer">
2443<div id="footer-text">
Junio C Hamano62e79372012-08-08 22:53:35[diff] [blame^]2444Last updated 2012-07-30 15:07:04 PDT
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2445</div>
2446</div>
2447</body>
2448</html>