Updated git_doc to git 1.8
[TortoiseGit.git] / doc / source / en / TortoiseGit / git_doc / git-get-tar-commit-id.xml
blob7afd9db49913e427d4a81ddcd6b6bc76b3d61335
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">\r
3 \r
4 <sect2 lang="en" id="git-get-tar-commit-id(1)">\r
5     <title>git-get-tar-commit-id(1)</title>\r
6 <indexterm>\r
7 <primary>git-get-tar-commit-id(1)</primary>\r
8 </indexterm>\r
9 <simplesect id="git-get-tar-commit-id(1)__name">\r
10 <title>NAME</title>\r
11 <simpara>git-get-tar-commit-id - Extract commit ID from an archive created using git-archive</simpara>\r
12 </simplesect>\r
13 <simplesect id="git-get-tar-commit-id(1)__synopsis">\r
14 <title>SYNOPSIS</title>\r
15 <blockquote>\r
16 <literallayout><emphasis>git get-tar-commit-id</emphasis> &lt; &lt;tarfile&gt;</literallayout>\r
17 </blockquote>\r
18 </simplesect>\r
19 <simplesect id="git-get-tar-commit-id(1)__description">\r
20 <title>DESCRIPTION</title>\r
21 <simpara>Acts as a filter, extracting the commit ID stored in archives created by\r
22 <emphasis>git archive</emphasis>.  It reads only the first 1024 bytes of input, thus its\r
23 runtime is not influenced by the size of &lt;tarfile&gt; very much.</simpara>\r
24 <simpara>If no commit ID is found, <emphasis>git get-tar-commit-id</emphasis> quietly exists with a\r
25 return code of 1.  This can happen if &lt;tarfile&gt; had not been created\r
26 using <emphasis>git archive</emphasis> or if the first parameter of <emphasis>git archive</emphasis> had been\r
27 a tree ID instead of a commit ID or tag.</simpara>\r
28 </simplesect>\r
29 <simplesect id="git-get-tar-commit-id(1)__git">\r
30 <title>GIT</title>\r
31 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>\r
32 </simplesect>\r
33 </sect2>\r