Google Git
Sign in
chromium / external / gitster / git-htmldocs / 103b5722e7729973bb843e748abe7d4c8f8f9a28 / . / gitrepository-layout.html
blob: ee0adcabf05ec97c2d230489c3795e58113f80eb [file] [log] [blame]
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]6<meta name="generator" content="AsciiDoc 8.4.5" />
7<title>gitrepository-layout(5)</title>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]8<style type="text/css">
9/* Debug borders */
10p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
11/*
12 border: 1px solid red;
13*/
14}
15
16body {
17 margin: 1em 5% 1em 5%;
18}
19
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]20a {
21 color: blue;
22 text-decoration: underline;
23}
24a:visited {
25 color: fuchsia;
26}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]27
28em {
29 font-style: italic;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]30 color: navy;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]31}
32
33strong {
34 font-weight: bold;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]35 color: #083194;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]36}
37
38tt {
39 color: navy;
40}
41
42h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
48}
49
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]50h1, h2, h3 {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]51 border-bottom: 2px solid silver;
52}
53h2 {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]54 padding-top: 0.5em;
55}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]56h3 {
57 float: left;
58}
59h3 + * {
60 clear: left;
61}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]62
63div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
66}
67
68hr {
69 border: 1px solid silver;
70}
71
72p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
75}
76
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]77ul, ol, li > p {
78 margin-top: 0;
79}
80
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]81pre {
82 padding: 0;
83 margin: 0;
84}
85
86span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]90 font-size: 1.1em;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]91}
92span#email {
93}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]94span#revnumber, span#revdate, span#revremark {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]95 font-family: sans-serif;
96}
97
98div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
104}
105div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
108}
109div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
112}
113
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]114div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
117}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]118div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120div.admonitionblock {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]121 margin-top: 1.5em;
122 margin-bottom: 1.5em;
123}
124div.admonitionblock {
125 margin-top: 2.5em;
126 margin-bottom: 2.5em;
127}
128
129div.content { /* Block element content. */
130 padding: 0;
131}
132
133/* Block element titles. */
134div.title, caption.title {
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]135 color: #527bbd;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]136 font-family: sans-serif;
137 font-weight: bold;
138 text-align: left;
139 margin-top: 1.0em;
140 margin-bottom: 0.5em;
141}
142div.title + * {
143 margin-top: 0;
144}
145
146td div.title:first-child {
147 margin-top: 0.0em;
148}
149div.content div.title:first-child {
150 margin-top: 0.0em;
151}
152div.content + div.title {
153 margin-top: 0.0em;
154}
155
156div.sidebarblock > div.content {
157 background: #ffffee;
158 border: 1px solid silver;
159 padding: 0.5em;
160}
161
162div.listingblock > div.content {
163 border: 1px solid silver;
164 background: #f4f4f4;
165 padding: 0.5em;
166}
167
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]168div.quoteblock {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]169 padding-left: 2.0em;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]170 margin-right: 10%;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]171}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]172div.quoteblock > div.attribution {
173 padding-top: 0.5em;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]174 text-align: right;
175}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]176
177div.verseblock {
178 padding-left: 2.0em;
179 margin-right: 10%;
180}
181div.verseblock > div.content {
182 white-space: pre;
183}
184div.verseblock > div.attribution {
185 padding-top: 0.75em;
186 text-align: left;
187}
188/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]189div.verseblock + div.attribution {
190 text-align: left;
191}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]192
193div.admonitionblock .icon {
194 vertical-align: top;
195 font-size: 1.1em;
196 font-weight: bold;
197 text-decoration: underline;
198 color: #527bbd;
199 padding-right: 0.5em;
200}
201div.admonitionblock td.content {
202 padding-left: 0.5em;
203 border-left: 2px solid silver;
204}
205
206div.exampleblock > div.content {
207 border-left: 2px solid silver;
208 padding: 0.5em;
209}
210
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]211div.imageblock div.content { padding-left: 0; }
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]212span.image img { border-style: none; }
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]213a.image:visited { color: white; }
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]214
215dl {
216 margin-top: 0.8em;
217 margin-bottom: 0.8em;
218}
219dt {
220 margin-top: 0.5em;
221 margin-bottom: 0;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]222 font-style: normal;
223 color: navy;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]224}
225dd > *:first-child {
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]226 margin-top: 0.1em;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]227}
228
229ul, ol {
230 list-style-position: outside;
231}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]232ol.arabic {
233 list-style-type: decimal;
234}
235ol.loweralpha {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]236 list-style-type: lower-alpha;
237}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]238ol.upperalpha {
239 list-style-type: upper-alpha;
240}
241ol.lowerroman {
242 list-style-type: lower-roman;
243}
244ol.upperroman {
245 list-style-type: upper-roman;
246}
247
248div.compact ul, div.compact ol,
249div.compact p, div.compact p,
250div.compact div, div.compact div {
251 margin-top: 0.1em;
252 margin-bottom: 0.1em;
253}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]254
255div.tableblock > table {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]256 border: 3px solid #527bbd;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]257}
258thead {
259 font-family: sans-serif;
260 font-weight: bold;
261}
262tfoot {
263 font-weight: bold;
264}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]265td > div.verse {
266 white-space: pre;
267}
268p.table {
269 margin-top: 0;
270}
271/* Because the table frame attribute is overriden by CSS in most browsers. */
272div.tableblock > table[frame="void"] {
273 border-style: none;
274}
275div.tableblock > table[frame="hsides"] {
276 border-left-style: none;
277 border-right-style: none;
278}
279div.tableblock > table[frame="vsides"] {
280 border-top-style: none;
281 border-bottom-style: none;
282}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]283
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]284
285div.hdlist {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]286 margin-top: 0.8em;
287 margin-bottom: 0.8em;
288}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]289div.hdlist tr {
290 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]291}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]292dt.hdlist1.strong, td.hdlist1.strong {
293 font-weight: bold;
294}
295td.hdlist1 {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]296 vertical-align: top;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]297 font-style: normal;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]298 padding-right: 0.8em;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]299 color: navy;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]300}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]301td.hdlist2 {
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]302 vertical-align: top;
303}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]304div.hdlist.compact tr {
305 margin: 0;
306 padding-bottom: 0;
307}
308
309.comment {
310 background: yellow;
311}
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]312
313@media print {
314 div#footer-badges { display: none; }
315}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]316
317div#toctitle {
318 color: #527bbd;
319 font-family: sans-serif;
320 font-size: 1.1em;
321 font-weight: bold;
322 margin-top: 1.0em;
323 margin-bottom: 0.1em;
324}
325
326div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
327 margin-top: 0;
328 margin-bottom: 0;
329}
330div.toclevel2 {
331 margin-left: 2em;
332 font-size: 0.9em;
333}
334div.toclevel3 {
335 margin-left: 4em;
336 font-size: 0.9em;
337}
338div.toclevel4 {
339 margin-left: 6em;
340 font-size: 0.9em;
341}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]342/* Overrides for manpage documents */
343h1 {
344 padding-top: 0.5em;
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver;
347 border-bottom: 2px solid silver;
348}
349h2 {
350 border-style: none;
351}
352div.sectionbody {
353 margin-left: 5%;
354}
355
356@media print {
357 div#toc { display: none; }
358}
359
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]360/* Workarounds for IE6's broken and incomplete CSS2. */
361
362div.sidebar-content {
363 background: #ffffee;
364 border: 1px solid silver;
365 padding: 0.5em;
366}
367div.sidebar-title, div.image-title {
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]368 color: #527bbd;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]369 font-family: sans-serif;
370 font-weight: bold;
371 margin-top: 0.0em;
372 margin-bottom: 0.5em;
373}
374
375div.listingblock div.content {
376 border: 1px solid silver;
377 background: #f4f4f4;
378 padding: 0.5em;
379}
380
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]381div.quoteblock-attribution {
382 padding-top: 0.5em;
383 text-align: right;
384}
385
386div.verseblock-content {
387 white-space: pre;
388}
389div.verseblock-attribution {
390 padding-top: 0.75em;
391 text-align: left;
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]392}
393
394div.exampleblock-content {
395 border-left: 2px solid silver;
396 padding-left: 0.5em;
397}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]398
399/* IE6 sets dynamically generated links as visited. */
400div#toc a:visited { color: blue; }
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]401</style>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]402</head>
403<body>
404<div id="header">
405<h1>
406gitrepository-layout(5) Manual Page
407</h1>
408<h2>NAME</h2>
409<div class="sectionbody">
410<p>gitrepository-layout -
411 Git Repository Layout
412</p>
413</div>
414</div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]415<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]416<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]417<div class="paragraph"><p>$GIT_DIR/*</p></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]418</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]419<h2 id="_description">DESCRIPTION</h2>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]420<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]421<div class="paragraph"><p>You may find these things in your git repository (<tt>.git</tt>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]422directory for a repository associated with your working tree, or
423<tt>&lt;project&gt;.git</tt> directory for a public <em>bare</em> repository. It is
424also possible to have a working tree where <tt>.git</tt> is a plain
Junio C Hamano619596a2010-08-18 22:15:35[diff] [blame]425ASCII file containing <tt>gitdir: &lt;path&gt;</tt>, i.e. the path to the
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]426real git repository).</p></div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]427<div class="dlist"><dl>
428<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]429objects
430</dt>
431<dd>
432<p>
433 Object store associated with this repository. Usually
434 an object store is self sufficient (i.e. all the objects
435 that are referred to by an object found in it are also
436 found in it), but there are couple of ways to violate
437 it.
438</p>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]439<div class="olist arabic"><ol class="arabic">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]440<li>
441<p>
442You could populate the repository by running a commit walker
443without <tt>-a</tt> option. Depending on which options are given, you
444could have only commit objects without associated blobs and
445trees this way, for example. A repository with this kind of
446incomplete object store is not suitable to be published to the
447outside world but sometimes useful for private repository.
448</p>
449</li>
450<li>
451<p>
452You also could have an incomplete but locally usable repository
453by cloning shallowly. See <a href="git-clone.html">git-clone(1)</a>.
454</p>
455</li>
456<li>
457<p>
458You can be using <tt>objects/info/alternates</tt> mechanism, or
459<tt>$GIT_ALTERNATE_OBJECT_DIRECTORIES</tt> mechanism to <em>borrow</em>
460objects from other object stores. A repository with this kind
461of incomplete object store is not suitable to be published for
462use with dumb transports but otherwise is OK as long as
463<tt>objects/info/alternates</tt> points at the right object stores
464it borrows from.
465</p>
466</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]467</ol></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]468</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]469<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]470objects/[0-9a-f][0-9a-f]
471</dt>
472<dd>
473<p>
474 Traditionally, each object is stored in its own file.
475 They are split into 256 subdirectories using the first
476 two letters from its object name to keep the number of
477 directory entries <tt>objects</tt> directory itself needs to
478 hold. Objects found here are often called <em>unpacked</em>
479 (or <em>loose</em>) objects.
480</p>
481</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]482<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]483objects/pack
484</dt>
485<dd>
486<p>
487 Packs (files that store many object in compressed form,
488 along with index files to allow them to be randomly
489 accessed) are found in this directory.
490</p>
491</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]492<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]493objects/info
494</dt>
495<dd>
496<p>
497 Additional information about the object store is
498 recorded in this directory.
499</p>
500</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]501<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]502objects/info/packs
503</dt>
504<dd>
505<p>
506 This file is to help dumb transports discover what packs
507 are available in this object store. Whenever a pack is
508 added or removed, <tt>git update-server-info</tt> should be run
509 to keep this file up-to-date if the repository is
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]510 published for dumb transports. <em>git repack</em> does this
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]511 by default.
512</p>
513</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]514<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]515objects/info/alternates
516</dt>
517<dd>
518<p>
519 This file records paths to alternate object stores that
520 this object store borrows objects from, one pathname per
521 line. Note that not only native Git tools use it locally,
522 but the HTTP fetcher also tries to use it remotely; this
523 will usually work if you have relative paths (relative
524 to the object database, not to the repository!) in your
525 alternates file, but it will not work if you use absolute
526 paths unless the absolute path in filesystem and web URL
527 is the same. See also <em>objects/info/http-alternates</em>.
528</p>
529</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]530<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]531objects/info/http-alternates
532</dt>
533<dd>
534<p>
535 This file records URLs to alternate object stores that
536 this object store borrows objects from, to be used when
537 the repository is fetched over HTTP.
538</p>
539</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]540<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]541refs
542</dt>
543<dd>
544<p>
545 References are stored in subdirectories of this
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]546 directory. The <em>git prune</em> command knows to keep
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]547 objects reachable from refs found in this directory and
548 its subdirectories.
549</p>
550</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]551<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]552refs/heads/<tt>name</tt>
553</dt>
554<dd>
555<p>
556 records tip-of-the-tree commit objects of branch <tt>name</tt>
557</p>
558</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]559<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]560refs/tags/<tt>name</tt>
561</dt>
562<dd>
563<p>
564 records any object name (not necessarily a commit
565 object, or a tag object that points at a commit object).
566</p>
567</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]568<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]569refs/remotes/<tt>name</tt>
570</dt>
571<dd>
572<p>
573 records tip-of-the-tree commit objects of branches copied
574 from a remote repository.
575</p>
576</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]577<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]578packed-refs
579</dt>
580<dd>
581<p>
582 records the same information as refs/heads/, refs/tags/,
583 and friends record in a more efficient way. See
584 <a href="git-pack-refs.html">git-pack-refs(1)</a>.
585</p>
586</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]587<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]588HEAD
589</dt>
590<dd>
591<p>
592 A symref (see glossary) to the <tt>refs/heads/</tt> namespace
593 describing the currently active branch. It does not mean
594 much if the repository is not associated with any working tree
595 (i.e. a <em>bare</em> repository), but a valid git repository
596 <strong>must</strong> have the HEAD file; some porcelains may use it to
597 guess the designated "default" branch of the repository
598 (usually <em>master</em>). It is legal if the named branch
599 <em>name</em> does not (yet) exist. In some legacy setups, it is
600 a symbolic link instead of a symref that points at the current
601 branch.
602</p>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]603<div class="paragraph"><p>HEAD can also record a specific commit directly, instead of
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]604being a symref to point at the current branch. Such a state
605is often called <em>detached HEAD</em>, and almost all commands work
606identically as normal. See <a href="git-checkout.html">git-checkout(1)</a> for
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]607details.</p></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]608</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]609<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]610branches
611</dt>
612<dd>
613<p>
614 A slightly deprecated way to store shorthands to be used
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]615 to specify URL to <em>git fetch</em>, <em>git pull</em> and <em>git push</em>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]616 commands is to store a file in <tt>branches/&lt;name&gt;</tt> and
617 give <em>name</em> to these commands in place of <em>repository</em>
618 argument.
619</p>
620</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]621<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]622hooks
623</dt>
624<dd>
625<p>
626 Hooks are customization scripts used by various git
627 commands. A handful of sample hooks are installed when
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]628 <em>git init</em> is run, but all of them are disabled by
Junio C Hamano116db352008-12-17 19:48:40[diff] [blame]629 default. To enable, the <tt>.sample</tt> suffix has to be
630 removed from the filename by renaming.
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]631 Read <a href="githooks.html">githooks(5)</a> for more details about
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]632 each hook.
633</p>
634</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]635<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]636index
637</dt>
638<dd>
639<p>
640 The current index file for the repository. It is
641 usually not found in a bare repository.
642</p>
643</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]644<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]645info
646</dt>
647<dd>
648<p>
649 Additional information about the repository is recorded
650 in this directory.
651</p>
652</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]653<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]654info/refs
655</dt>
656<dd>
657<p>
658 This file helps dumb transports discover what refs are
659 available in this repository. If the repository is
660 published for dumb transports, this file should be
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]661 regenerated by <em>git update-server-info</em> every time a tag
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]662 or branch is created or modified. This is normally done
663 from the <tt>hooks/update</tt> hook, which is run by the
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]664 <em>git-receive-pack</em> command when you <em>git push</em> into the
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]665 repository.
666</p>
667</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]668<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]669info/grafts
670</dt>
671<dd>
672<p>
673 This file records fake commit ancestry information, to
674 pretend the set of parents a commit has is different
675 from how the commit was actually created. One record
676 per line describes a commit and its fake parents by
677 listing their 40-byte hexadecimal object names separated
678 by a space and terminated by a newline.
679</p>
680</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]681<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]682info/exclude
683</dt>
684<dd>
685<p>
686 This file, by convention among Porcelains, stores the
687 exclude pattern list. <tt>.gitignore</tt> is the per-directory
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]688 ignore file. <em>git status</em>, <em>git add</em>, <em>git rm</em> and
689 <em>git clean</em> look at it but the core git commands do not look
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]690 at it. See also: <a href="gitignore.html">gitignore(5)</a>.
691</p>
692</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]693<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]694remotes
695</dt>
696<dd>
697<p>
698 Stores shorthands to be used to give URL and default
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]699 refnames to interact with remote repository to
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]700 <em>git fetch</em>, <em>git pull</em> and <em>git push</em> commands.
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]701</p>
702</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]703<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]704logs
705</dt>
706<dd>
707<p>
708 Records of changes made to refs are stored in this
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]709 directory. See <a href="git-update-ref.html">git-update-ref(1)</a>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]710 for more information.
711</p>
712</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]713<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]714logs/refs/heads/<tt>name</tt>
715</dt>
716<dd>
717<p>
718 Records all changes made to the branch tip named <tt>name</tt>.
719</p>
720</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]721<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]722logs/refs/tags/<tt>name</tt>
723</dt>
724<dd>
725<p>
726 Records all changes made to the tag named <tt>name</tt>.
727</p>
728</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]729<dt class="hdlist1">
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]730shallow
731</dt>
732<dd>
733<p>
734 This is similar to <tt>info/grafts</tt> but is internally used
735 and maintained by shallow clone mechanism. See <tt>--depth</tt>
736 option to <a href="git-clone.html">git-clone(1)</a> and <a href="git-fetch.html">git-fetch(1)</a>.
737</p>
738</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]739</dl></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]740</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]741<h2 id="_see_also">SEE ALSO</h2>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]742<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]743<div class="paragraph"><p><a href="git-init.html">git-init(1)</a>,
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]744<a href="git-clone.html">git-clone(1)</a>,
745<a href="git-fetch.html">git-fetch(1)</a>,
746<a href="git-pack-refs.html">git-pack-refs(1)</a>,
747<a href="git-gc.html">git-gc(1)</a>,
748<a href="git-checkout.html">git-checkout(1)</a>,
749<a href="gitglossary.html">gitglossary(7)</a>,
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]750<a href="user-manual.html">The Git User&#8217;s Manual</a></p></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]751</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]752<h2 id="_git">GIT</h2>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]753<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]754<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite.</p></div>
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]755</div>
756<div id="footer">
757<div id="footer-text">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame^]758Last updated 2010-08-18 22:14:44 UTC
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]759</div>
760</div>
761</body>
762</html>