Google Git
Sign in
chromium / external / gitster / git-htmldocs / 9c51287ade5d1699ed5919c11c57eb1f9236d1ef / . / git.html
blob: 7196aad773cb8dd64aca080d80d8caa329e19574 [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>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]5<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]6<meta name="generator" content="AsciiDoc 8.6.9" />
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">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]9/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
10
11/* Default font. */
12body {
13 font-family: Georgia,serif;
14}
15
16/* Title font. */
17h1, h2, h3, h4, h5, h6,
18div.title, caption.title,
19thead, p.table.header,
20#toctitle,
21#author, #revnumber, #revdate, #revremark,
22#footer {
23 font-family: Arial,Helvetica,sans-serif;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]24}
25
26body {
27 margin: 1em 5% 1em 5%;
28}
29
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]30a {
31 color: blue;
32 text-decoration: underline;
33}
34a:visited {
35 color: fuchsia;
36}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]37
38em {
39 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]40 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]41}
42
43strong {
44 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]45 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]46}
47
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]48h1, h2, h3, h4, h5, h6 {
49 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]50 margin-top: 1.2em;
51 margin-bottom: 0.5em;
52 line-height: 1.3;
53}
54
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]55h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]56 border-bottom: 2px solid silver;
57}
58h2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]59 padding-top: 0.5em;
60}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]61h3 {
62 float: left;
63}
64h3 + * {
65 clear: left;
66}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]67h5 {
68 font-size: 1.0em;
69}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]70
71div.sectionbody {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]72 margin-left: 0;
73}
74
75hr {
76 border: 1px solid silver;
77}
78
79p {
80 margin-top: 0.5em;
81 margin-bottom: 0.5em;
82}
83
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]84ul, ol, li > p {
85 margin-top: 0;
86}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]87ul > li { color: #aaa; }
88ul > li > * { color: black; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]89
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]90.monospaced, code, pre {
91 font-family: "Courier New", Courier, monospace;
92 font-size: inherit;
93 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]94 padding: 0;
95 margin: 0;
96}
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]97pre {
98 white-space: pre-wrap;
99}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]100
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]101#author {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]102 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]103 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]104 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]105}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]106#email {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]107}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]108#revnumber, #revdate, #revremark {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]109}
110
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]111#footer {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]112 font-size: small;
113 border-top: 2px solid silver;
114 padding-top: 0.5em;
115 margin-top: 4.0em;
116}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]117#footer-text {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]118 float: left;
119 padding-bottom: 0.5em;
120}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]121#footer-badges {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]122 float: right;
123 padding-bottom: 0.5em;
124}
125
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]126#preamble {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]127 margin-top: 1.5em;
128 margin-bottom: 1.5em;
129}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]130div.imageblock, div.exampleblock, div.verseblock,
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]131div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
132div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]133 margin-top: 1.0em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]134 margin-bottom: 1.5em;
135}
136div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]137 margin-top: 2.0em;
138 margin-bottom: 2.0em;
139 margin-right: 10%;
140 color: #606060;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]141}
142
143div.content { /* Block element content. */
144 padding: 0;
145}
146
147/* Block element titles. */
148div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]149 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]150 font-weight: bold;
151 text-align: left;
152 margin-top: 1.0em;
153 margin-bottom: 0.5em;
154}
155div.title + * {
156 margin-top: 0;
157}
158
159td div.title:first-child {
160 margin-top: 0.0em;
161}
162div.content div.title:first-child {
163 margin-top: 0.0em;
164}
165div.content + div.title {
166 margin-top: 0.0em;
167}
168
169div.sidebarblock > div.content {
170 background: #ffffee;
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]171 border: 1px solid #dddddd;
172 border-left: 4px solid #f0f0f0;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]173 padding: 0.5em;
174}
175
176div.listingblock > div.content {
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]177 border: 1px solid #dddddd;
178 border-left: 5px solid #f0f0f0;
179 background: #f8f8f8;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]180 padding: 0.5em;
181}
182
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]183div.quoteblock, div.verseblock {
184 padding-left: 1.0em;
185 margin-left: 1.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]186 margin-right: 10%;
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]187 border-left: 5px solid #f0f0f0;
188 color: #888;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]189}
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]190
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]191div.quoteblock > div.attribution {
192 padding-top: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]193 text-align: right;
194}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]195
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]196div.verseblock > pre.content {
197 font-family: inherit;
198 font-size: inherit;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]199}
200div.verseblock > div.attribution {
201 padding-top: 0.75em;
202 text-align: left;
203}
204/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]205div.verseblock + div.attribution {
206 text-align: left;
207}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]208
209div.admonitionblock .icon {
210 vertical-align: top;
211 font-size: 1.1em;
212 font-weight: bold;
213 text-decoration: underline;
214 color: #527bbd;
215 padding-right: 0.5em;
216}
217div.admonitionblock td.content {
218 padding-left: 0.5em;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]219 border-left: 3px solid #dddddd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]220}
221
222div.exampleblock > div.content {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]223 border-left: 3px solid #dddddd;
224 padding-left: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]225}
226
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]227div.imageblock div.content { padding-left: 0; }
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]228span.image img { border-style: none; vertical-align: text-bottom; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]229a.image:visited { color: white; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]230
231dl {
232 margin-top: 0.8em;
233 margin-bottom: 0.8em;
234}
235dt {
236 margin-top: 0.5em;
237 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]238 font-style: normal;
239 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]240}
241dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]242 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]243}
244
245ul, ol {
246 list-style-position: outside;
247}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]248ol.arabic {
249 list-style-type: decimal;
250}
251ol.loweralpha {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]252 list-style-type: lower-alpha;
253}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]254ol.upperalpha {
255 list-style-type: upper-alpha;
256}
257ol.lowerroman {
258 list-style-type: lower-roman;
259}
260ol.upperroman {
261 list-style-type: upper-roman;
262}
263
264div.compact ul, div.compact ol,
265div.compact p, div.compact p,
266div.compact div, div.compact div {
267 margin-top: 0.1em;
268 margin-bottom: 0.1em;
269}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]270
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]271tfoot {
272 font-weight: bold;
273}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]274td > div.verse {
275 white-space: pre;
276}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]277
278div.hdlist {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]279 margin-top: 0.8em;
280 margin-bottom: 0.8em;
281}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]282div.hdlist tr {
283 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]284}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]285dt.hdlist1.strong, td.hdlist1.strong {
286 font-weight: bold;
287}
288td.hdlist1 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]289 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]290 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]291 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]292 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]293}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]294td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]295 vertical-align: top;
296}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]297div.hdlist.compact tr {
298 margin: 0;
299 padding-bottom: 0;
300}
301
302.comment {
303 background: yellow;
304}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]305
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]306.footnote, .footnoteref {
307 font-size: 0.8em;
308}
309
310span.footnote, span.footnoteref {
311 vertical-align: super;
312}
313
314#footnotes {
315 margin: 20px 0 20px 0;
316 padding: 7px 0 0 0;
317}
318
319#footnotes div.footnote {
320 margin: 0 0 5px 0;
321}
322
323#footnotes hr {
324 border: none;
325 border-top: 1px solid silver;
326 height: 1px;
327 text-align: left;
328 margin-left: 0;
329 width: 20%;
330 min-width: 100px;
331}
332
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]333div.colist td {
334 padding-right: 0.5em;
335 padding-bottom: 0.3em;
336 vertical-align: top;
337}
338div.colist td img {
339 margin-top: 0.3em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]340}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]341
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]342@media print {
343 #footer-badges { display: none; }
344}
345
346#toc {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]347 margin-bottom: 2.5em;
348}
349
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]350#toctitle {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]351 color: #527bbd;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]352 font-size: 1.1em;
353 font-weight: bold;
354 margin-top: 1.0em;
355 margin-bottom: 0.1em;
356}
357
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]358div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]359 margin-top: 0;
360 margin-bottom: 0;
361}
362div.toclevel2 {
363 margin-left: 2em;
364 font-size: 0.9em;
365}
366div.toclevel3 {
367 margin-left: 4em;
368 font-size: 0.9em;
369}
370div.toclevel4 {
371 margin-left: 6em;
372 font-size: 0.9em;
373}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]374
375span.aqua { color: aqua; }
376span.black { color: black; }
377span.blue { color: blue; }
378span.fuchsia { color: fuchsia; }
379span.gray { color: gray; }
380span.green { color: green; }
381span.lime { color: lime; }
382span.maroon { color: maroon; }
383span.navy { color: navy; }
384span.olive { color: olive; }
385span.purple { color: purple; }
386span.red { color: red; }
387span.silver { color: silver; }
388span.teal { color: teal; }
389span.white { color: white; }
390span.yellow { color: yellow; }
391
392span.aqua-background { background: aqua; }
393span.black-background { background: black; }
394span.blue-background { background: blue; }
395span.fuchsia-background { background: fuchsia; }
396span.gray-background { background: gray; }
397span.green-background { background: green; }
398span.lime-background { background: lime; }
399span.maroon-background { background: maroon; }
400span.navy-background { background: navy; }
401span.olive-background { background: olive; }
402span.purple-background { background: purple; }
403span.red-background { background: red; }
404span.silver-background { background: silver; }
405span.teal-background { background: teal; }
406span.white-background { background: white; }
407span.yellow-background { background: yellow; }
408
409span.big { font-size: 2em; }
410span.small { font-size: 0.6em; }
411
412span.underline { text-decoration: underline; }
413span.overline { text-decoration: overline; }
414span.line-through { text-decoration: line-through; }
415
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]416div.unbreakable { page-break-inside: avoid; }
417
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]418
419/*
420 * xhtml11 specific
421 *
422 * */
423
424div.tableblock {
425 margin-top: 1.0em;
426 margin-bottom: 1.5em;
427}
428div.tableblock > table {
429 border: 3px solid #527bbd;
430}
431thead, p.table.header {
432 font-weight: bold;
433 color: #527bbd;
434}
435p.table {
436 margin-top: 0;
437}
438/* Because the table frame attribute is overriden by CSS in most browsers. */
439div.tableblock > table[frame="void"] {
440 border-style: none;
441}
442div.tableblock > table[frame="hsides"] {
443 border-left-style: none;
444 border-right-style: none;
445}
446div.tableblock > table[frame="vsides"] {
447 border-top-style: none;
448 border-bottom-style: none;
449}
450
451
452/*
453 * html5 specific
454 *
455 * */
456
457table.tableblock {
458 margin-top: 1.0em;
459 margin-bottom: 1.5em;
460}
461thead, p.tableblock.header {
462 font-weight: bold;
463 color: #527bbd;
464}
465p.tableblock {
466 margin-top: 0;
467}
468table.tableblock {
469 border-width: 3px;
470 border-spacing: 0px;
471 border-style: solid;
472 border-color: #527bbd;
473 border-collapse: collapse;
474}
475th.tableblock, td.tableblock {
476 border-width: 1px;
477 padding: 4px;
478 border-style: solid;
479 border-color: #527bbd;
480}
481
482table.tableblock.frame-topbot {
483 border-left-style: hidden;
484 border-right-style: hidden;
485}
486table.tableblock.frame-sides {
487 border-top-style: hidden;
488 border-bottom-style: hidden;
489}
490table.tableblock.frame-none {
491 border-style: hidden;
492}
493
494th.tableblock.halign-left, td.tableblock.halign-left {
495 text-align: left;
496}
497th.tableblock.halign-center, td.tableblock.halign-center {
498 text-align: center;
499}
500th.tableblock.halign-right, td.tableblock.halign-right {
501 text-align: right;
502}
503
504th.tableblock.valign-top, td.tableblock.valign-top {
505 vertical-align: top;
506}
507th.tableblock.valign-middle, td.tableblock.valign-middle {
508 vertical-align: middle;
509}
510th.tableblock.valign-bottom, td.tableblock.valign-bottom {
511 vertical-align: bottom;
512}
513
514
515/*
516 * manpage specific
517 *
518 * */
519
520body.manpage h1 {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]521 padding-top: 0.5em;
522 padding-bottom: 0.5em;
523 border-top: 2px solid silver;
524 border-bottom: 2px solid silver;
525}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]526body.manpage h2 {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]527 border-style: none;
528}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]529body.manpage div.sectionbody {
530 margin-left: 3em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]531}
532
533@media print {
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]534 body.manpage div#toc { display: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]535}
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]536
537
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]538</style>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]539<script type="text/javascript">
540/*<![CDATA[*/
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]541var asciidoc = { // Namespace.
542
543/////////////////////////////////////////////////////////////////////
544// Table Of Contents generator
545/////////////////////////////////////////////////////////////////////
546
547/* Author: Mihai Bazon, September 2002
548 * http://students.infoiasi.ro/~mishoo
549 *
550 * Table Of Content generator
551 * Version: 0.4
552 *
553 * Feel free to use this script under the terms of the GNU General Public
554 * License, as long as you do not remove or alter this notice.
555 */
556
557 /* modified by Troy D. Hanson, September 2006. License: GPL */
558 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
559
560// toclevels = 1..4.
561toc: function (toclevels) {
562
563 function getText(el) {
564 var text = "";
565 for (var i = el.firstChild; i != null; i = i.nextSibling) {
566 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
567 text += i.data;
568 else if (i.firstChild != null)
569 text += getText(i);
570 }
571 return text;
572 }
573
574 function TocEntry(el, text, toclevel) {
575 this.element = el;
576 this.text = text;
577 this.toclevel = toclevel;
578 }
579
580 function tocEntries(el, toclevels) {
581 var result = new Array;
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]582 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]583 // Function that scans the DOM tree for header elements (the DOM2
584 // nodeIterator API would be a better technique but not supported by all
585 // browsers).
586 var iterate = function (el) {
587 for (var i = el.firstChild; i != null; i = i.nextSibling) {
588 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
589 var mo = re.exec(i.tagName);
590 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
591 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
592 }
593 iterate(i);
594 }
595 }
596 }
597 iterate(el);
598 return result;
599 }
600
601 var toc = document.getElementById("toc");
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]602 if (!toc) {
603 return;
604 }
605
606 // Delete existing TOC entries in case we're reloading the TOC.
607 var tocEntriesToRemove = [];
608 var i;
609 for (i = 0; i < toc.childNodes.length; i++) {
610 var entry = toc.childNodes[i];
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]611 if (entry.nodeName.toLowerCase() == 'div'
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]612 && entry.getAttribute("class")
613 && entry.getAttribute("class").match(/^toclevel/))
614 tocEntriesToRemove.push(entry);
615 }
616 for (i = 0; i < tocEntriesToRemove.length; i++) {
617 toc.removeChild(tocEntriesToRemove[i]);
618 }
619
620 // Rebuild TOC entries.
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]621 var entries = tocEntries(document.getElementById("content"), toclevels);
622 for (var i = 0; i < entries.length; ++i) {
623 var entry = entries[i];
624 if (entry.element.id == "")
625 entry.element.id = "_toc_" + i;
626 var a = document.createElement("a");
627 a.href = "#" + entry.element.id;
628 a.appendChild(document.createTextNode(entry.text));
629 var div = document.createElement("div");
630 div.appendChild(a);
631 div.className = "toclevel" + entry.toclevel;
632 toc.appendChild(div);
633 }
634 if (entries.length == 0)
635 toc.parentNode.removeChild(toc);
636},
637
638
639/////////////////////////////////////////////////////////////////////
640// Footnotes generator
641/////////////////////////////////////////////////////////////////////
642
643/* Based on footnote generation code from:
644 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
645 */
646
647footnotes: function () {
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]648 // Delete existing footnote entries in case we're reloading the footnodes.
649 var i;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]650 var noteholder = document.getElementById("footnotes");
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]651 if (!noteholder) {
652 return;
653 }
654 var entriesToRemove = [];
655 for (i = 0; i < noteholder.childNodes.length; i++) {
656 var entry = noteholder.childNodes[i];
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]657 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]658 entriesToRemove.push(entry);
659 }
660 for (i = 0; i < entriesToRemove.length; i++) {
661 noteholder.removeChild(entriesToRemove[i]);
662 }
663
664 // Rebuild footnote entries.
665 var cont = document.getElementById("content");
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]666 var spans = cont.getElementsByTagName("span");
667 var refs = {};
668 var n = 0;
669 for (i=0; i<spans.length; i++) {
670 if (spans[i].className == "footnote") {
671 n++;
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]672 var note = spans[i].getAttribute("data-note");
673 if (!note) {
674 // Use [\s\S] in place of . so multi-line matches work.
675 // Because JavaScript has no s (dotall) regex flag.
676 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
677 spans[i].innerHTML =
678 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
679 "' title='View footnote' class='footnote'>" + n + "</a>]";
680 spans[i].setAttribute("data-note", note);
681 }
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]682 noteholder.innerHTML +=
683 "<div class='footnote' id='_footnote_" + n + "'>" +
684 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
685 n + "</a>. " + note + "</div>";
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]686 var id =spans[i].getAttribute("id");
687 if (id != null) refs["#"+id] = n;
688 }
689 }
690 if (n == 0)
691 noteholder.parentNode.removeChild(noteholder);
692 else {
693 // Process footnoterefs.
694 for (i=0; i<spans.length; i++) {
695 if (spans[i].className == "footnoteref") {
696 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
697 href = href.match(/#.*/)[0]; // Because IE return full URL.
698 n = refs[href];
699 spans[i].innerHTML =
700 "[<a href='#_footnote_" + n +
701 "' title='View footnote' class='footnote'>" + n + "</a>]";
702 }
703 }
704 }
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]705},
706
707install: function(toclevels) {
708 var timerId;
709
710 function reinstall() {
711 asciidoc.footnotes();
712 if (toclevels) {
713 asciidoc.toc(toclevels);
714 }
715 }
716
717 function reinstallAndRemoveTimer() {
718 clearInterval(timerId);
719 reinstall();
720 }
721
722 timerId = setInterval(reinstall, 500);
723 if (document.addEventListener)
724 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
725 else
726 window.onload = reinstallAndRemoveTimer;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]727}
728
729}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]730asciidoc.install();
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]731/*]]>*/
732</script>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]733</head>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]734<body class="manpage">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]735<div id="header">
736<h1>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]737git(1) Manual Page
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]738</h1>
739<h2>NAME</h2>
740<div class="sectionbody">
741<p>git -
742 the stupid content tracker
743</p>
744</div>
745</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]746<div id="content">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]747<div class="sect1">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]748<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]749<div class="sectionbody">
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]750<div class="verseblock">
Junio C Hamano79f4c7c2013-09-20 21:03:37[diff] [blame]751<pre class="content"><em>git</em> [--version] [--help] [-C &lt;path&gt;] [-c &lt;name&gt;=&lt;value&gt;]
Junio C Hamano90ff60f2012-02-20 10:25:14[diff] [blame]752 [--exec-path[=&lt;path&gt;]] [--html-path] [--man-path] [--info-path]
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]753 [-p|--paginate|--no-pager] [--no-replace-objects] [--bare]
754 [--git-dir=&lt;path&gt;] [--work-tree=&lt;path&gt;] [--namespace=&lt;name&gt;]
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]755 &lt;command&gt; [&lt;args&gt;]</pre>
756<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]757</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]758</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]759</div>
760<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]761<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]762<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]763<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]764unusually rich command set that provides both high-level operations
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]765and full access to internals.</p></div>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]766<div class="paragraph"><p>See <a href="gittutorial.html">gittutorial(7)</a> to get started, then see
Junio C Hamano446e30b2014-10-16 21:30:32[diff] [blame]767<a href="giteveryday.html">giteveryday(7)</a> for a useful minimum set of
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]768commands. The <a href="user-manual.html">Git User&#8217;s Manual</a> has a more
769in-depth introduction.</p></div>
770<div class="paragraph"><p>After you mastered the basic concepts, you can come back to this
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]771page to learn what commands Git offers. You can learn more about
772individual Git commands with "git help command". <a href="gitcli.html">gitcli(7)</a>
Junio C Hamanoe1aeb5e2014-06-06 19:16:29[diff] [blame]773manual page gives you an overview of the command-line command syntax.</p></div>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]774<div class="paragraph"><p>Formatted and hyperlinked version of the latest Git documentation
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]775can be viewed at <code>http://git-htmldocs.googlecode.com/git/git.html</code>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]776</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]777</div>
778<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]779<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]780<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]781<div class="dlist"><dl>
782<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]783--version
784</dt>
785<dd>
786<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]787 Prints the Git suite version that the <em>git</em> program came from.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]788</p>
789</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]790<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]791--help
792</dt>
793<dd>
794<p>
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]795 Prints the synopsis and a list of the most commonly used
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]796 commands. If the option <em>--all</em> or <em>-a</em> is given then all
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]797 available commands are printed. If a Git command is named this
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]798 option will bring up the manual page for that command.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]799</p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]800<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]801displayed. See <a href="git-help.html">git-help(1)</a> for more information,
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]802because <code>git --help ...</code> is converted internally into <code>git
803help ...</code>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]804</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]805<dt class="hdlist1">
Junio C Hamano79f4c7c2013-09-20 21:03:37[diff] [blame]806-C &lt;path&gt;
807</dt>
808<dd>
809<p>
810 Run as if git was started in <em>&lt;path&gt;</em> instead of the current working
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]811 directory. When multiple <code>-C</code> options are given, each subsequent
812 non-absolute <code>-C &lt;path&gt;</code> is interpreted relative to the preceding <code>-C
813 &lt;path&gt;</code>.
Junio C Hamano79f4c7c2013-09-20 21:03:37[diff] [blame]814</p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]815<div class="paragraph"><p>This option affects options that expect path name like <code>--git-dir</code> and
816<code>--work-tree</code> in that their interpretations of the path names would be
817made relative to the working directory caused by the <code>-C</code> option. For
Junio C Hamano79f4c7c2013-09-20 21:03:37[diff] [blame]818example the following invocations are equivalent:</p></div>
819<div class="literalblock">
820<div class="content">
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]821<pre><code>git --git-dir=a.git --work-tree=b -C c status
822git --git-dir=c/a.git --work-tree=c/b status</code></pre>
Junio C Hamano79f4c7c2013-09-20 21:03:37[diff] [blame]823</div></div>
824</dd>
825<dt class="hdlist1">
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]826-c &lt;name&gt;=&lt;value&gt;
827</dt>
828<dd>
829<p>
830 Pass a configuration parameter to the command. The value
831 given will override values from configuration files.
832 The &lt;name&gt; is expected in the same format as listed by
833 <em>git config</em> (subkeys separated by dots).
834</p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]835<div class="paragraph"><p>Note that omitting the <code>=</code> in <code>git -c foo.bar ...</code> is allowed and sets
836<code>foo.bar</code> to the boolean true value (just like <code>[foo]bar</code> would in a
837config file). Including the equals but with an empty value (like <code>git -c
838foo.bar= ...</code>) sets <code>foo.bar</code> to the empty string.</p></div>
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]839</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]840<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]841--exec-path[=&lt;path&gt;]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]842</dt>
843<dd>
844<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]845 Path to wherever your core Git programs are installed.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]846 This can also be controlled by setting the GIT_EXEC_PATH
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]847 environment variable. If no path is given, <em>git</em> will print
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]848 the current setting and then exit.
849</p>
850</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]851<dt class="hdlist1">
Junio C Hamanob4a9ede2009-04-08 07:36:32[diff] [blame]852--html-path
853</dt>
854<dd>
855<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]856 Print the path, without trailing slash, where Git&#8217;s HTML
Junio C Hamano5f2627d2011-05-06 20:23:48[diff] [blame]857 documentation is installed and exit.
858</p>
859</dd>
860<dt class="hdlist1">
861--man-path
862</dt>
863<dd>
864<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]865 Print the manpath (see <code>man(1)</code>) for the man pages for
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]866 this version of Git and exit.
Junio C Hamano5f2627d2011-05-06 20:23:48[diff] [blame]867</p>
868</dd>
869<dt class="hdlist1">
870--info-path
871</dt>
872<dd>
873<p>
874 Print the path where the Info files documenting this
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]875 version of Git are installed and exit.
Junio C Hamanob4a9ede2009-04-08 07:36:32[diff] [blame]876</p>
877</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]878<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]879-p
880</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]881<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]882--paginate
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]883</dt>
884<dd>
885<p>
Junio C Hamano4aa0bcc2010-03-03 05:13:12[diff] [blame]886 Pipe all output into <em>less</em> (or if set, $PAGER) if standard
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]887 output is a terminal. This overrides the <code>pager.&lt;cmd&gt;</code>
Junio C Hamano4aa0bcc2010-03-03 05:13:12[diff] [blame]888 configuration options (see the "Configuration Mechanism" section
889 below).
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]890</p>
891</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]892<dt class="hdlist1">
Junio C Hamanocae86272007-08-21 02:20:49[diff] [blame]893--no-pager
894</dt>
895<dd>
896<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]897 Do not pipe Git output into a pager.
Junio C Hamanocae86272007-08-21 02:20:49[diff] [blame]898</p>
899</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]900<dt class="hdlist1">
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]901--git-dir=&lt;path&gt;
902</dt>
903<dd>
904<p>
905 Set the path to the repository. This can also be controlled by
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]906 setting the GIT_DIR environment variable. It can be an absolute
907 path or relative path to current working directory.
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]908</p>
909</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]910<dt class="hdlist1">
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]911--work-tree=&lt;path&gt;
912</dt>
913<dd>
914<p>
Junio C Hamano80d58462011-01-24 22:52:52[diff] [blame]915 Set the path to the working tree. It can be an absolute path
916 or a path relative to the current working directory.
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]917 This can also be controlled by setting the GIT_WORK_TREE
918 environment variable and the core.worktree configuration
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]919 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]920 more detailed discussion).
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]921</p>
922</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]923<dt class="hdlist1">
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]924--namespace=&lt;path&gt;
925</dt>
926<dd>
927<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]928 Set the Git namespace. See <a href="gitnamespaces.html">gitnamespaces(7)</a> for more
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]929 details. Equivalent to setting the <code>GIT_NAMESPACE</code> environment
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]930 variable.
931</p>
932</dd>
933<dt class="hdlist1">
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]934--bare
935</dt>
936<dd>
937<p>
Junio C Hamanoc435b1c2007-08-28 06:25:35[diff] [blame]938 Treat the repository as a bare repository. If GIT_DIR
939 environment is not set, it is set to the current working
940 directory.
Junio C Hamanof870ef82006-07-29 09:10:13[diff] [blame]941</p>
942</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]943<dt class="hdlist1">
Junio C Hamano3d23a0a2009-10-19 08:04:30[diff] [blame]944--no-replace-objects
945</dt>
946<dd>
947<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]948 Do not use replacement refs to replace Git objects. See
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]949 <a href="git-replace.html">git-replace(1)</a> for more information.
Junio C Hamano3d23a0a2009-10-19 08:04:30[diff] [blame]950</p>
951</dd>
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]952<dt class="hdlist1">
953--literal-pathspecs
954</dt>
955<dd>
956<p>
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]957 Treat pathspecs literally (i.e. no globbing, no pathspec magic).
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]958 This is equivalent to setting the <code>GIT_LITERAL_PATHSPECS</code> environment
959 variable to <code>1</code>.
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]960</p>
961</dd>
Junio C Hamanob9acecb2013-10-16 01:18:56[diff] [blame]962<dt class="hdlist1">
963--glob-pathspecs
964</dt>
965<dd>
966<p>
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]967 Add "glob" magic to all pathspec. This is equivalent to setting
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]968 the <code>GIT_GLOB_PATHSPECS</code> environment variable to <code>1</code>. Disabling
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]969 globbing on individual pathspecs can be done using pathspec
Junio C Hamanob9acecb2013-10-16 01:18:56[diff] [blame]970 magic ":(literal)"
971</p>
972</dd>
973<dt class="hdlist1">
974--noglob-pathspecs
975</dt>
976<dd>
977<p>
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]978 Add "literal" magic to all pathspec. This is equivalent to setting
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]979 the <code>GIT_NOGLOB_PATHSPECS</code> environment variable to <code>1</code>. Enabling
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]980 globbing on individual pathspecs can be done using pathspec
Junio C Hamanob9acecb2013-10-16 01:18:56[diff] [blame]981 magic ":(glob)"
982</p>
983</dd>
984<dt class="hdlist1">
985--icase-pathspecs
986</dt>
987<dd>
988<p>
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]989 Add "icase" magic to all pathspec. This is equivalent to setting
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]990 the <code>GIT_ICASE_PATHSPECS</code> environment variable to <code>1</code>.
Junio C Hamanob9acecb2013-10-16 01:18:56[diff] [blame]991</p>
992</dd>
993</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]994</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]995</div>
996<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]997<h2 id="_git_commands">GIT COMMANDS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]998<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]999<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]1000("plumbing") commands.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1001</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1002</div>
1003<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1004<h2 id="_high_level_commands_porcelain">High-level commands (porcelain)</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1005<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1006<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]1007ancillary user utilities.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1008<div class="sect2">
1009<h3 id="_main_porcelain_commands">Main porcelain commands</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1010<div class="dlist"><dl>
1011<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1012<a href="git-add.html">git-add(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1013</dt>
1014<dd>
1015<p>
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]1016 Add file contents to the index.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1017</p>
1018</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1019<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1020<a href="git-am.html">git-am(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1021</dt>
1022<dd>
1023<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1024 Apply a series of patches from a mailbox.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1025</p>
1026</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1027<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1028<a href="git-archive.html">git-archive(1)</a>
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]1029</dt>
1030<dd>
1031<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]1032 Create an archive of files from a named tree.
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]1033</p>
1034</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1035<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1036<a href="git-bisect.html">git-bisect(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1037</dt>
1038<dd>
1039<p>
Junio C Hamano9c512872015-08-12 21:59:25[diff] [blame^]1040 Use binary search to find the commit that introduced a bug.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1041</p>
1042</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1043<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1044<a href="git-branch.html">git-branch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1045</dt>
1046<dd>
1047<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1048 List, create, or delete branches.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1049</p>
1050</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1051<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1052<a href="git-bundle.html">git-bundle(1)</a>
Junio C Hamano6ac2f142007-03-01 01:24:56[diff] [blame]1053</dt>
1054<dd>
1055<p>
1056 Move objects and refs by archive.
1057</p>
1058</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1059<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1060<a href="git-checkout.html">git-checkout(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1061</dt>
1062<dd>
1063<p>
Junio C Hamano823eebb2015-07-10 22:29:34[diff] [blame]1064 Switch branches or restore working tree files.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1065</p>
1066</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1067<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1068<a href="git-cherry-pick.html">git-cherry-pick(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1069</dt>
1070<dd>
1071<p>
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]1072 Apply the changes introduced by some existing commits.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1073</p>
1074</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1075<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1076<a href="git-citool.html">git-citool(1)</a>
Junio C Hamano58784fc2007-06-23 08:48:57[diff] [blame]1077</dt>
1078<dd>
1079<p>
1080 Graphical alternative to git-commit.
1081</p>
1082</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1083<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1084<a href="git-clean.html">git-clean(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1085</dt>
1086<dd>
1087<p>
1088 Remove untracked files from the working tree.
1089</p>
1090</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1091<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1092<a href="git-clone.html">git-clone(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1093</dt>
1094<dd>
1095<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]1096 Clone a repository into a new directory.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1097</p>
1098</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1099<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1100<a href="git-commit.html">git-commit(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1101</dt>
1102<dd>
1103<p>
1104 Record changes to the repository.
1105</p>
1106</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1107<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1108<a href="git-describe.html">git-describe(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1109</dt>
1110<dd>
1111<p>
Junio C Hamano2f797822015-07-01 22:26:23[diff] [blame]1112 Describe a commit using the most recent tag reachable from it.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1113</p>
1114</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1115<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1116<a href="git-diff.html">git-diff(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1117</dt>
1118<dd>
1119<p>
1120 Show changes between commits, commit and working tree, etc.
1121</p>
1122</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1123<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1124<a href="git-fetch.html">git-fetch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1125</dt>
1126<dd>
1127<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1128 Download objects and refs from another repository.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1129</p>
1130</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1131<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1132<a href="git-format-patch.html">git-format-patch(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1133</dt>
1134<dd>
1135<p>
1136 Prepare patches for e-mail submission.
1137</p>
1138</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1139<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1140<a href="git-gc.html">git-gc(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1141</dt>
1142<dd>
1143<p>
1144 Cleanup unnecessary files and optimize the local repository.
1145</p>
1146</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1147<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1148<a href="git-grep.html">git-grep(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1149</dt>
1150<dd>
1151<p>
1152 Print lines matching a pattern.
1153</p>
1154</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1155<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1156<a href="git-gui.html">git-gui(1)</a>
Junio C Hamano58784fc2007-06-23 08:48:57[diff] [blame]1157</dt>
1158<dd>
1159<p>
1160 A portable graphical interface to Git.
1161</p>
1162</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1163<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1164<a href="git-init.html">git-init(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1165</dt>
1166<dd>
1167<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1168 Create an empty Git repository or reinitialize an existing one.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1169</p>
1170</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1171<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1172<a href="git-log.html">git-log(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1173</dt>
1174<dd>
1175<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1176 Show commit logs.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1177</p>
1178</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1179<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1180<a href="git-merge.html">git-merge(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1181</dt>
1182<dd>
1183<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1184 Join two or more development histories together.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1185</p>
1186</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1187<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1188<a href="git-mv.html">git-mv(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1189</dt>
1190<dd>
1191<p>
1192 Move or rename a file, a directory, or a symlink.
1193</p>
1194</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1195<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1196<a href="git-notes.html">git-notes(1)</a>
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]1197</dt>
1198<dd>
1199<p>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]1200 Add or inspect object notes.
Junio C Hamano3b70d3c2009-11-21 17:37:37[diff] [blame]1201</p>
1202</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1203<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1204<a href="git-pull.html">git-pull(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1205</dt>
1206<dd>
1207<p>
Junio C Hamano8401f142013-07-12 22:47:46[diff] [blame]1208 Fetch from and integrate with another repository or a local branch.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1209</p>
1210</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1211<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1212<a href="git-push.html">git-push(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1213</dt>
1214<dd>
1215<p>
1216 Update remote refs along with associated objects.
1217</p>
1218</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1219<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1220<a href="git-rebase.html">git-rebase(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1221</dt>
1222<dd>
1223<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1224 Forward-port local commits to the updated upstream head.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1225</p>
1226</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1227<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1228<a href="git-reset.html">git-reset(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1229</dt>
1230<dd>
1231<p>
1232 Reset current HEAD to the specified state.
1233</p>
1234</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1235<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1236<a href="git-revert.html">git-revert(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1237</dt>
1238<dd>
1239<p>
Junio C Hamano89a57342010-06-22 23:22:55[diff] [blame]1240 Revert some existing commits.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1241</p>
1242</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1243<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1244<a href="git-rm.html">git-rm(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1245</dt>
1246<dd>
1247<p>
1248 Remove files from the working tree and from the index.
1249</p>
1250</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1251<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1252<a href="git-shortlog.html">git-shortlog(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1253</dt>
1254<dd>
1255<p>
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]1256 Summarize <em>git log</em> output.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1257</p>
1258</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1259<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1260<a href="git-show.html">git-show(1)</a>
Junio C Hamano2b135272006-03-18 07:45:42[diff] [blame]1261</dt>
1262<dd>
1263<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1264 Show various types of objects.
Junio C Hamano2b135272006-03-18 07:45:42[diff] [blame]1265</p>
1266</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1267<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1268<a href="git-stash.html">git-stash(1)</a>
Junio C Hamano1d90cb02007-07-03 07:05:31[diff] [blame]1269</dt>
1270<dd>
1271<p>
1272 Stash the changes in a dirty working directory away.
1273</p>
1274</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1275<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1276<a href="git-status.html">git-status(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1277</dt>
1278<dd>
1279<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1280 Show the working tree status.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1281</p>
1282</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1283<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1284<a href="git-submodule.html">git-submodule(1)</a>
Junio C Hamano38b693c2007-06-03 08:40:14[diff] [blame]1285</dt>
1286<dd>
1287<p>
1288 Initialize, update or inspect submodules.
1289</p>
1290</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1291<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1292<a href="git-tag.html">git-tag(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1293</dt>
1294<dd>
1295<p>
Junio C Hamanodb450ba2007-01-21 08:57:14[diff] [blame]1296 Create, list, delete or verify a tag object signed with GPG.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1297</p>
1298</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1299<dt class="hdlist1">
Junio C Hamanob5dd60f2015-07-13 21:48:05[diff] [blame]1300<a href="git-worktree.html">git-worktree(1)</a>
1301</dt>
1302<dd>
1303<p>
Junio C Hamano9c512872015-08-12 21:59:25[diff] [blame^]1304 Manage multiple working trees.
Junio C Hamanob5dd60f2015-07-13 21:48:05[diff] [blame]1305</p>
1306</dd>
1307<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1308<a href="gitk.html">gitk(1)</a>
Junio C Hamano0a16b952007-12-02 18:56:34[diff] [blame]1309</dt>
1310<dd>
1311<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1312 The Git repository browser.
Junio C Hamano0a16b952007-12-02 18:56:34[diff] [blame]1313</p>
1314</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1315</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1316</div>
1317<div class="sect2">
1318<h3 id="_ancillary_commands">Ancillary Commands</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1319<div class="paragraph"><p>Manipulators:</p></div>
1320<div class="dlist"><dl>
1321<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1322<a href="git-config.html">git-config(1)</a>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1323</dt>
1324<dd>
1325<p>
1326 Get and set repository or global options.
1327</p>
1328</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1329<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1330<a href="git-fast-export.html">git-fast-export(1)</a>
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]1331</dt>
1332<dd>
1333<p>
1334 Git data exporter.
1335</p>
1336</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1337<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1338<a href="git-fast-import.html">git-fast-import(1)</a>
Junio C Hamanodfc4ce72007-02-07 23:17:29[diff] [blame]1339</dt>
1340<dd>
1341<p>
Junio C Hamano053827f2007-02-14 07:23:58[diff] [blame]1342 Backend for fast Git data importers.
Junio C Hamanodfc4ce72007-02-07 23:17:29[diff] [blame]1343</p>
1344</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1345<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1346<a href="git-filter-branch.html">git-filter-branch(1)</a>
Junio C Hamanobb0f4042007-07-04 06:41:40[diff] [blame]1347</dt>
1348<dd>
1349<p>
1350 Rewrite branches.
1351</p>
1352</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1353<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1354<a href="git-mergetool.html">git-mergetool(1)</a>
Junio C Hamano103ad7f2007-03-14 11:19:26[diff] [blame]1355</dt>
1356<dd>
1357<p>
1358 Run merge conflict resolution tools to resolve merge conflicts.
1359</p>
1360</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1361<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1362<a href="git-pack-refs.html">git-pack-refs(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1363</dt>
1364<dd>
1365<p>
1366 Pack heads and tags for efficient repository access.
1367</p>
1368</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1369<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1370<a href="git-prune.html">git-prune(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1371</dt>
1372<dd>
1373<p>
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]1374 Prune all unreachable objects from the object database.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1375</p>
1376</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1377<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1378<a href="git-reflog.html">git-reflog(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1379</dt>
1380<dd>
1381<p>
1382 Manage reflog information.
1383</p>
1384</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1385<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1386<a href="git-relink.html">git-relink(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1387</dt>
1388<dd>
1389<p>
1390 Hardlink common objects in local repositories.
1391</p>
1392</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1393<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1394<a href="git-remote.html">git-remote(1)</a>
Junio C Hamano053827f2007-02-14 07:23:58[diff] [blame]1395</dt>
1396<dd>
1397<p>
Junio C Hamano5b3533d2014-02-27 23:07:15[diff] [blame]1398 Manage set of tracked repositories.
Junio C Hamano053827f2007-02-14 07:23:58[diff] [blame]1399</p>
1400</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1401<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1402<a href="git-repack.html">git-repack(1)</a>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1403</dt>
1404<dd>
1405<p>
1406 Pack unpacked objects in a repository.
1407</p>
1408</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1409<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1410<a href="git-replace.html">git-replace(1)</a>
Junio C Hamano55295992009-10-13 09:06:33[diff] [blame]1411</dt>
1412<dd>
1413<p>
1414 Create, list, delete refs to replace objects.
1415</p>
1416</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1417</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1418<div class="paragraph"><p>Interrogators:</p></div>
1419<div class="dlist"><dl>
1420<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1421<a href="git-annotate.html">git-annotate(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1422</dt>
1423<dd>
1424<p>
Junio C Hamano7924d5e2009-03-03 08:28:48[diff] [blame]1425 Annotate file lines with commit information.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1426</p>
1427</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1428<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1429<a href="git-blame.html">git-blame(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1430</dt>
1431<dd>
1432<p>
1433 Show what revision and author last modified each line of a file.
1434</p>
1435</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1436<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1437<a href="git-cherry.html">git-cherry(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1438</dt>
1439<dd>
1440<p>
Junio C Hamano4c8f2d92013-12-13 00:55:42[diff] [blame]1441 Find commits yet to be applied to upstream.
Junio C Hamano4ad294b2007-01-20 02:22:50[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-count-objects.html">git-count-objects(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1446</dt>
1447<dd>
1448<p>
1449 Count unpacked number of objects and their disk consumption.
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-difftool.html">git-difftool(1)</a>
Junio C Hamano3bd66e92009-04-18 06:17:56[diff] [blame]1454</dt>
1455<dd>
1456<p>
1457 Show changes using common diff tools.
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-fsck.html">git-fsck(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1462</dt>
1463<dd>
1464<p>
1465 Verifies the connectivity and validity of the objects in the database.
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-get-tar-commit-id.html">git-get-tar-commit-id(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1470</dt>
1471<dd>
1472<p>
Junio C Hamano393e57f2007-11-20 04:53:25[diff] [blame]1473 Extract commit ID from an archive created using git-archive.
Junio C Hamano4ad294b2007-01-20 02:22:50[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-help.html">git-help(1)</a>
Junio C Hamano58256872007-12-04 08:31:13[diff] [blame]1478</dt>
1479<dd>
1480<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1481 Display help information about Git.
Junio C Hamano58256872007-12-04 08:31:13[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-instaweb.html">git-instaweb(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1486</dt>
1487<dd>
1488<p>
1489 Instantly browse your working repository in gitweb.
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-merge-tree.html">git-merge-tree(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1494</dt>
1495<dd>
1496<p>
1497 Show three-way merge without touching index.
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-rerere.html">git-rerere(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1502</dt>
1503<dd>
1504<p>
1505 Reuse recorded resolution of conflicted merges.
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-rev-parse.html">git-rev-parse(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1510</dt>
1511<dd>
1512<p>
1513 Pick out and massage parameters.
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-show-branch.html">git-show-branch(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1518</dt>
1519<dd>
1520<p>
1521 Show branches and their commits.
1522</p>
1523</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1524<dt class="hdlist1">
Junio C Hamano56121c42014-07-10 23:23:35[diff] [blame]1525<a href="git-verify-commit.html">git-verify-commit(1)</a>
1526</dt>
1527<dd>
1528<p>
1529 Check the GPG signature of commits.
1530</p>
1531</dd>
1532<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1533<a href="git-verify-tag.html">git-verify-tag(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1534</dt>
1535<dd>
1536<p>
Junio C Hamanob1d6e882007-08-11 08:30:16[diff] [blame]1537 Check the GPG signature of tags.
Junio C Hamano1a4e8412005-12-27 08:17:23[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-whatchanged.html">git-whatchanged(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1542</dt>
1543<dd>
1544<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1545 Show logs with difference each commit introduces.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1546</p>
1547</dd>
Junio C Hamano11821ed2011-10-19 18:42:09[diff] [blame]1548<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1549<a href="gitweb.html">gitweb(1)</a>
Junio C Hamano11821ed2011-10-19 18:42:09[diff] [blame]1550</dt>
1551<dd>
1552<p>
1553 Git web interface (web frontend to Git repositories).
1554</p>
1555</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1556</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1557</div>
1558<div class="sect2">
1559<h3 id="_interacting_with_others">Interacting with Others</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1560<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]1561people via patch over e-mail.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1562<div class="dlist"><dl>
1563<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1564<a href="git-archimport.html">git-archimport(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1565</dt>
1566<dd>
1567<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1568 Import an Arch repository into Git.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1569</p>
1570</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1571<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1572<a href="git-cvsexportcommit.html">git-cvsexportcommit(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1573</dt>
1574<dd>
1575<p>
1576 Export a single commit to a CVS checkout.
1577</p>
1578</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1579<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1580<a href="git-cvsimport.html">git-cvsimport(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1581</dt>
1582<dd>
1583<p>
1584 Salvage your data out of another SCM people love to hate.
1585</p>
1586</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1587<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1588<a href="git-cvsserver.html">git-cvsserver(1)</a>
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1589</dt>
1590<dd>
1591<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1592 A CVS server emulator for Git.
Junio C Hamano54559c82006-04-13 07:45:12[diff] [blame]1593</p>
1594</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1595<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1596<a href="git-imap-send.html">git-imap-send(1)</a>
Junio C Hamano52299462006-12-28 00:59:38[diff] [blame]1597</dt>
1598<dd>
1599<p>
Junio C Hamano5cf43ca2008-08-20 09:14:14[diff] [blame]1600 Send a collection of patches from stdin to an IMAP folder.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1601</p>
1602</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1603<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1604<a href="git-p4.html">git-p4(1)</a>
Junio C Hamano4eda1362012-04-23 20:55:49[diff] [blame]1605</dt>
1606<dd>
1607<p>
1608 Import from and submit to Perforce repositories.
1609</p>
1610</dd>
1611<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1612<a href="git-quiltimport.html">git-quiltimport(1)</a>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]1613</dt>
1614<dd>
1615<p>
1616 Applies a quilt patchset onto the current branch.
1617</p>
1618</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1619<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1620<a href="git-request-pull.html">git-request-pull(1)</a>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]1621</dt>
1622<dd>
1623<p>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1624 Generates a summary of pending changes.
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]1625</p>
1626</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1627<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1628<a href="git-send-email.html">git-send-email(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1629</dt>
1630<dd>
1631<p>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1632 Send a collection of patches as emails.
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1633</p>
1634</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1635<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1636<a href="git-svn.html">git-svn(1)</a>
Junio C Hamanob518f452006-08-04 00:18:06[diff] [blame]1637</dt>
1638<dd>
1639<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1640 Bidirectional operation between a Subversion repository and Git.
Junio C Hamanob518f452006-08-04 00:18:06[diff] [blame]1641</p>
1642</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1643</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1644</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1645</div>
1646</div>
1647<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1648<h2 id="_low_level_commands_plumbing">Low-level commands (plumbing)</h2>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1649<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1650<div class="paragraph"><p>Although Git includes its
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1651own porcelain layer, its low-level commands are sufficient to support
1652development of alternative porcelains. Developers of such porcelains
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1653might start by reading about <a href="git-update-index.html">git-update-index(1)</a> and
1654<a href="git-read-tree.html">git-read-tree(1)</a>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1655<div class="paragraph"><p>The interface (input, output, set of options and the semantics)
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1656to these low-level commands are meant to be a lot more stable
1657than Porcelain level commands, because these commands are
1658primarily for scripted use. The interface to Porcelain commands
1659on the other hand are subject to change in order to improve the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1660end user experience.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1661<div class="paragraph"><p>The following description divides
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1662the low-level commands into commands that manipulate objects (in
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1663the repository, index, and working tree), commands that interrogate and
1664compare objects, and commands that move objects and references between
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1665repositories.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1666<div class="sect2">
1667<h3 id="_manipulation_commands">Manipulation commands</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1668<div class="dlist"><dl>
1669<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1670<a href="git-apply.html">git-apply(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1671</dt>
1672<dd>
1673<p>
Junio C Hamano5706e0b2009-11-24 10:54:16[diff] [blame]1674 Apply a patch to files and/or to the index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1675</p>
1676</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1677<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1678<a href="git-checkout-index.html">git-checkout-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1679</dt>
1680<dd>
1681<p>
1682 Copy files from the index to the working tree.
1683</p>
1684</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1685<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1686<a href="git-commit-tree.html">git-commit-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1687</dt>
1688<dd>
1689<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1690 Create a new commit object.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1691</p>
1692</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1693<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1694<a href="git-hash-object.html">git-hash-object(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1695</dt>
1696<dd>
1697<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1698 Compute object ID and optionally creates a blob from a file.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1699</p>
1700</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1701<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1702<a href="git-index-pack.html">git-index-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1703</dt>
1704<dd>
1705<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1706 Build pack index file for an existing packed archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1707</p>
1708</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1709<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1710<a href="git-merge-file.html">git-merge-file(1)</a>
Junio C Hamano1de7bc62006-12-17 19:31:54[diff] [blame]1711</dt>
1712<dd>
1713<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1714 Run a three-way file merge.
Junio C Hamano1de7bc62006-12-17 19:31:54[diff] [blame]1715</p>
1716</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1717<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1718<a href="git-merge-index.html">git-merge-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1719</dt>
1720<dd>
1721<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1722 Run a merge for files needing merging.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1723</p>
1724</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1725<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1726<a href="git-mktag.html">git-mktag(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1727</dt>
1728<dd>
1729<p>
1730 Creates a tag object.
1731</p>
1732</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1733<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1734<a href="git-mktree.html">git-mktree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1735</dt>
1736<dd>
1737<p>
1738 Build a tree-object from ls-tree formatted text.
1739</p>
1740</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1741<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1742<a href="git-pack-objects.html">git-pack-objects(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1743</dt>
1744<dd>
1745<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1746 Create a packed archive of objects.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1747</p>
1748</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1749<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1750<a href="git-prune-packed.html">git-prune-packed(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1751</dt>
1752<dd>
1753<p>
1754 Remove extra objects that are already in pack files.
1755</p>
1756</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1757<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1758<a href="git-read-tree.html">git-read-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1759</dt>
1760<dd>
1761<p>
1762 Reads tree information into the index.
1763</p>
1764</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1765<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1766<a href="git-symbolic-ref.html">git-symbolic-ref(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1767</dt>
1768<dd>
1769<p>
Junio C Hamano4eb2b9c2012-11-15 21:12:29[diff] [blame]1770 Read, modify and delete symbolic refs.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1771</p>
1772</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1773<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1774<a href="git-unpack-objects.html">git-unpack-objects(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1775</dt>
1776<dd>
1777<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1778 Unpack objects from a packed archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1779</p>
1780</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1781<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1782<a href="git-update-index.html">git-update-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1783</dt>
1784<dd>
1785<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1786 Register file contents in the working tree to the index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1787</p>
1788</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1789<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1790<a href="git-update-ref.html">git-update-ref(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1791</dt>
1792<dd>
1793<p>
1794 Update the object name stored in a ref safely.
1795</p>
1796</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1797<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1798<a href="git-write-tree.html">git-write-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1799</dt>
1800<dd>
1801<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1802 Create a tree object from the current index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1803</p>
1804</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1805</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1806</div>
1807<div class="sect2">
1808<h3 id="_interrogation_commands">Interrogation commands</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1809<div class="dlist"><dl>
1810<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1811<a href="git-cat-file.html">git-cat-file(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1812</dt>
1813<dd>
1814<p>
Junio C Hamano1de75722009-03-26 08:39:38[diff] [blame]1815 Provide content or type and size information for repository objects.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1816</p>
1817</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1818<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1819<a href="git-diff-files.html">git-diff-files(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1820</dt>
1821<dd>
1822<p>
1823 Compares files in the working tree and the index.
1824</p>
1825</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1826<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1827<a href="git-diff-index.html">git-diff-index(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1828</dt>
1829<dd>
1830<p>
Junio C Hamano7e590a12013-06-02 23:46:52[diff] [blame]1831 Compare a tree to the working tree or index.
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1832</p>
1833</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1834<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1835<a href="git-diff-tree.html">git-diff-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1836</dt>
1837<dd>
1838<p>
1839 Compares the content and mode of blobs found via two tree objects.
1840</p>
1841</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1842<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1843<a href="git-for-each-ref.html">git-for-each-ref(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1844</dt>
1845<dd>
1846<p>
1847 Output information on each ref.
1848</p>
1849</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1850<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1851<a href="git-ls-files.html">git-ls-files(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1852</dt>
1853<dd>
1854<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1855 Show information about files in the index and the working tree.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1856</p>
1857</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1858<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1859<a href="git-ls-remote.html">git-ls-remote(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1860</dt>
1861<dd>
1862<p>
1863 List references in a remote repository.
1864</p>
1865</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1866<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1867<a href="git-ls-tree.html">git-ls-tree(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1868</dt>
1869<dd>
1870<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1871 List the contents of a tree object.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1872</p>
1873</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1874<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1875<a href="git-merge-base.html">git-merge-base(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1876</dt>
1877<dd>
1878<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1879 Find as good common ancestors as possible for a merge.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1880</p>
1881</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1882<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1883<a href="git-name-rev.html">git-name-rev(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1884</dt>
1885<dd>
1886<p>
1887 Find symbolic names for given revs.
1888</p>
1889</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1890<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1891<a href="git-pack-redundant.html">git-pack-redundant(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1892</dt>
1893<dd>
1894<p>
1895 Find redundant pack files.
1896</p>
1897</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1898<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1899<a href="git-rev-list.html">git-rev-list(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1900</dt>
1901<dd>
1902<p>
1903 Lists commit objects in reverse chronological order.
1904</p>
1905</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1906<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1907<a href="git-show-index.html">git-show-index(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1908</dt>
1909<dd>
1910<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1911 Show packed archive index.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1912</p>
1913</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1914<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1915<a href="git-show-ref.html">git-show-ref(1)</a>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]1916</dt>
1917<dd>
1918<p>
1919 List references in a local repository.
1920</p>
1921</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1922<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1923<a href="git-unpack-file.html">git-unpack-file(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1924</dt>
1925<dd>
1926<p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1927 Creates a temporary file with a blob&#8217;s contents.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1928</p>
1929</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1930<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1931<a href="git-var.html">git-var(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1932</dt>
1933<dd>
1934<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1935 Show a Git logical variable.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1936</p>
1937</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1938<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1939<a href="git-verify-pack.html">git-verify-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1940</dt>
1941<dd>
1942<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1943 Validate packed Git archive files.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1944</p>
1945</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1946</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1947<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]1948the working tree.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1949</div>
1950<div class="sect2">
1951<h3 id="_synching_repositories">Synching repositories</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1952<div class="dlist"><dl>
1953<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1954<a href="git-daemon.html">git-daemon(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1955</dt>
1956<dd>
1957<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1958 A really simple server for Git repositories.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1959</p>
1960</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1961<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1962<a href="git-fetch-pack.html">git-fetch-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1963</dt>
1964<dd>
1965<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1966 Receive missing objects from another repository.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1967</p>
1968</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1969<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1970<a href="git-http-backend.html">git-http-backend(1)</a>
Junio C Hamano096dde22009-12-26 23:14:11[diff] [blame]1971</dt>
1972<dd>
1973<p>
1974 Server side implementation of Git over HTTP.
1975</p>
1976</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1977<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1978<a href="git-send-pack.html">git-send-pack(1)</a>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1979</dt>
1980<dd>
1981<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1982 Push objects over Git protocol to another repository.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1983</p>
1984</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1985<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1986<a href="git-update-server-info.html">git-update-server-info(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1987</dt>
1988<dd>
1989<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]1990 Update auxiliary info file to help dumb servers.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]1991</p>
1992</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1993</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1994<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]1995typically do not use them directly.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1996<div class="dlist"><dl>
1997<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1998<a href="git-http-fetch.html">git-http-fetch(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]1999</dt>
2000<dd>
2001<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2002 Download from a remote Git repository via HTTP.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2003</p>
2004</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2005<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2006<a href="git-http-push.html">git-http-push(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2007</dt>
2008<dd>
2009<p>
2010 Push objects over HTTP/DAV to another repository.
2011</p>
2012</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2013<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2014<a href="git-parse-remote.html">git-parse-remote(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2015</dt>
2016<dd>
2017<p>
2018 Routines to help parsing remote repository access parameters.
2019</p>
2020</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2021<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2022<a href="git-receive-pack.html">git-receive-pack(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2023</dt>
2024<dd>
2025<p>
2026 Receive what is pushed into the repository.
2027</p>
2028</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2029<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2030<a href="git-shell.html">git-shell(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2031</dt>
2032<dd>
2033<p>
Junio C Hamano3b4609d2010-09-30 00:04:34[diff] [blame]2034 Restricted login shell for Git-only SSH access.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2035</p>
2036</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2037<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2038<a href="git-upload-archive.html">git-upload-archive(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]2039</dt>
2040<dd>
2041<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]2042 Send archive back to git-archive.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]2043</p>
2044</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2045<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2046<a href="git-upload-pack.html">git-upload-pack(1)</a>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]2047</dt>
2048<dd>
2049<p>
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]2050 Send objects packed back to git-fetch-pack.
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]2051</p>
2052</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2053</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2054</div>
2055<div class="sect2">
2056<h3 id="_internal_helper_commands">Internal helper commands</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2057<div class="paragraph"><p>These are internal helper commands used by other commands; end
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2058users typically do not use them directly.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2059<div class="dlist"><dl>
2060<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2061<a href="git-check-attr.html">git-check-attr(1)</a>
Junio C Hamanoe90436a2007-04-22 07:22:13[diff] [blame]2062</dt>
2063<dd>
2064<p>
Junio C Hamano9bd39c42008-11-13 01:54:44[diff] [blame]2065 Display gitattributes information.
Junio C Hamanoe90436a2007-04-22 07:22:13[diff] [blame]2066</p>
2067</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2068<dt class="hdlist1">
Junio C Hamano36d52292013-01-25 21:32:36[diff] [blame]2069<a href="git-check-ignore.html">git-check-ignore(1)</a>
2070</dt>
2071<dd>
2072<p>
2073 Debug gitignore / exclude files.
2074</p>
2075</dd>
2076<dt class="hdlist1">
Junio C Hamano58f587a2013-07-22 19:20:59[diff] [blame]2077<a href="git-check-mailmap.html">git-check-mailmap(1)</a>
2078</dt>
2079<dd>
2080<p>
2081 Show canonical names and email addresses of contacts.
2082</p>
2083</dd>
2084<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2085<a href="git-check-ref-format.html">git-check-ref-format(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2086</dt>
2087<dd>
2088<p>
Junio C Hamano1de75722009-03-26 08:39:38[diff] [blame]2089 Ensures that a reference name is well formed.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2090</p>
2091</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2092<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2093<a href="git-column.html">git-column(1)</a>
Junio C Hamano22700fb2012-05-03 23:07:25[diff] [blame]2094</dt>
2095<dd>
2096<p>
2097 Display data in columns.
2098</p>
2099</dd>
2100<dt class="hdlist1">
Junio C Hamano62e79372012-08-08 22:53:35[diff] [blame]2101<a href="git-credential.html">git-credential(1)</a>
2102</dt>
2103<dd>
2104<p>
2105 Retrieve and store user credentials.
2106</p>
2107</dd>
2108<dt class="hdlist1">
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2109<a href="git-credential-cache.html">git-credential-cache(1)</a>
2110</dt>
2111<dd>
2112<p>
2113 Helper to temporarily store passwords in memory.
2114</p>
2115</dd>
2116<dt class="hdlist1">
2117<a href="git-credential-store.html">git-credential-store(1)</a>
2118</dt>
2119<dd>
2120<p>
2121 Helper to store credentials on disk.
2122</p>
2123</dd>
2124<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2125<a href="git-fmt-merge-msg.html">git-fmt-merge-msg(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2126</dt>
2127<dd>
2128<p>
2129 Produce a merge commit message.
2130</p>
2131</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2132<dt class="hdlist1">
Junio C Hamano4c43d652014-10-20 21:14:29[diff] [blame]2133<a href="git-interpret-trailers.html">git-interpret-trailers(1)</a>
2134</dt>
2135<dd>
2136<p>
Junio C Hamanofb5ffde2014-11-04 22:38:56[diff] [blame]2137 help add structured information into commit messages.
Junio C Hamano4c43d652014-10-20 21:14:29[diff] [blame]2138</p>
2139</dd>
2140<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2141<a href="git-mailinfo.html">git-mailinfo(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2142</dt>
2143<dd>
2144<p>
2145 Extracts patch and authorship from a single e-mail message.
2146</p>
2147</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2148<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2149<a href="git-mailsplit.html">git-mailsplit(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2150</dt>
2151<dd>
2152<p>
2153 Simple UNIX mbox splitter program.
2154</p>
2155</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2156<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2157<a href="git-merge-one-file.html">git-merge-one-file(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2158</dt>
2159<dd>
2160<p>
2161 The standard helper program to use with git-merge-index.
2162</p>
2163</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2164<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2165<a href="git-patch-id.html">git-patch-id(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2166</dt>
2167<dd>
2168<p>
2169 Compute unique ID for a patch.
2170</p>
2171</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2172<dt class="hdlist1">
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2173<a href="git-sh-i18n.html">git-sh-i18n(1)</a>
2174</dt>
2175<dd>
2176<p>
2177 Git&#8217;s i18n setup code for shell scripts.
2178</p>
2179</dd>
2180<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2181<a href="git-sh-setup.html">git-sh-setup(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2182</dt>
2183<dd>
2184<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2185 Common Git shell script setup code.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2186</p>
2187</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2188<dt class="hdlist1">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2189<a href="git-stripspace.html">git-stripspace(1)</a>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2190</dt>
2191<dd>
2192<p>
Junio C Hamano0df92712011-12-21 22:30:44[diff] [blame]2193 Remove unnecessary whitespace.
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]2194</p>
2195</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2196</dl></div>
Junio C Hamanob19b4f02006-10-29 20:47:22[diff] [blame]2197</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2198</div>
2199</div>
2200<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2201<h2 id="_configuration_mechanism">Configuration Mechanism</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2202<div class="sectionbody">
Junio C Hamano2da4ac42013-02-19 00:41:17[diff] [blame]2203<div class="paragraph"><p>Git uses a simple text format to store customizations that are per
2204repository and are per user. Such a configuration file may look
2205like this:</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2206<div class="listingblock">
2207<div class="content">
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2208<pre><code>#
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2209# A '#' or ';' character indicates a comment.
2210#
2211
2212; core variables
2213[core]
2214 ; Don't trust file modes
2215 filemode = false
2216
2217; user identity
2218[user]
2219 name = "Junio C Hamano"
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2220 email = "gitster@pobox.com"</code></pre>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2221</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2222<div class="paragraph"><p>Various commands read from the configuration file and adjust
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2223their operation accordingly. See <a href="git-config.html">git-config(1)</a> for a
Junio C Hamano2da4ac42013-02-19 00:41:17[diff] [blame]2224list and more details about the configuration mechanism.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2225</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2226</div>
2227<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2228<h2 id="_identifier_terminology">Identifier Terminology</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2229<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2230<div class="dlist"><dl>
2231<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2232&lt;object&gt;
2233</dt>
2234<dd>
2235<p>
2236 Indicates the object name for any type of object.
2237</p>
2238</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2239<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2240&lt;blob&gt;
2241</dt>
2242<dd>
2243<p>
2244 Indicates a blob object name.
2245</p>
2246</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2247<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2248&lt;tree&gt;
2249</dt>
2250<dd>
2251<p>
2252 Indicates a tree object name.
2253</p>
2254</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2255<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2256&lt;commit&gt;
2257</dt>
2258<dd>
2259<p>
2260 Indicates a commit object name.
2261</p>
2262</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2263<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2264&lt;tree-ish&gt;
2265</dt>
2266<dd>
2267<p>
2268 Indicates a tree, commit or tag object name. A
2269 command that takes a &lt;tree-ish&gt; argument ultimately wants to
2270 operate on a &lt;tree&gt; object but automatically dereferences
2271 &lt;commit&gt; and &lt;tag&gt; objects that point at a &lt;tree&gt;.
2272</p>
2273</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2274<dt class="hdlist1">
Junio C Hamano60f8aa82007-03-06 09:58:26[diff] [blame]2275&lt;commit-ish&gt;
2276</dt>
2277<dd>
2278<p>
2279 Indicates a commit or tag object name. A
2280 command that takes a &lt;commit-ish&gt; argument ultimately wants to
2281 operate on a &lt;commit&gt; object but automatically dereferences
2282 &lt;tag&gt; objects that point at a &lt;commit&gt;.
2283</p>
2284</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2285<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2286&lt;type&gt;
2287</dt>
2288<dd>
2289<p>
2290 Indicates that an object type is required.
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2291 Currently one of: <code>blob</code>, <code>tree</code>, <code>commit</code>, or <code>tag</code>.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2292</p>
2293</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2294<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2295&lt;file&gt;
2296</dt>
2297<dd>
2298<p>
2299 Indicates a filename - almost always relative to the
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2300 root of the tree structure <code>GIT_INDEX_FILE</code> describes.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2301</p>
2302</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2303</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2304</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2305</div>
2306<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2307<h2 id="_symbolic_identifiers">Symbolic Identifiers</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2308<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2309<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]2310symbolic notation:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2311<div class="dlist"><dl>
2312<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2313HEAD
2314</dt>
2315<dd>
2316<p>
Junio C Hamano360e3a12011-07-13 23:51:56[diff] [blame]2317 indicates the head of the current branch.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2318</p>
2319</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2320<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2321&lt;tag&gt;
2322</dt>
2323<dd>
2324<p>
2325 a valid tag <em>name</em>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2326 (i.e. a <code>refs/tags/&lt;tag&gt;</code> reference).
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2327</p>
2328</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2329<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2330&lt;head&gt;
2331</dt>
2332<dd>
2333<p>
2334 a valid head <em>name</em>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2335 (i.e. a <code>refs/heads/&lt;head&gt;</code> reference).
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2336</p>
2337</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2338</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2339<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]2340"SPECIFYING REVISIONS" section in <a href="gitrevisions.html">gitrevisions(7)</a>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2341</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2342</div>
2343<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2344<h2 id="_file_directory_structure">File/Directory Structure</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2345<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2346<div class="paragraph"><p>Please see the <a href="gitrepository-layout.html">gitrepository-layout(5)</a> document.</p></div>
2347<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]2348<div class="paragraph"><p>Higher level SCMs may provide and manage additional information in the
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2349<code>$GIT_DIR</code>.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2350</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2351</div>
2352<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2353<h2 id="_terminology">Terminology</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2354<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2355<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]2356</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2357</div>
2358<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2359<h2 id="_environment_variables">Environment Variables</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2360<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2361<div class="paragraph"><p>Various Git commands use the following environment variables:</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2362<div class="sect2">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2363<h3 id="_the_git_repository">The Git Repository</h3>
2364<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]2365is worth noting that they may be used/overridden by SCMS sitting above
Junio C Hamanod7ed4042015-08-03 19:43:00[diff] [blame]2366Git so take care if using a foreign front-end.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2367<div class="dlist"><dl>
2368<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2369<em>GIT_INDEX_FILE</em>
2370</dt>
2371<dd>
2372<p>
2373 This environment allows the specification of an alternate
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2374 index file. If not specified, the default of <code>$GIT_DIR/index</code>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2375 is used.
2376</p>
2377</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2378<dt class="hdlist1">
Junio C Hamano81703b22014-03-14 22:00:27[diff] [blame]2379<em>GIT_INDEX_VERSION</em>
2380</dt>
2381<dd>
2382<p>
2383 This environment variable allows the specification of an index
2384 version for new repositories. It won&#8217;t affect existing index
Junio C Hamanoef57d1e2015-03-25 21:23:00[diff] [blame]2385 files. By default index file version 2 or 3 is used. See
2386 <a href="git-update-index.html">git-update-index(1)</a> for more information.
Junio C Hamano81703b22014-03-14 22:00:27[diff] [blame]2387</p>
2388</dd>
2389<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2390<em>GIT_OBJECT_DIRECTORY</em>
2391</dt>
2392<dd>
2393<p>
2394 If the object storage directory is specified via this
2395 environment variable then the sha1 directories are created
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2396 underneath - otherwise the default <code>$GIT_DIR/objects</code>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2397 directory is used.
2398</p>
2399</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2400<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2401<em>GIT_ALTERNATE_OBJECT_DIRECTORIES</em>
2402</dt>
2403<dd>
2404<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2405 Due to the immutable nature of Git objects, old objects can be
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2406 archived into shared, read-only directories. This variable
Junio C Hamano05bf9c52008-07-03 09:21:58[diff] [blame]2407 specifies a ":" separated (on Windows ";" separated) list
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2408 of Git object directories which can be used to search for Git
Junio C Hamano05bf9c52008-07-03 09:21:58[diff] [blame]2409 objects. New objects will not be written to these directories.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2410</p>
2411</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2412<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2413<em>GIT_DIR</em>
2414</dt>
2415<dd>
2416<p>
2417 If the <em>GIT_DIR</em> environment variable is set then it
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2418 specifies a path to use instead of the default <code>.git</code>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2419 for the base of the repository.
Junio C Hamano0b0417b2012-12-13 20:35:02[diff] [blame]2420 The <em>--git-dir</em> command-line option also sets this value.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2421</p>
2422</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2423<dt class="hdlist1">
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]2424<em>GIT_WORK_TREE</em>
2425</dt>
2426<dd>
2427<p>
Junio C Hamanof1f5a7b2013-06-11 22:23:52[diff] [blame]2428 Set the path to the root of the working tree.
Junio C Hamanoe1aeb5e2014-06-06 19:16:29[diff] [blame]2429 This can also be controlled by the <em>--work-tree</em> command-line
Junio C Hamanod526ba92007-07-02 00:17:42[diff] [blame]2430 option and the core.worktree configuration variable.
2431</p>
2432</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2433<dt class="hdlist1">
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]2434<em>GIT_NAMESPACE</em>
2435</dt>
2436<dd>
2437<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2438 Set the Git namespace; see <a href="gitnamespaces.html">gitnamespaces(7)</a> for details.
Junio C Hamanof7279012011-08-18 06:13:13[diff] [blame]2439 The <em>--namespace</em> command-line option also sets this value.
2440</p>
2441</dd>
2442<dt class="hdlist1">
Junio C Hamano15048272008-07-07 22:10:48[diff] [blame]2443<em>GIT_CEILING_DIRECTORIES</em>
2444</dt>
2445<dd>
2446<p>
Junio C Hamano68061622013-03-01 22:13:37[diff] [blame]2447 This should be a colon-separated list of absolute paths. If
2448 set, it is a list of directories that Git should not chdir up
2449 into while looking for a repository directory (useful for
2450 excluding slow-loading network directories). It will not
2451 exclude the current working directory or a GIT_DIR set on the
2452 command line or in the environment. Normally, Git has to read
2453 the entries in this list and resolve any symlink that
2454 might be present in order to compare them with the current
2455 directory. However, if even this access is slow, you
2456 can add an empty entry to the list to tell Git that the
2457 subsequent entries are not symlinks and needn&#8217;t be resolved;
2458 e.g.,
2459 <em>GIT_CEILING_DIRECTORIES=/maybe/symlink::/very/slow/non/symlink</em>.
Junio C Hamano15048272008-07-07 22:10:48[diff] [blame]2460</p>
2461</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2462<dt class="hdlist1">
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]2463<em>GIT_DISCOVERY_ACROSS_FILESYSTEM</em>
2464</dt>
2465<dd>
2466<p>
2467 When run in a directory that does not have ".git" repository
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2468 directory, Git tries to find such a directory in the parent
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]2469 directories to find the top of the working tree, but by default it
2470 does not cross filesystem boundaries. This environment variable
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2471 can be set to true to tell Git not to stop at filesystem
Junio C Hamanocc7636a2010-05-21 14:57:53[diff] [blame]2472 boundaries. Like <em>GIT_CEILING_DIRECTORIES</em>, this will not affect
2473 an explicit repository directory set via <em>GIT_DIR</em> or on the
2474 command line.
2475</p>
2476</dd>
Junio C Hamano4cc4a842015-05-11 22:41:02[diff] [blame]2477<dt class="hdlist1">
2478<em>GIT_COMMON_DIR</em>
2479</dt>
2480<dd>
2481<p>
2482 If this variable is set to a path, non-worktree files that are
2483 normally in $GIT_DIR will be taken from this path
2484 instead. Worktree-specific files such as HEAD or index are
2485 taken from $GIT_DIR. See <a href="gitrepository-layout.html">gitrepository-layout(5)</a> and
Junio C Hamano1e4fff22015-07-17 22:44:48[diff] [blame]2486 <a href="git-worktree.html">git-worktree(1)</a> for
Junio C Hamano4cc4a842015-05-11 22:41:02[diff] [blame]2487 details. This variable has lower precedence than other path
2488 variables such as GIT_INDEX_FILE, GIT_OBJECT_DIRECTORY&#8230;
2489</p>
2490</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2491</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2492</div>
2493<div class="sect2">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2494<h3 id="_git_commits">Git Commits</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2495<div class="dlist"><dl>
2496<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2497<em>GIT_AUTHOR_NAME</em>
2498</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2499<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2500<em>GIT_AUTHOR_EMAIL</em>
2501</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2502<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2503<em>GIT_AUTHOR_DATE</em>
2504</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2505<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2506<em>GIT_COMMITTER_NAME</em>
2507</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2508<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2509<em>GIT_COMMITTER_EMAIL</em>
2510</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2511<dt class="hdlist1">
Junio C Hamano469d60e2007-04-29 18:30:34[diff] [blame]2512<em>GIT_COMMITTER_DATE</em>
2513</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2514<dt class="hdlist1">
Junio C Hamano469d60e2007-04-29 18:30:34[diff] [blame]2515<em>EMAIL</em>
2516</dt>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2517<dd>
2518<p>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2519 see <a href="git-commit-tree.html">git-commit-tree(1)</a>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2520</p>
2521</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2522</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2523</div>
2524<div class="sect2">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2525<h3 id="_git_diffs">Git Diffs</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2526<div class="dlist"><dl>
2527<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2528<em>GIT_DIFF_OPTS</em>
2529</dt>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2530<dd>
2531<p>
2532 Only valid setting is "--unified=??" or "-u??" to set the
2533 number of context lines shown when a unified diff is created.
2534 This takes precedence over any "-U" or "--unified" option
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2535 value passed on the Git diff command line.
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2536</p>
2537</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2538<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2539<em>GIT_EXTERNAL_DIFF</em>
2540</dt>
2541<dd>
2542<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2543 When the environment variable <em>GIT_EXTERNAL_DIFF</em> is set, the
2544 program named by it is called, instead of the diff invocation
2545 described above. For a path that is added, removed, or modified,
2546 <em>GIT_EXTERNAL_DIFF</em> is called with 7 parameters:
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2547</p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2548<div class="literalblock">
2549<div class="content">
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2550<pre><code>path old-file old-hex old-mode new-file new-hex new-mode</code></pre>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2551</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2552<div class="paragraph"><p>where:</p></div>
2553</dd>
2554<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2555&lt;old|new&gt;-file
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2556</dt>
2557<dd>
2558<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2559are files GIT_EXTERNAL_DIFF can use to read the
2560 contents of &lt;old|new&gt;,
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2561</p>
2562</dd>
2563<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2564&lt;old|new&gt;-hex
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2565</dt>
2566<dd>
2567<p>
Junio C Hamanoe3f080d2013-04-22 02:27:13[diff] [blame]2568are the 40-hexdigit SHA-1 hashes,
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2569</p>
2570</dd>
2571<dt class="hdlist1">
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2572&lt;old|new&gt;-mode
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2573</dt>
2574<dd>
2575<p>
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2576are the octal representation of the file modes.
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2577</p>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2578<div class="paragraph"><p>The file parameters can point at the user&#8217;s working file
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2579(e.g. <code>new-file</code> in "git-diff-files"), <code>/dev/null</code> (e.g. <code>old-file</code>
2580when a new file is added), or a temporary file (e.g. <code>old-file</code> in the
Junio C Hamano1c437122006-11-28 02:22:25[diff] [blame]2581index). <em>GIT_EXTERNAL_DIFF</em> should not worry about unlinking the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2582temporary file --- it is removed when <em>GIT_EXTERNAL_DIFF</em> exits.</p></div>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2583<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]2584parameter, &lt;path&gt;.</p></div>
Junio C Hamanob1acf022013-12-28 00:33:16[diff] [blame]2585<div class="paragraph"><p>For each path <em>GIT_EXTERNAL_DIFF</em> is called, two environment variables,
2586<em>GIT_DIFF_PATH_COUNTER</em> and <em>GIT_DIFF_PATH_TOTAL</em> are set.</p></div>
2587</dd>
2588<dt class="hdlist1">
2589<em>GIT_DIFF_PATH_COUNTER</em>
2590</dt>
2591<dd>
2592<p>
2593 A 1-based counter incremented by one for every path.
2594</p>
2595</dd>
2596<dt class="hdlist1">
2597<em>GIT_DIFF_PATH_TOTAL</em>
2598</dt>
2599<dd>
2600<p>
2601 The total number of paths.
2602</p>
Junio C Hamanof75a9402011-04-14 23:39:23[diff] [blame]2603</dd>
2604</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2605</div>
2606<div class="sect2">
2607<h3 id="_other">other</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2608<div class="dlist"><dl>
2609<dt class="hdlist1">
Junio C Hamano1e6e0062007-07-13 05:33:25[diff] [blame]2610<em>GIT_MERGE_VERBOSITY</em>
2611</dt>
2612<dd>
2613<p>
2614 A number controlling the amount of output shown by
2615 the recursive merge strategy. Overrides merge.verbosity.
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2616 See <a href="git-merge.html">git-merge(1)</a>
Junio C Hamano1e6e0062007-07-13 05:33:25[diff] [blame]2617</p>
2618</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2619<dt class="hdlist1">
Junio C Hamano85e45fa2006-08-13 07:47:41[diff] [blame]2620<em>GIT_PAGER</em>
2621</dt>
2622<dd>
2623<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2624 This environment variable overrides <code>$PAGER</code>. If it is set
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2625 to an empty string or to the value "cat", Git will not launch
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2626 a pager. See also the <code>core.pager</code> option in
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2627 <a href="git-config.html">git-config(1)</a>.
Junio C Hamano85e45fa2006-08-13 07:47:41[diff] [blame]2628</p>
2629</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2630<dt class="hdlist1">
Junio C Hamano0ff98162012-03-31 18:19:09[diff] [blame]2631<em>GIT_EDITOR</em>
2632</dt>
2633<dd>
2634<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2635 This environment variable overrides <code>$EDITOR</code> and <code>$VISUAL</code>.
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2636 It is used by several Git commands when, on interactive mode,
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2637 an editor is to be launched. See also <a href="git-var.html">git-var(1)</a>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2638 and the <code>core.editor</code> option in <a href="git-config.html">git-config(1)</a>.
Junio C Hamano0ff98162012-03-31 18:19:09[diff] [blame]2639</p>
2640</dd>
2641<dt class="hdlist1">
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2642<em>GIT_SSH</em>
2643</dt>
Junio C Hamanofad84122014-12-05 23:38:06[diff] [blame]2644<dt class="hdlist1">
2645<em>GIT_SSH_COMMAND</em>
2646</dt>
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2647<dd>
2648<p>
Junio C Hamanofad84122014-12-05 23:38:06[diff] [blame]2649 If either of these environment variables is set then <em>git fetch</em>
2650 and <em>git push</em> will use the specified command instead of <em>ssh</em>
2651 when they need to connect to a remote system.
2652 The command will be given exactly two or four arguments: the
2653 <em>username@host</em> (or just <em>host</em>) from the URL and the shell
2654 command to execute on that remote system, optionally preceded by
2655 <em>-p</em> (literally) and the <em>port</em> from the URL when it specifies
2656 something other than the default SSH port.
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2657</p>
Junio C Hamanofad84122014-12-05 23:38:06[diff] [blame]2658<div class="paragraph"><p><code>$GIT_SSH_COMMAND</code> takes precedence over <code>$GIT_SSH</code>, and is interpreted
2659by the shell, which allows additional arguments to be included.
2660<code>$GIT_SSH</code> on the other hand must be just the path to a program
2661(which can be a wrapper shell script, if additional arguments are
2662needed).</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2663<div class="paragraph"><p>Usually it is easier to configure any desired options through your
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2664personal <code>.ssh/config</code> file. Please consult your ssh documentation
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2665for further details.</p></div>
Junio C Hamano4cd1c0e2007-08-06 04:39:14[diff] [blame]2666</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2667<dt class="hdlist1">
Junio C Hamano3fd7b262010-09-08 22:44:20[diff] [blame]2668<em>GIT_ASKPASS</em>
2669</dt>
2670<dd>
2671<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2672 If this environment variable is set, then Git commands which need to
Junio C Hamano3fd7b262010-09-08 22:44:20[diff] [blame]2673 acquire passwords or passphrases (e.g. for HTTP or IMAP authentication)
Junio C Hamanoe1aeb5e2014-06-06 19:16:29[diff] [blame]2674 will call this program with a suitable prompt as command-line argument
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]2675 and read the password from its STDOUT. See also the <em>core.askPass</em>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2676 option in <a href="git-config.html">git-config(1)</a>.
Junio C Hamano3fd7b262010-09-08 22:44:20[diff] [blame]2677</p>
2678</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2679<dt class="hdlist1">
Junio C Hamano6df93d92014-12-22 22:48:09[diff] [blame]2680<em>GIT_TERMINAL_PROMPT</em>
2681</dt>
2682<dd>
2683<p>
2684 If this environment variable is set to <code>0</code>, git will not prompt
2685 on the terminal (e.g., when asking for HTTP authentication).
2686</p>
2687</dd>
2688<dt class="hdlist1">
Junio C Hamanoeec745b2013-01-07 08:08:20[diff] [blame]2689<em>GIT_CONFIG_NOSYSTEM</em>
2690</dt>
2691<dd>
2692<p>
2693 Whether to skip reading settings from the system-wide
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2694 <code>$(prefix)/etc/gitconfig</code> file. This environment variable can
2695 be used along with <code>$HOME</code> and <code>$XDG_CONFIG_HOME</code> to create a
Junio C Hamanoeec745b2013-01-07 08:08:20[diff] [blame]2696 predictable environment for a picky script, or you can set it
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2697 temporarily to avoid using a buggy <code>/etc/gitconfig</code> file while
Junio C Hamanoeec745b2013-01-07 08:08:20[diff] [blame]2698 waiting for someone with sufficient permissions to fix it.
2699</p>
2700</dd>
2701<dt class="hdlist1">
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]2702<em>GIT_FLUSH</em>
2703</dt>
2704<dd>
2705<p>
2706 If this environment variable is set to "1", then commands such
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]2707 as <em>git blame</em> (in incremental mode), <em>git rev-list</em>, <em>git log</em>,
Junio C Hamano0241d052013-08-30 23:52:17[diff] [blame]2708 <em>git check-attr</em> and <em>git check-ignore</em> will
Junio C Hamanoc7102962013-05-29 23:57:17[diff] [blame]2709 force a flush of the output stream after each record have been
2710 flushed. If this
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]2711 variable is set to "0", the output of these commands will be done
2712 using completely buffered I/O. If this environment variable is
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2713 not set, Git will choose buffered or record-oriented flushing
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]2714 based on whether stdout appears to be redirected to a file or not.
2715</p>
2716</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2717<dt class="hdlist1">
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2718<em>GIT_TRACE</em>
2719</dt>
2720<dd>
2721<p>
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2722 Enables general trace messages, e.g. alias expansion, built-in
2723 command execution and external command execution.
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2724</p>
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2725<div class="paragraph"><p>If this variable is set to "1", "2" or "true" (comparison
2726is case insensitive), trace messages will be printed to
2727stderr.</p></div>
2728<div class="paragraph"><p>If the variable is set to an integer value greater than 2
2729and lower than 10 (strictly) then Git will interpret this
2730value as an open file descriptor and will try to write the
2731trace messages into this file descriptor.</p></div>
2732<div class="paragraph"><p>Alternatively, if the variable is set to an absolute path
2733(starting with a <em>/</em> character), Git will interpret this
2734as a file path and will try to write the trace messages
2735into it.</p></div>
2736<div class="paragraph"><p>Unsetting the variable, or setting it to empty, "0" or
2737"false" (case insensitive) disables trace messages.</p></div>
Junio C Hamano7ccb9fd2006-07-15 01:38:40[diff] [blame]2738</dd>
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]2739<dt class="hdlist1">
Junio C Hamanofa1d3492013-06-20 23:39:43[diff] [blame]2740<em>GIT_TRACE_PACK_ACCESS</em>
2741</dt>
2742<dd>
2743<p>
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2744 Enables trace messages for all accesses to any packs. For each
Junio C Hamanofa1d3492013-06-20 23:39:43[diff] [blame]2745 access, the pack file name and an offset in the pack is
2746 recorded. This may be helpful for troubleshooting some
2747 pack-related performance problems.
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2748 See <em>GIT_TRACE</em> for available trace output options.
Junio C Hamanofa1d3492013-06-20 23:39:43[diff] [blame]2749</p>
2750</dd>
2751<dt class="hdlist1">
2752<em>GIT_TRACE_PACKET</em>
2753</dt>
2754<dd>
2755<p>
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2756 Enables trace messages for all packets coming in or out of a
2757 given program. This can help with debugging object negotiation
2758 or other protocol issues. Tracing is turned off at a packet
Junio C Hamanod7ed4042015-08-03 19:43:00[diff] [blame]2759 starting with "PACK" (but see <em>GIT_TRACE_PACKFILE</em> below).
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2760 See <em>GIT_TRACE</em> for available trace output options.
2761</p>
2762</dd>
2763<dt class="hdlist1">
Junio C Hamanod7ed4042015-08-03 19:43:00[diff] [blame]2764<em>GIT_TRACE_PACKFILE</em>
2765</dt>
2766<dd>
2767<p>
2768 Enables tracing of packfiles sent or received by a
2769 given program. Unlike other trace output, this trace is
2770 verbatim: no headers, and no quoting of binary data. You almost
2771 certainly want to direct into a file (e.g.,
2772 <code>GIT_TRACE_PACKFILE=/tmp/my.pack</code>) rather than displaying it on
2773 the terminal or mixing it with other trace output.
2774</p>
2775<div class="paragraph"><p>Note that this is currently only implemented for the client side
2776of clones and fetches.</p></div>
2777</dd>
2778<dt class="hdlist1">
Junio C Hamanodbe51052014-07-22 19:39:51[diff] [blame]2779<em>GIT_TRACE_PERFORMANCE</em>
2780</dt>
2781<dd>
2782<p>
2783 Enables performance related trace messages, e.g. total execution
2784 time of each Git command.
2785 See <em>GIT_TRACE</em> for available trace output options.
2786</p>
2787</dd>
2788<dt class="hdlist1">
2789<em>GIT_TRACE_SETUP</em>
2790</dt>
2791<dd>
2792<p>
2793 Enables trace messages printing the .git, working tree and current
2794 working directory after Git has completed its setup phase.
2795 See <em>GIT_TRACE</em> for available trace output options.
2796</p>
2797</dd>
2798<dt class="hdlist1">
2799<em>GIT_TRACE_SHALLOW</em>
2800</dt>
2801<dd>
2802<p>
2803 Enables trace messages that can help debugging fetching /
2804 cloning of shallow repositories.
2805 See <em>GIT_TRACE</em> for available trace output options.
Junio C Hamanofa1d3492013-06-20 23:39:43[diff] [blame]2806</p>
2807</dd>
2808<dt class="hdlist1">
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]2809GIT_LITERAL_PATHSPECS
2810</dt>
2811<dd>
2812<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2813 Setting this variable to <code>1</code> will cause Git to treat all
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]2814 pathspecs literally, rather than as glob patterns. For example,
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2815 running <code>GIT_LITERAL_PATHSPECS=1 git log -- '*.c'</code> will search
2816 for commits that touch the path <code>*.c</code>, not any paths that the
2817 glob <code>*.c</code> matches. You might want this if you are feeding
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2818 literal paths to Git (e.g., paths previously given to you by
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2819 <code>git ls-tree</code>, <code>--raw</code> diff output, etc).
Junio C Hamanoabad6da2013-01-06 09:06:32[diff] [blame]2820</p>
2821</dd>
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]2822<dt class="hdlist1">
2823GIT_GLOB_PATHSPECS
2824</dt>
2825<dd>
2826<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2827 Setting this variable to <code>1</code> will cause Git to treat all
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]2828 pathspecs as glob patterns (aka "glob" magic).
2829</p>
2830</dd>
2831<dt class="hdlist1">
2832GIT_NOGLOB_PATHSPECS
2833</dt>
2834<dd>
2835<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2836 Setting this variable to <code>1</code> will cause Git to treat all
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]2837 pathspecs as literal (aka "literal" magic).
2838</p>
2839</dd>
2840<dt class="hdlist1">
2841GIT_ICASE_PATHSPECS
2842</dt>
2843<dd>
2844<p>
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2845 Setting this variable to <code>1</code> will cause Git to treat all
Junio C Hamano8eac2682013-09-09 22:35:20[diff] [blame]2846 pathspecs as case-insensitive.
2847</p>
2848</dd>
Junio C Hamanoaef76442013-10-18 22:11:27[diff] [blame]2849<dt class="hdlist1">
2850<em>GIT_REFLOG_ACTION</em>
2851</dt>
2852<dd>
2853<p>
2854 When a ref is updated, reflog entries are created to keep
2855 track of the reason why the ref was updated (which is
2856 typically the name of the high-level command that updated
2857 the ref), in addition to the old and new values of the ref.
2858 A scripted Porcelain command can use set_reflog_action
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2859 helper function in <code>git-sh-setup</code> to set its name to this
Junio C Hamanoaef76442013-10-18 22:11:27[diff] [blame]2860 variable when it is invoked as the top level command by the
2861 end user, to be recorded in the body of the reflog.
2862</p>
2863</dd>
Junio C Hamanoef57d1e2015-03-25 21:23:00[diff] [blame]2864<dt class="hdlist1">
2865<code>GIT_REF_PARANOIA</code>
2866</dt>
2867<dd>
2868<p>
2869 If set to <code>1</code>, include broken or badly named refs when iterating
2870 over lists of refs. In a normal, non-corrupted repository, this
2871 does nothing. However, enabling it may help git to detect and
2872 abort some operations in the presence of broken refs. Git sets
2873 this variable automatically when performing destructive
2874 operations like <a href="git-prune.html">git-prune(1)</a>. You should not need to set
2875 it yourself unless you want to be paranoid about making sure
2876 an operation has touched every ref (e.g., because you are
2877 cloning a repository to make a backup).
2878</p>
2879</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2880</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2881</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2882</div>
2883</div>
2884<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2885<h2 id="_discussion_a_id_discussion_a">Discussion<a id="Discussion"></a></h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2886<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2887<div class="paragraph"><p>More detail on the following is available from the
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2888<a href="user-manual.html#git-concepts">Git concepts chapter of the
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2889user-manual</a> and <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a>.</p></div>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2890<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]2891subdirectory at the top level. The .git directory contains, among other
2892things, a compressed object database representing the complete history
2893of the project, an "index" file which links that history to the current
2894contents of the working tree, and named pointers into that history such
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2895as tags and branch heads.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2896<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]2897hold file data; trees, which point to blobs and other trees to build up
Junio C Hamanofe986052007-12-19 07:33:38[diff] [blame]2898directory hierarchies; and commits, which each reference a single tree
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2899and some number of parent commits.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2900<div class="paragraph"><p>The commit, equivalent to what other systems call a "changeset" or
2901"version", represents a step in the project&#8217;s history, and each parent
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2902represents an immediately preceding step. Commits with more than one
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2903parent represent merges of independent lines of development.</p></div>
Junio C Hamanoe3f080d2013-04-22 02:27:13[diff] [blame]2904<div class="paragraph"><p>All objects are named by the SHA-1 hash of their contents, normally
Junio C Hamano597ffcf2007-09-17 17:33:15[diff] [blame]2905written as a string of 40 hex digits. Such names are globally unique.
2906The entire history leading up to a commit can be vouched for by signing
2907just that commit. A fourth object type, the tag, is provided for this
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2908purpose.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2909<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]2910efficiency may later be compressed together into "pack files".</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2911<div class="paragraph"><p>Named pointers called refs mark interesting points in history. A ref
Junio C Hamanoe3f080d2013-04-22 02:27:13[diff] [blame]2912may contain the SHA-1 name of an object or the name of another ref. Refs
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2913with names beginning <code>ref/head/</code> contain the SHA-1 name of the most
Junio C Hamanoe3f080d2013-04-22 02:27:13[diff] [blame]2914recent commit (or "head") of a branch under development. SHA-1 names of
Junio C Hamanoac12f0e2014-09-19 22:32:51[diff] [blame]2915tags of interest are stored under <code>ref/tags/</code>. A special ref named
2916<code>HEAD</code> contains the name of the currently checked-out branch.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2917<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]2918path, a blob object and a set of attributes. The blob object represents
2919the contents of the file as of the head of the current branch. The
2920attributes (last modified time, size, etc.) are taken from the
2921corresponding file in the working tree. Subsequent changes to the
2922working tree can be found by comparing these attributes. The index may
2923be updated with new content, and new commits may be created from the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2924content stored in the index.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2925<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]2926for a given pathname. These stages are used to hold the various
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2927unmerged version of a file when a merge is in progress.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2928</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2929</div>
2930<div class="sect1">
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2931<h2 id="_further_documentation">FURTHER DOCUMENTATION</h2>
2932<div class="sectionbody">
2933<div class="paragraph"><p>See the references in the "description" section to get started
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2934using Git. The following is probably more detail than necessary
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2935for a first-time user.</p></div>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2936<div class="paragraph"><p>The <a href="user-manual.html#git-concepts">Git concepts chapter of the
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2937user-manual</a> and <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a> both provide
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2938introductions to the underlying Git architecture.</p></div>
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2939<div class="paragraph"><p>See <a href="gitworkflows.html">gitworkflows(7)</a> for an overview of recommended workflows.</p></div>
2940<div class="paragraph"><p>See also the <a href="howto-index.html">howto</a> documents for some useful
2941examples.</p></div>
2942<div class="paragraph"><p>The internals are documented in the
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2943<a href="technical/api-index.html">Git API documentation</a>.</p></div>
Junio C Hamanod0316112012-08-22 19:55:29[diff] [blame]2944<div class="paragraph"><p>Users migrating from CVS may also want to
2945read <a href="gitcvs-migration.html">gitcvs-migration(7)</a>.</p></div>
2946</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2947</div>
2948<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2949<h2 id="_authors">Authors</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2950<div class="sectionbody">
Junio C Hamano5f3d8392011-03-15 23:33:35[diff] [blame]2951<div class="paragraph"><p>Git was started by Linus Torvalds, and is currently maintained by Junio
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]2952C Hamano. Numerous contributions have come from the Git mailing list
Junio C Hamano7b43d412014-07-23 23:09:44[diff] [blame]2953&lt;<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>&gt;. <a href="http://www.openhub.net/p/git/contributors/summary">http://www.openhub.net/p/git/contributors/summary</a>
Junio C Hamano0b0417b2012-12-13 20:35:02[diff] [blame]2954gives you a more complete list of contributors.</p></div>
2955<div class="paragraph"><p>If you have a clone of git.git itself, the
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2956output 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]2957the authors for specific parts of the project.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2958</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2959</div>
2960<div class="sect1">
Junio C Hamanoa9788762010-08-03 15:15:54[diff] [blame]2961<h2 id="_reporting_bugs">Reporting Bugs</h2>
2962<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]2963<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]2964development and maintenance is primarily done. You do not have to be
2965subscribed to the list to send a message there.</p></div>
2966</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2967</div>
2968<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2969<h2 id="_see_also">SEE ALSO</h2>
Junio C Hamano9e1793f2008-06-02 07:31:16[diff] [blame]2970<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2971<div class="paragraph"><p><a href="gittutorial.html">gittutorial(7)</a>, <a href="gittutorial-2.html">gittutorial-2(7)</a>,
Junio C Hamano446e30b2014-10-16 21:30:32[diff] [blame]2972<a href="giteveryday.html">giteveryday(7)</a>, <a href="gitcvs-migration.html">gitcvs-migration(7)</a>,
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2973<a href="gitglossary.html">gitglossary(7)</a>, <a href="gitcore-tutorial.html">gitcore-tutorial(7)</a>,
2974<a href="gitcli.html">gitcli(7)</a>, <a href="user-manual.html">The Git User&#8217;s Manual</a>,
2975<a href="gitworkflows.html">gitworkflows(7)</a></p></div>
Junio C Hamano9e1793f2008-06-02 07:31:16[diff] [blame]2976</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2977</div>
2978<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]2979<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2980<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]2981<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]2982</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]2983</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]2984</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]2985<div id="footnotes"><hr /></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2986<div id="footer">
2987<div id="footer-text">
Junio C Hamanod7ed4042015-08-03 19:43:00[diff] [blame]2988Last updated 2015-08-03 12:41:59 PDT
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]2989</div>
2990</div>
2991</body>
2992</html>