diff options
| author | Junio C Hamano <junio@kernel.org> | 2010-11-06 01:01:59 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@kernel.org> | 2010-11-06 01:01:59 +0000 |
| commit | 68cf15a825368c926443c26a6516947fca3c1d39 (patch) | |
| tree | a587c9a51372746ddc3cdb08108bb14fb94a0488 /git-archive.html | |
| parent | 39c7a69d994a13cbd5594bf2f5e65a0f21cc9bb9 (diff) | |
| download | git-htmldocs-68cf15a825368c926443c26a6516947fca3c1d39.tar.gz | |
Autogenerated HTML docs for v1.7.3.2-161-g3089c
Diffstat (limited to 'git-archive.html')
| -rw-r--r-- | git-archive.html | 238 |
1 files changed, 167 insertions, 71 deletions
diff --git a/git-archive.html b/git-archive.html index 96543a61c..ced3a2629 100644 --- a/git-archive.html +++ b/git-archive.html @@ -3,7 +3,8 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.2.5" />
+<meta name="generator" content="AsciiDoc 8.4.5" />
+<title>git-archive(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -26,10 +27,12 @@ a:visited { em {
font-style: italic;
+ color: navy;
}
strong {
font-weight: bold;
+ color: #083194;
}
tt {
@@ -71,6 +74,10 @@ p { margin-bottom: 0.5em;
}
+ul, ol, li > p {
+ margin-top: 0;
+}
+
pre {
padding: 0;
margin: 0;
@@ -84,7 +91,7 @@ span#author { }
span#email {
}
-span#revision {
+span#revnumber, span#revdate, span#revremark {
font-family: sans-serif;
}
@@ -104,11 +111,13 @@ div#footer-badges { padding-bottom: 0.5em;
}
-div#preamble,
+div#preamble {
+ margin-top: 1.5em;
+ margin-bottom: 1.5em;
+}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
- margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@@ -123,6 +132,7 @@ div.content { /* Block element content. */ /* Block element titles. */
div.title, caption.title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@@ -149,22 +159,33 @@ div.sidebarblock > div.content { padding: 0.5em;
}
-div.listingblock {
- margin-right: 0%;
-}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
-div.quoteblock > div.content {
+div.quoteblock {
padding-left: 2.0em;
+ margin-right: 10%;
}
-
-div.attribution {
+div.quoteblock > div.attribution {
+ padding-top: 0.5em;
text-align: right;
}
+
+div.verseblock {
+ padding-left: 2.0em;
+ margin-right: 10%;
+}
+div.verseblock > div.content {
+ white-space: pre;
+}
+div.verseblock > div.attribution {
+ padding-top: 0.75em;
+ text-align: left;
+}
+/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@@ -187,13 +208,9 @@ div.exampleblock > div.content { padding: 0.5em;
}
-div.verseblock div.content {
- white-space: pre;
-}
-
div.imageblock div.content { padding-left: 0; }
-div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
+a.image:visited { color: white; }
dl {
margin-top: 0.8em;
@@ -202,18 +219,38 @@ dl { dt {
margin-top: 0.5em;
margin-bottom: 0;
- font-style: italic;
+ font-style: normal;
+ color: navy;
}
dd > *:first-child {
- margin-top: 0;
+ margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
-div.olist2 ol {
+ol.arabic {
+ list-style-type: decimal;
+}
+ol.loweralpha {
list-style-type: lower-alpha;
}
+ol.upperalpha {
+ list-style-type: upper-alpha;
+}
+ol.lowerroman {
+ list-style-type: lower-roman;
+}
+ol.upperroman {
+ list-style-type: upper-roman;
+}
+
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+ margin-top: 0.1em;
+ margin-bottom: 0.1em;
+}
div.tableblock > table {
border: 3px solid #527bbd;
@@ -225,22 +262,53 @@ thead { tfoot {
font-weight: bold;
}
+td > div.verse {
+ white-space: pre;
+}
+p.table {
+ margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+ border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+ border-left-style: none;
+ border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+ border-top-style: none;
+ border-bottom-style: none;
+}
-div.hlist {
+
+div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
-div.hlist td {
- padding-bottom: 5px;
+div.hdlist tr {
+ padding-bottom: 15px;
+}
+dt.hdlist1.strong, td.hdlist1.strong {
+ font-weight: bold;
}
-td.hlist1 {
+td.hdlist1 {
vertical-align: top;
- font-style: italic;
+ font-style: normal;
padding-right: 0.8em;
+ color: navy;
}
-td.hlist2 {
+td.hdlist2 {
vertical-align: top;
}
+div.hdlist.compact tr {
+ margin: 0;
+ padding-bottom: 0;
+}
+
+.comment {
+ background: yellow;
+}
@media print {
div#footer-badges { display: none; }
@@ -271,7 +339,24 @@ div.toclevel4 { margin-left: 6em;
font-size: 0.9em;
}
-include1::./stylesheets/xhtml11-manpage.css[]
+/* Overrides for manpage documents */
+h1 {
+ padding-top: 0.5em;
+ padding-bottom: 0.5em;
+ border-top: 2px solid silver;
+ border-bottom: 2px solid silver;
+}
+h2 {
+ border-style: none;
+}
+div.sectionbody {
+ margin-left: 5%;
+}
+
+@media print {
+ div#toc { display: none; }
+}
+
/* Workarounds for IE6's broken and incomplete CSS2. */
div.sidebar-content {
@@ -280,6 +365,7 @@ div.sidebar-content { padding: 0.5em;
}
div.sidebar-title, div.image-title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@@ -292,8 +378,17 @@ div.listingblock div.content { padding: 0.5em;
}
-div.quoteblock-content {
- padding-left: 2.0em;
+div.quoteblock-attribution {
+ padding-top: 0.5em;
+ text-align: right;
+}
+
+div.verseblock-content {
+ white-space: pre;
+}
+div.verseblock-attribution {
+ padding-top: 0.75em;
+ text-align: left;
}
div.exampleblock-content {
@@ -304,7 +399,6 @@ div.exampleblock-content { /* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
-<title>git-archive(1)</title>
</head>
<body>
<div id="header">
@@ -318,21 +412,23 @@ git-archive(1) Manual Page </p>
</div>
</div>
-<h2>SYNOPSIS</h2>
+<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
<div class="verseblock">
-<div class="content"><em>git archive</em> [--format=<fmt>] [--list] [--prefix=<prefix>/] [<extra>]
+<div class="verseblock-content"><em>git archive</em> [--format=<fmt>] [--list] [--prefix=<prefix>/] [<extra>]
[-o | --output=<file>] [--worktree-attributes]
[--remote=<repo> [--exec=<git-upload-archive>]] <tree-ish>
- [<path>…]</div></div>
+ [<path>…]</div>
+<div class="verseblock-attribution">
+</div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
-<div class="para"><p>Creates an archive of the specified format containing the tree
+<div class="paragraph"><p>Creates an archive of the specified format containing the tree
structure for the named tree, and writes it out to the standard
output. If <prefix> is specified it is
prepended to the filenames in the archive.</p></div>
-<div class="para"><p><em>git archive</em> behaves differently when given a tree ID versus when
+<div class="paragraph"><p><em>git archive</em> behaves differently when given a tree ID versus when
given a commit ID or tag ID. In the first case the current time is
used as the modification time of each file in the archive. In the latter
case the commit time as recorded in the referenced commit object is
@@ -343,8 +439,8 @@ comment.</p></div> </div>
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
--format=<fmt>
</dt>
<dd>
@@ -356,10 +452,10 @@ comment.</p></div> format is <tt>tar</tt>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-l
</dt>
-<dt>
+<dt class="hdlist1">
--list
</dt>
<dd>
@@ -367,10 +463,10 @@ comment.</p></div> Show all available formats.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-v
</dt>
-<dt>
+<dt class="hdlist1">
--verbose
</dt>
<dd>
@@ -378,7 +474,7 @@ comment.</p></div> Report progress to stderr.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--prefix=<prefix>/
</dt>
<dd>
@@ -386,10 +482,10 @@ comment.</p></div> Prepend <prefix>/ to each filename in the archive.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-o <file>
</dt>
-<dt>
+<dt class="hdlist1">
--output=<file>
</dt>
<dd>
@@ -397,7 +493,7 @@ comment.</p></div> Write the archive to <file> instead of stdout.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--worktree-attributes
</dt>
<dd>
@@ -405,7 +501,7 @@ comment.</p></div> Look for attributes in .gitattributes in working directory too.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
<extra>
</dt>
<dd>
@@ -414,7 +510,7 @@ comment.</p></div> See next section.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--remote=<repo>
</dt>
<dd>
@@ -423,7 +519,7 @@ comment.</p></div> retrieve a tar archive from a remote repository.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--exec=<git-upload-archive>
</dt>
<dd>
@@ -432,7 +528,7 @@ comment.</p></div> <em>git-upload-archive</em> on the remote side.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
<tree-ish>
</dt>
<dd>
@@ -440,7 +536,7 @@ comment.</p></div> The tree or commit to produce an archive for.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
<path>
</dt>
<dd>
@@ -455,8 +551,8 @@ comment.</p></div> <h2 id="_backend_extra_options">BACKEND EXTRA OPTIONS</h2>
<div class="sectionbody">
<h3 id="_zip">zip</h3><div style="clear:left"></div>
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
-0
</dt>
<dd>
@@ -464,7 +560,7 @@ comment.</p></div> Store the files instead of deflating them.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-9
</dt>
<dd>
@@ -477,8 +573,8 @@ comment.</p></div> </div>
<h2 id="_configuration">CONFIGURATION</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
tar.umask
</dt>
<dd>
@@ -486,7 +582,7 @@ tar.umask This variable can be used to restrict the permission bits of
tar archive entries. The default is 0002, which turns off the
world write bit. The special value "user" indicates that the
- archiving user's umask will be used instead. See umask(2) for
+ archiving user’s umask will be used instead. See umask(2) for
details.
</p>
</dd>
@@ -494,17 +590,17 @@ tar.umask </div>
<h2 id="_attributes">ATTRIBUTES</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
export-ignore
</dt>
<dd>
<p>
- Files and directories with the attribute export-ignore won't be
+ Files and directories with the attribute export-ignore won’t be
added to archive files. See <a href="gitattributes.html">gitattributes(5)</a> for details.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
export-subst
</dt>
<dd>
@@ -515,7 +611,7 @@ export-subst </p>
</dd>
</dl></div>
-<div class="para"><p>Note that attributes are by default taken from the <tt>.gitattributes</tt> files
+<div class="paragraph"><p>Note that attributes are by default taken from the <tt>.gitattributes</tt> files
in the tree that is being archived. If you want to tweak the way the
output is generated after the fact (e.g. you committed without adding an
appropriate export-ignore in its <tt>.gitattributes</tt>), adjust the checked out
@@ -525,8 +621,8 @@ while archiving any tree in your <tt>$GIT_DIR/info/attributes</tt> file.</p></di </div>
<h2 id="_examples">EXAMPLES</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
git archive --format=tar --prefix=junk/ HEAD | (cd /var/tmp/ && tar xf -)
</dt>
<dd>
@@ -536,7 +632,7 @@ git archive --format=tar --prefix=junk/ HEAD | (cd /var/tmp/ && tar xf - <tt>/var/tmp/junk</tt> directory.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
git archive --format=tar --prefix=git-1.4.0/ v1.4.0 | gzip >git-1.4.0.tar.gz
</dt>
<dd>
@@ -544,7 +640,7 @@ git archive --format=tar --prefix=git-1.4.0/ v1.4.0 | gzip >git-1.4.0.tar.gz Create a compressed tarball for v1.4.0 release.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
git archive --format=tar --prefix=git-1.4.0/ v1.4.0^{tree} | gzip >git-1.4.0.tar.gz
</dt>
<dd>
@@ -553,16 +649,16 @@ git archive --format=tar --prefix=git-1.4.0/ v1.4.0^{tree} | gzip >git-1. global extended pax header.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
git archive --format=zip --prefix=git-docs/ HEAD:Documentation/ > git-1.4.0-docs.zip
</dt>
<dd>
<p>
- Put everything in the current head's Documentation/ directory
+ Put everything in the current head’s Documentation/ directory
into <em>git-1.4.0-docs.zip</em>, with the prefix <em>git-docs/</em>.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
git archive -o latest.zip HEAD
</dt>
<dd>
@@ -576,23 +672,23 @@ git archive -o latest.zip HEAD </div>
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
-<div class="para"><p><a href="gitattributes.html">gitattributes(5)</a></p></div>
+<div class="paragraph"><p><a href="gitattributes.html">gitattributes(5)</a></p></div>
</div>
<h2 id="_author">Author</h2>
<div class="sectionbody">
-<div class="para"><p>Written by Franck Bui-Huu and Rene Scharfe.</p></div>
+<div class="paragraph"><p>Written by Franck Bui-Huu and Rene Scharfe.</p></div>
</div>
<h2 id="_documentation">Documentation</h2>
<div class="sectionbody">
-<div class="para"><p>Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.</p></div>
+<div class="paragraph"><p>Documentation by David Greaves, Junio C Hamano and the git-list <<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>>.</p></div>
</div>
<h2 id="_git">GIT</h2>
<div class="sectionbody">
-<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
+<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2010-10-22 04:11:02 UTC
+Last updated 2010-11-06 00:41:57 UTC
</div>
</div>
</body>
|