archive: handle commits with an empty tree
[git/jnareb-git.git] / Documentation / git-get-tar-commit-id.txt
blob1e2a20dd265c2c41aef0ea66ca9831321d951d5c
1 git-get-tar-commit-id(1)
2 ========================
4 NAME
5 ----
6 git-get-tar-commit-id - Extract commit ID from an archive created using git-archive
9 SYNOPSIS
10 --------
11 [verse]
12 'git get-tar-commit-id' < <tarfile>
15 DESCRIPTION
16 -----------
17 Acts as a filter, extracting the commit ID stored in archives created by
18 'git archive'.  It reads only the first 1024 bytes of input, thus its
19 runtime is not influenced by the size of <tarfile> very much.
21 If no commit ID is found, 'git get-tar-commit-id' quietly exists with a
22 return code of 1.  This can happen if <tarfile> had not been created
23 using 'git archive' or if the first parameter of 'git archive' had been
24 a tree ID instead of a commit ID or tag.
26 GIT
27 ---
28 Part of the linkgit:git[1] suite