Google Git
Sign in
chromium / external / gitster / git-htmldocs / ac53020a437dd8086a64cf7d6c673e0a8f5a119c / . / git-pack-refs.html
blob: 66c7775ea2d60359a4bcac979aba3d069694e4e4 [file] [log] [blame]
Junio C Hamanod8c9d432006-11-07 07:19:13[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>git-pack-refs(1)</title>
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamano4604fe52008-09-19 06:37:10[diff] [blame]20a {
21 color: blue;
22 text-decoration: underline;
23}
24a:visited {
25 color: fuchsia;
26}
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]27
28em {
29 font-style: italic;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]30 color: navy;
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]31}
32
33strong {
34 font-weight: bold;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]35 color: #083194;
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamano4604fe52008-09-19 06:37:10[diff] [blame]50h1, h2, h3 {
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]51 border-bottom: 2px solid silver;
52}
53h2 {
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]54 padding-top: 0.5em;
55}
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]56h3 {
57 float: left;
58}
59h3 + * {
60 clear: left;
61}
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamano4604fe52008-09-19 06:37:10[diff] [blame]90 font-size: 1.1em;
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]91}
92span#email {
93}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]94span#revnumber, span#revdate, span#revremark {
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]118div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120div.admonitionblock {
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]169 padding-left: 2.0em;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]170 margin-right: 10%;
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]171}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]172div.quoteblock > div.attribution {
173 padding-top: 0.5em;
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamano4604fe52008-09-19 06:37:10[diff] [blame]189div.verseblock + div.attribution {
190 text-align: left;
191}
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]211div.imageblock div.content { padding-left: 0; }
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]224}
225dd > *:first-child {
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]226 margin-top: 0.1em;
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]254
255div.tableblock > table {
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]256 border: 3px solid #527bbd;
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]283
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]284
285div.hdlist {
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamano4604fe52008-09-19 06:37:10[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]296 vertical-align: top;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]297 font-style: normal;
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]298 padding-right: 0.8em;
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]299 color: navy;
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]300}
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]301td.hdlist2 {
Junio C Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]312
313@media print {
314 div#footer-badges { display: none; }
315}
Junio C Hamano4604fe52008-09-19 06:37:10[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[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 Hamanod8c9d432006-11-07 07:19:13[diff] [blame]392}
393
394div.exampleblock-content {
395 border-left: 2px solid silver;
396 padding-left: 0.5em;
397}
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]398
399/* IE6 sets dynamically generated links as visited. */
400div#toc a:visited { color: blue; }
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]401</style>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]402</head>
403<body>
404<div id="header">
405<h1>
406git-pack-refs(1) Manual Page
407</h1>
408<h2>NAME</h2>
409<div class="sectionbody">
410<p>git-pack-refs -
411 Pack heads and tags for efficient repository access
412</p>
413</div>
414</div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]415<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]416<div class="sectionbody">
Junio C Hamano15567bc2011-07-23 00:51:59[diff] [blame]417<div class="verseblock">
418<div class="verseblock-content"><em>git pack-refs</em> [--all] [--no-prune]</div>
419<div class="verseblock-attribution">
420</div></div>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]421</div>
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]422<h2 id="_description">DESCRIPTION</h2>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]423<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]424<div class="paragraph"><p>Traditionally, tips of branches and tags (collectively known as
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]425<em>refs</em>) were stored one file per ref under <tt>$GIT_DIR/refs</tt>
426directory. While many branch tips tend to be updated often,
427most tags and some branch tips are never updated. When a
428repository has hundreds or thousands of tags, this
429one-file-per-ref format both wastes storage and hurts
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]430performance.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]431<div class="paragraph"><p>This command is used to solve the storage and performance
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]432problem by stashing the refs in a single file,
433<tt>$GIT_DIR/packed-refs</tt>. When a ref is missing from the
434traditional <tt>$GIT_DIR/refs</tt> hierarchy, it is looked up in this
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]435file and used if found.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]436<div class="paragraph"><p>Subsequent updates to branches always create new files under
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]437<tt>$GIT_DIR/refs</tt> hierarchy.</p></div>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]438<div class="paragraph"><p>A recommended practice to deal with a repository with too many
Junio C Hamano42b78672007-01-26 09:44:51[diff] [blame]439refs is to pack its refs with <tt>--all --prune</tt> once, and
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]440occasionally run <tt>git pack-refs --prune</tt>. Tags are by
Junio C Hamano42b78672007-01-26 09:44:51[diff] [blame]441definition stationary and are not expected to change. Branch
442heads will be packed with the initial <tt>pack-refs --all</tt>, but
443only the currently active branch heads will become unpacked,
Junio C Hamanoa6499d72009-04-05 09:18:17[diff] [blame]444and the next <tt>pack-refs</tt> (without <tt>--all</tt>) will leave them
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]445unpacked.</p></div>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]446</div>
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]447<h2 id="_options">OPTIONS</h2>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]448<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]449<div class="dlist"><dl>
450<dt class="hdlist1">
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]451--all
452</dt>
453<dd>
454<p>
Junio C Hamano42b78672007-01-26 09:44:51[diff] [blame]455The command by default packs all tags and refs that are already
456packed, and leaves other refs
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]457alone. This is because branches are expected to be actively
458developed and packing their tips does not help performance.
459This option causes branch tips to be packed as well. Useful for
460a repository with many branches of historical interests.
461</p>
462</dd>
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]463<dt class="hdlist1">
Junio C Hamano1d3a6c72007-01-09 11:13:47[diff] [blame]464--no-prune
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]465</dt>
466<dd>
467<p>
Junio C Hamano1d3a6c72007-01-09 11:13:47[diff] [blame]468The command usually removes loose refs under <tt>$GIT_DIR/refs</tt>
469hierarchy after packing them. This option tells it not to.
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]470</p>
471</dd>
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]472</dl></div>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]473</div>
Junio C Hamano4604fe52008-09-19 06:37:10[diff] [blame]474<h2 id="_git">GIT</h2>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]475<div class="sectionbody">
Junio C Hamano103b5722011-01-31 05:03:45[diff] [blame]476<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]477</div>
478<div id="footer">
479<div id="footer-text">
Junio C Hamano15567bc2011-07-23 00:51:59[diff] [blame]480Last updated 2011-07-23 00:49:30 UTC
Junio C Hamanod8c9d432006-11-07 07:19:13[diff] [blame]481</div>
482</div>
483</body>
484</html>