git-mktree.1   [plain text]


'\" t
.\"     Title: git-mktree
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 06/01/2011
.\"    Manual: Git Manual
.\"    Source: Git 1.7.5.4
.\"  Language: English
.\"
.TH "GIT\-MKTREE" "1" "06/01/2011" "Git 1\&.7\&.5\&.4" "Git Manual"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-mktree \- Build a tree\-object from ls\-tree formatted text
.SH "SYNOPSIS"
.sp
\fIgit mktree\fR [\-z] [\-\-missing] [\-\-batch]
.SH "DESCRIPTION"
.sp
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\&.
.SH "OPTIONS"
.PP
\-z
.RS 4
Read the NUL\-terminated
ls\-tree \-z
output instead\&.
.RE
.PP
\-\-missing
.RS 4
Allow missing objects\&. The default behaviour (without this option) is to verify that each tree entry\(cqs 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\&.
.RE
.PP
\-\-batch
.RS 4
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
\fI\-z\fR
option is used, lines are terminated with NUL\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite