summaryrefslogtreecommitdiffstats
path: root/git-archive.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2022-07-11 16:08:34 -0700
committerJunio C Hamano <gitster@pobox.com>2022-07-11 16:08:34 -0700
commit7bc735932830b9840daeff68819d626c3b0cd07b (patch)
tree6c36713b44abd490cd78976f7ad2839a9268abd3 /git-archive.html
parentebdf143ff06ab8a67139c290755d6c6ecfe3126b (diff)
downloadgit-htmldocs-7bc735932830b9840daeff68819d626c3b0cd07b.tar.gz
Autogenerated HTML docs for v2.37.0-38-g55ece
Diffstat (limited to 'git-archive.html')
-rw-r--r--git-archive.html23
1 files changed, 12 insertions, 11 deletions
diff --git a/git-archive.html b/git-archive.html
index 15e99f70e..1a209e40b 100644
--- a/git-archive.html
+++ b/git-archive.html
@@ -783,10 +783,12 @@ comment.</p></div>
</dt>
<dd>
<p>
- Format of the resulting archive: <em>tar</em> or <em>zip</em>. If this option
+ Format of the resulting archive. Possible values are <code>tar</code>,
+ <code>zip</code>, <code>tar.gz</code>, <code>tgz</code>, and any format defined using the
+ configuration option <code>tar.&lt;format&gt;.command</code>. If <code>--format</code>
is not given, and the output file is specified, the format is
- inferred from the filename if possible (e.g. writing to "foo.zip"
- makes the output to be in the zip format). Otherwise the output
+ inferred from the filename if possible (e.g. writing to <code>foo.zip</code>
+ makes the output to be in the <code>zip</code> format). Otherwise the output
format is <code>tar</code>.
</p>
</dd>
@@ -988,21 +990,20 @@ tar.&lt;format&gt;.command
is executed using the shell with the generated tar file on its
standard input, and should produce the final output on its
standard output. Any compression-level options will be passed
- to the command (e.g., "-9"). An output file with the same
- extension as <code>&lt;format&gt;</code> will be use this format if no other
- format is given.
+ to the command (e.g., <code>-9</code>).
</p>
-<div class="paragraph"><p>The "tar.gz" and "tgz" formats are defined automatically and default to
-<code>gzip -cn</code>. You may override them with custom commands.</p></div>
+<div class="paragraph"><p>The <code>tar.gz</code> and <code>tgz</code> formats are defined automatically and use the
+magic command <code>git archive gzip</code> by default, which invokes an internal
+implementation of gzip.</p></div>
</dd>
<dt class="hdlist1">
tar.&lt;format&gt;.remote
</dt>
<dd>
<p>
- If true, enable <code>&lt;format&gt;</code> for use by remote clients via
+ If true, enable the format for use by remote clients via
<a href="git-upload-archive.html">git-upload-archive(1)</a>. Defaults to false for
- user-defined formats, but true for the "tar.gz" and "tgz"
+ user-defined formats, but true for the <code>tar.gz</code> and <code>tgz</code>
formats.
</p>
</dd>
@@ -1148,7 +1149,7 @@ while archiving any tree in your <code>$GIT_DIR/info/attributes</code> file.</p>
<div id="footer">
<div id="footer-text">
Last updated
- 2022-06-07 14:51:19 PDT
+ 2022-07-11 16:06:18 PDT
</div>
</div>
</body>