Fix confusing git-update-ref error message
[gitweb.git] / Documentation / git-tar-tree.txt
index 7870e92ae9b394b80a0a0dfcfc888971eb00c356..2139b6ff8ce3df6d1c872be1410349e2637eb4f1 100644 (file)
@@ -1,6 +1,5 @@
 git-tar-tree(1)
 ===============
-v0.1, May 2005
 
 NAME
 ----
@@ -14,13 +13,20 @@ SYNOPSIS
 DESCRIPTION
 -----------
 Creates a tar archive containing the tree structure for the named tree.
-When <base> is specified it is added as a leading path as the files in the
+When <base> is specified it is added as a leading path to the files in the
 generated tar archive.
 
+git-tar-tree 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
+modification time of each file in the archive.  In the latter case the
+commit time as recorded in the referenced commit object is used instead.
+Additionally the commit ID is stored in a global extended pax header.
+It can be extracted using git-get-tar-commit-id.
+
 
 Author
 ------
-Written by Linus Torvalds <torvalds@osdl.org>
+Written by Rene Scharfe.
 
 Documentation
 --------------
@@ -28,5 +34,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel
 
 GIT
 ---
-Part of the link:git.html[git] suite
+Part of the gitlink:git[7] suite