Merge branch 'ls/p4-tmp-refs'
[gitweb.git] / Documentation / git-mktree.txt
index af19f06ed738bdecc7ab9a72a5c9a216b816f4c2..c3616e7711aef80ee7e2bd3bb90ea5cee7dd1d4b 100644 (file)
@@ -8,12 +8,14 @@ git-mktree - Build a tree-object from ls-tree formatted text
 
 SYNOPSIS
 --------
-'git mktree' [-z]
+[verse]
+'git mktree' [-z] [--missing] [--batch]
 
 DESCRIPTION
 -----------
-Reads standard input in non-recursive `ls-tree` output format,
-and creates a tree object.  The object name of the tree object
+Reads standard input in non-recursive `ls-tree` output format, and creates
+a tree object.  The order of the tree entries is normalised by mktree so
+pre-sorting the input is not required.  The object name of the tree object
 built is written to the standard output.
 
 OPTIONS
@@ -21,13 +23,17 @@ OPTIONS
 -z::
        Read the NUL-terminated `ls-tree -z` output instead.
 
-Author
-------
-Written by Junio C Hamano <gitster@pobox.com>
-
-Documentation
---------------
-Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
+--missing::
+       Allow missing objects.  The default behaviour (without this option)
+       is to verify that each tree entry's sha1 identifies an existing
+       object.  This option has no effect on the treatment of gitlink entries
+       (aka "submodules") which are always allowed to be missing.
+
+--batch::
+       Allow building of more than one tree object before exiting.  Each
+       tree is separated by as single blank line. The final new-line is
+       optional.  Note - if the `-z` option is used, lines are terminated
+       with NUL.
 
 GIT
 ---