Google Git
Sign in
chromium / external / gitster / git-htmldocs / e03e989d908dcf9d52f4b0b532dfd5713f3eb840 / . / git-tar-tree.html
blob: b9d0f528582e32a79c94217f9c5600910b44ffc9 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]6<meta name="generator" content="AsciiDoc 7.0.2" />
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]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-tar-tree(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264git-tar-tree(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>git-tar-tree -
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]269 Create a tar archive of the files in the named tree object
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]275<p><em>git-tar-tree</em> [--remote=&lt;repo&gt;] &lt;tree-ish&gt; [ &lt;base&gt; ]</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]276</div>
277<h2>DESCRIPTION</h2>
278<div class="sectionbody">
Junio C Hamano47c1e3c2006-09-25 04:45:55[diff] [blame]279<p>THIS COMMAND IS DEPRECATED. Use <tt>git-archive</tt> with <tt>--format=tar</tt>
Junio C Hamano22bfb1f2007-04-19 02:58:43[diff] [blame]280option instead (and move the &lt;base&gt; argument to <tt>--prefix=base/</tt>).</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]281<p>Creates a tar archive containing the tree structure for the named tree.
282When &lt;base&gt; is specified it is added as a leading path to the files in the
283generated tar archive.</p>
284<p>git-tar-tree behaves differently when given a tree ID versus when given
285a commit ID or tag ID. In the first case the current time is used as
286modification time of each file in the archive. In the latter case the
287commit time as recorded in the referenced commit object is used instead.
288Additionally the commit ID is stored in a global extended pax header.
289It can be extracted using git-get-tar-commit-id.</p>
290</div>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]291<h2>OPTIONS</h2>
292<div class="sectionbody">
293<dl>
294<dt>
295&lt;tree-ish&gt;
296</dt>
297<dd>
298<p>
299 The tree or commit to produce tar archive for. If it is
300 the object name of a commit object.
301</p>
302</dd>
303<dt>
304&lt;base&gt;
305</dt>
306<dd>
307<p>
308 Leading path to the files in the resulting tar archive.
309</p>
310</dd>
311<dt>
312--remote=&lt;repo&gt;
313</dt>
314<dd>
315<p>
316 Instead of making a tar archive from local repository,
317 retrieve a tar archive from a remote repository.
318</p>
319</dd>
320</dl>
321</div>
Junio C Hamano75cc4c92006-07-24 08:25:03[diff] [blame]322<h2>CONFIGURATION</h2>
323<div class="sectionbody">
Junio C Hamanobdebabb2007-08-23 00:25:09[diff] [blame]324<dl>
325<dt>
326tar.umask
327</dt>
328<dd>
329<p>
330 This variable can be used to restrict the permission bits of
331 tar archive entries. The default is 0002, which turns off the
332 world write bit. The special value "user" indicates that the
333 archiving user's umask will be used instead. See umask(2) for
334 details.
335</p>
336</dd>
337</dl>
Junio C Hamano75cc4c92006-07-24 08:25:03[diff] [blame]338</div>
339<h2>EXAMPLES</h2>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]340<div class="sectionbody">
341<dl>
342<dt>
Junio C Hamano74bbe902006-06-18 11:37:24[diff] [blame]343git tar-tree HEAD junk | (cd /var/tmp/ &amp;&amp; tar xf -)
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]344</dt>
345<dd>
346<p>
347 Create a tar archive that contains the contents of the
348 latest commit on the current branch, and extracts it in
349 <tt>/var/tmp/junk</tt> directory.
350</p>
351</dd>
Junio C Hamano74bbe902006-06-18 11:37:24[diff] [blame]352<dt>
353git tar-tree v1.4.0 git-1.4.0 | gzip &gt;git-1.4.0.tar.gz
354</dt>
355<dd>
356<p>
357 Create a tarball for v1.4.0 release.
358</p>
359</dd>
360<dt>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]361git tar-tree v1.4.0&#94;{tree} git-1.4.0 | gzip &gt;git-1.4.0.tar.gz
Junio C Hamano74bbe902006-06-18 11:37:24[diff] [blame]362</dt>
363<dd>
364<p>
365 Create a tarball for v1.4.0 release, but without a
366 global extended pax header.
367</p>
368</dd>
369<dt>
370git tar-tree --remote=example.com:git.git v1.4.0 &gt;git-1.4.0.tar
371</dt>
372<dd>
373<p>
374 Get a tarball v1.4.0 from example.com.
375</p>
376</dd>
Junio C Hamanoc99ab982006-07-31 08:45:12[diff] [blame]377<dt>
378git tar-tree HEAD:Documentation/ git-docs &gt; git-1.4.0-docs.tar
379</dt>
380<dd>
381<p>
382 Put everything in the current head's Documentation/ directory
383 into <em>git-1.4.0-docs.tar</em>, with the prefix <em>git-docs/</em>.
384</p>
385</dd>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]386</dl>
Junio C Hamano33db4372006-06-07 19:51:45[diff] [blame]387</div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]388<h2>Author</h2>
389<div class="sectionbody">
390<p>Written by Rene Scharfe.</p>
391</div>
392<h2>Documentation</h2>
393<div class="sectionbody">
394<p>Documentation by David Greaves, Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
395</div>
396<h2>GIT</h2>
397<div class="sectionbody">
398<p>Part of the <a href="git.html">git(7)</a> suite</p>
399</div>
400<div id="footer">
401<div id="footer-text">
Junio C Hamanobdebabb2007-08-23 00:25:09[diff] [blame]402Last updated 23-Aug-2007 00:24:08 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]403</div>
404</div>
405</body>
406</html>