Google Git
Sign in
chromium / external / gitster / git-htmldocs / 2fbcd210effb63ce172dc7002701b015a4a0f5a2 / . / git-archive.html
blob: 3843276ac5d3de9138720bba70344043d9410384 [file] [log] [blame]
Junio C Hamano781d8a22006-09-17 10:34:15[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" />
6<meta name="generator" content="AsciiDoc 7.0.2" />
7<style type="text/css">
8/* Debug borders */
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10/*
11 border: 1px solid red;
12*/
13}
14
15body {
16 margin: 1em 5% 1em 5%;
17}
18
19a { color: blue; }
20a:visited { color: fuchsia; }
21
22em {
23 font-style: italic;
24}
25
26strong {
27 font-weight: bold;
28}
29
30tt {
31 color: navy;
32}
33
34h1, h2, h3, h4, h5, h6 {
35 color: #527bbd;
36 font-family: sans-serif;
37 margin-top: 1.2em;
38 margin-bottom: 0.5em;
39 line-height: 1.3;
40}
41
42h1 {
43 border-bottom: 2px solid silver;
44}
45h2 {
46 border-bottom: 2px solid silver;
47 padding-top: 0.5em;
48}
49
50div.sectionbody {
51 font-family: serif;
52 margin-left: 0;
53}
54
55hr {
56 border: 1px solid silver;
57}
58
59p {
60 margin-top: 0.5em;
61 margin-bottom: 0.5em;
62}
63
64pre {
65 padding: 0;
66 margin: 0;
67}
68
69span#author {
70 color: #527bbd;
71 font-family: sans-serif;
72 font-weight: bold;
73 font-size: 1.2em;
74}
75span#email {
76}
77span#revision {
78 font-family: sans-serif;
79}
80
81div#footer {
82 font-family: sans-serif;
83 font-size: small;
84 border-top: 2px solid silver;
85 padding-top: 0.5em;
86 margin-top: 4.0em;
87}
88div#footer-text {
89 float: left;
90 padding-bottom: 0.5em;
91}
92div#footer-badges {
93 float: right;
94 padding-bottom: 0.5em;
95}
96
97div#preamble,
98div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
99div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
100div.admonitionblock {
101 margin-right: 10%;
102 margin-top: 1.5em;
103 margin-bottom: 1.5em;
104}
105div.admonitionblock {
106 margin-top: 2.5em;
107 margin-bottom: 2.5em;
108}
109
110div.content { /* Block element content. */
111 padding: 0;
112}
113
114/* Block element titles. */
115div.title, caption.title {
116 font-family: sans-serif;
117 font-weight: bold;
118 text-align: left;
119 margin-top: 1.0em;
120 margin-bottom: 0.5em;
121}
122div.title + * {
123 margin-top: 0;
124}
125
126td div.title:first-child {
127 margin-top: 0.0em;
128}
129div.content div.title:first-child {
130 margin-top: 0.0em;
131}
132div.content + div.title {
133 margin-top: 0.0em;
134}
135
136div.sidebarblock > div.content {
137 background: #ffffee;
138 border: 1px solid silver;
139 padding: 0.5em;
140}
141
142div.listingblock > div.content {
143 border: 1px solid silver;
144 background: #f4f4f4;
145 padding: 0.5em;
146}
147
148div.quoteblock > div.content {
149 padding-left: 2.0em;
150}
151div.quoteblock .attribution {
152 text-align: right;
153}
154
155div.admonitionblock .icon {
156 vertical-align: top;
157 font-size: 1.1em;
158 font-weight: bold;
159 text-decoration: underline;
160 color: #527bbd;
161 padding-right: 0.5em;
162}
163div.admonitionblock td.content {
164 padding-left: 0.5em;
165 border-left: 2px solid silver;
166}
167
168div.exampleblock > div.content {
169 border-left: 2px solid silver;
170 padding: 0.5em;
171}
172
173div.verseblock div.content {
174 white-space: pre;
175}
176
177div.imageblock div.content { padding-left: 0; }
178div.imageblock img { border: 1px solid silver; }
179span.image img { border-style: none; }
180
181dl {
182 margin-top: 0.8em;
183 margin-bottom: 0.8em;
184}
185dt {
186 margin-top: 0.5em;
187 margin-bottom: 0;
188 font-style: italic;
189}
190dd > *:first-child {
191 margin-top: 0;
192}
193
194ul, ol {
195 list-style-position: outside;
196}
197ol.olist2 {
198 list-style-type: lower-alpha;
199}
200
201div.tableblock > table {
202 border-color: #527bbd;
203 border-width: 3px;
204}
205thead {
206 font-family: sans-serif;
207 font-weight: bold;
208}
209tfoot {
210 font-weight: bold;
211}
212
213div.hlist {
214 margin-top: 0.8em;
215 margin-bottom: 0.8em;
216}
217td.hlist1 {
218 vertical-align: top;
219 font-style: italic;
220 padding-right: 0.8em;
221}
222td.hlist2 {
223 vertical-align: top;
224}
225
226@media print {
227 div#footer-badges { display: none; }
228}
229include::./stylesheets/xhtml11-manpage.css[]
230/* Workarounds for IE6's broken and incomplete CSS2. */
231
232div.sidebar-content {
233 background: #ffffee;
234 border: 1px solid silver;
235 padding: 0.5em;
236}
237div.sidebar-title, div.image-title {
238 font-family: sans-serif;
239 font-weight: bold;
240 margin-top: 0.0em;
241 margin-bottom: 0.5em;
242}
243
244div.listingblock div.content {
245 border: 1px solid silver;
246 background: #f4f4f4;
247 padding: 0.5em;
248}
249
250div.quoteblock-content {
251 padding-left: 2.0em;
252}
253
254div.exampleblock-content {
255 border-left: 2px solid silver;
256 padding-left: 0.5em;
257}
258</style>
259<title>git-archive(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264git-archive(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>git-archive -
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]269 Create an archive of files from a named tree
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
Junio C Hamanoa9b8d242007-05-19 04:51:55[diff] [blame]275<div class="verseblock">
276<div class="content"><em>git-archive</em> --format=&lt;fmt&gt; [--list] [--prefix=&lt;prefix&gt;/] [&lt;extra&gt;]
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]277 [--remote=&lt;repo&gt; [--exec=&lt;git-upload-archive&gt;]] &lt;tree-ish&gt;
278 [path&#8230;]</div></div>
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]279</div>
280<h2>DESCRIPTION</h2>
281<div class="sectionbody">
282<p>Creates an archive of the specified format containing the tree
Junio C Hamano58155b42007-09-15 07:46:14[diff] [blame]283structure for the named tree, and writes it out to the standard
284output. If &lt;prefix&gt; is specified it is
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]285prepended to the filenames in the archive.</p>
286<p><em>git-archive</em> behaves differently when given a tree ID versus when
287given a commit ID or tag ID. In the first case the current time is
288used as modification time of each file in the archive. In the latter
289case the commit time as recorded in the referenced commit object is
290used instead. Additionally the commit ID is stored in a global
291extended pax header if the tar format is used; it can be extracted
292using <em>git-get-tar-commit-id</em>. In ZIP files it is stored as a file
293comment.</p>
294</div>
295<h2>OPTIONS</h2>
296<div class="sectionbody">
297<dl>
298<dt>
299--format=&lt;fmt&gt;
300</dt>
301<dd>
302<p>
Junio C Hamano58155b42007-09-15 07:46:14[diff] [blame]303 Format of the resulting archive: <em>tar</em> or <em>zip</em>. The default
Junio C Hamanoc3f1dbf2007-04-10 21:31:32[diff] [blame]304 is <em>tar</em>.
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]305</p>
306</dd>
307<dt>
Junio C Hamano81c711d2007-04-20 07:20:14[diff] [blame]308--list, -l
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]309</dt>
310<dd>
311<p>
312 Show all available formats.
313</p>
314</dd>
315<dt>
Junio C Hamano81c711d2007-04-20 07:20:14[diff] [blame]316--verbose, -v
317</dt>
318<dd>
319<p>
320 Report progress to stderr.
321</p>
322</dd>
323<dt>
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]324--prefix=&lt;prefix&gt;/
325</dt>
326<dd>
327<p>
328 Prepend &lt;prefix&gt;/ to each filename in the archive.
329</p>
330</dd>
331<dt>
332&lt;extra&gt;
333</dt>
334<dd>
335<p>
336 This can be any options that the archiver backend understand.
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]337 See next section.
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]338</p>
339</dd>
340<dt>
341--remote=&lt;repo&gt;
342</dt>
343<dd>
344<p>
345 Instead of making a tar archive from local repository,
346 retrieve a tar archive from a remote repository.
347</p>
348</dd>
349<dt>
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]350--exec=&lt;git-upload-archive&gt;
351</dt>
352<dd>
353<p>
354 Used with --remote to specify the path to the
355 git-upload-archive executable on the remote side.
356</p>
357</dd>
358<dt>
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]359&lt;tree-ish&gt;
360</dt>
361<dd>
362<p>
363 The tree or commit to produce an archive for.
364</p>
365</dd>
366<dt>
367path
368</dt>
369<dd>
370<p>
371 If one or more paths are specified, include only these in the
372 archive, otherwise include all files and subdirectories.
373</p>
374</dd>
375</dl>
376</div>
Junio C Hamano817abb42006-09-26 07:16:58[diff] [blame]377<h2>BACKEND EXTRA OPTIONS</h2>
378<div class="sectionbody">
379<h3>zip</h3>
380<dl>
381<dt>
382-0
383</dt>
384<dd>
385<p>
386 Store the files instead of deflating them.
387</p>
388</dd>
389<dt>
390-9
391</dt>
392<dd>
393<p>
394 Highest and slowest compression level. You can specify any
395 number from 1 to 9 to adjust compression speed and ratio.
396</p>
397</dd>
398</dl>
399</div>
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]400<h2>CONFIGURATION</h2>
401<div class="sectionbody">
Junio C Hamanobdebabb2007-08-23 00:25:09[diff] [blame]402<dl>
403<dt>
404tar.umask
405</dt>
406<dd>
407<p>
408 This variable can be used to restrict the permission bits of
409 tar archive entries. The default is 0002, which turns off the
410 world write bit. The special value "user" indicates that the
411 archiving user's umask will be used instead. See umask(2) for
412 details.
413</p>
414</dd>
415</dl>
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]416</div>
417<h2>EXAMPLES</h2>
418<div class="sectionbody">
419<dl>
420<dt>
421git archive --format=tar --prefix=junk/ HEAD | (cd /var/tmp/ &amp;&amp; tar xf -)
422</dt>
423<dd>
424<p>
425 Create a tar archive that contains the contents of the
426 latest commit on the current branch, and extracts it in
427 <tt>/var/tmp/junk</tt> directory.
428</p>
429</dd>
430<dt>
431git archive --format=tar --prefix=git-1.4.0/ v1.4.0 | gzip &gt;git-1.4.0.tar.gz
432</dt>
433<dd>
434<p>
435 Create a compressed tarball for v1.4.0 release.
436</p>
437</dd>
438<dt>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]439git archive --format=tar --prefix=git-1.4.0/ v1.4.0&#94;{tree} | gzip &gt;git-1.4.0.tar.gz
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]440</dt>
441<dd>
442<p>
443 Create a compressed tarball for v1.4.0 release, but without a
444 global extended pax header.
445</p>
446</dd>
447<dt>
448git archive --format=zip --prefix=git-docs/ HEAD:Documentation/ &gt; git-1.4.0-docs.zip
449</dt>
450<dd>
451<p>
452 Put everything in the current head's Documentation/ directory
453 into <em>git-1.4.0-docs.zip</em>, with the prefix <em>git-docs/</em>.
454</p>
455</dd>
456</dl>
457</div>
458<h2>Author</h2>
459<div class="sectionbody">
460<p>Written by Franck Bui-Huu and Rene Scharfe.</p>
461</div>
462<h2>Documentation</h2>
463<div class="sectionbody">
464<p>Documentation by David Greaves, Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
465</div>
466<h2>GIT</h2>
467<div class="sectionbody">
468<p>Part of the <a href="git.html">git(7)</a> suite</p>
469</div>
470<div id="footer">
471<div id="footer-text">
Junio C Hamano35738e82008-01-07 07:55:46[diff] [blame]472Last updated 07-Jan-2008 07:50:01 UTC
Junio C Hamano781d8a22006-09-17 10:34:15[diff] [blame]473</div>
474</div>
475</body>
476</html>