1GIT-TAR-TREE(1)                   Git Manual                   GIT-TAR-TREE(1)
2
3
4

NAME

6       git-tar-tree - Create a tar archive of the files in the named tree
7       object
8

SYNOPSIS

10       git tar-tree [--remote=<repo>] <tree-ish> [ <base> ]
11

DESCRIPTION

13       THIS COMMAND IS DEPRECATED. Use git archive with --format=tar option
14       instead (and move the <base> argument to --prefix=base/).
15
16       Creates a tar archive containing the tree structure for the named tree.
17       When <base> is specified it is added as a leading path to the files in
18       the generated tar archive.
19
20       git tar-tree behaves differently when given a tree ID versus when given
21       a commit ID or tag ID. In the first case the current time is used as
22       modification time of each file in the archive. In the latter case the
23       commit time as recorded in the referenced commit object is used
24       instead. Additionally the commit ID is stored in a global extended pax
25       header. It can be extracted using git get-tar-commit-id.
26

OPTIONS

28       <tree-ish>
29           The tree or commit to produce tar archive for. If it is the object
30           name of a commit object.
31
32       <base>
33           Leading path to the files in the resulting tar archive.
34
35       --remote=<repo>
36           Instead of making a tar archive from local repository, retrieve a
37           tar archive from a remote repository.
38

CONFIGURATION

40       tar.umask
41           This variable can be used to restrict the permission bits of tar
42           archive entries. The default is 0002, which turns off the world
43           write bit. The special value "user" indicates that the archiving
44           user’s umask will be used instead. See umask(2) for details.
45

EXAMPLES

47       git tar-tree HEAD junk | (cd /var/tmp/ && tar xf -)
48           Create a tar archive that contains the contents of the latest
49           commit on the current branch, and extracts it in /var/tmp/junk
50           directory.
51
52       git tar-tree v1.4.0 git-1.4.0 | gzip >git-1.4.0.tar.gz
53           Create a tarball for v1.4.0 release.
54
55       git tar-tree v1.4.0^{tree} git-1.4.0 | gzip >git-1.4.0.tar.gz
56           Create a tarball for v1.4.0 release, but without a global extended
57           pax header.
58
59       git tar-tree --remote=example.com:git.git v1.4.0 >git-1.4.0.tar
60           Get a tarball v1.4.0 from example.com.
61
62       git tar-tree HEAD:Documentation/ git-docs > git-1.4.0-docs.tar
63           Put everything in the current head’s Documentation/ directory into
64           git-1.4.0-docs.tar, with the prefix git-docs/.
65

AUTHOR

67       Written by Rene Scharfe.
68

DOCUMENTATION

70       Documentation by David Greaves, Junio C Hamano and the git-list
71       <git@vger.kernel.org[1]>.
72

GIT

74       Part of the git(1) suite
75

NOTES

77        1. git@vger.kernel.org
78           mailto:git@vger.kernel.org
79
80
81
82Git 1.7.1                         08/16/2017                   GIT-TAR-TREE(1)
Impressum