Git Mktree Command

1st chunk of `Documentation/git-mktree.adoc`

c67400a151040b16543970a89b6f92ca6406741c1170b14c0000000100000433

git-mktree(1)
=============

NAME
----
git-mktree - Build a tree-object from ls-tree formatted text


SYNOPSIS
--------
[verse]
'git mktree' [-z] [--missing] [--batch]

DESCRIPTION
-----------
Reads standard input in non-recursive `ls-tree` output format, and creates
a tree object.  The order of the tree entries is normalized 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
-------
-z::
	Read the NUL-terminated `ls-tree -z` output instead.

--missing::
	Allow missing objects.  The default behaviour (without this option)
	is to verify that each tree entry's hash 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 a single blank line. The final newline is
	optional.  Note - if the `-z` option is used, lines are terminated
	with NUL.

GIT
---
Part of the linkgit:git[1] suite

Title: Git Mktree Command

Summary

The git-mktree command builds a tree-object from ls-tree formatted text, allowing for the creation of tree objects with various options for handling input and missing objects. It reads standard input, normalizes the order of tree entries, and writes the object name of the tree object to standard output, providing options for NUL-terminated input, allowing missing objects, and building multiple tree objects in batch mode.