blob: d3303f124bac752f8da5d3656d4336e3a8200817 [file] [log] [blame]
'\" t
.\" Title: git-mktree
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 02/24/2019
.\" Manual: Git Manual
.\" Source: Git 2.21.0
.\" Language: English
.\"
.TH "GIT\-MKTREE" "1" "02/24/2019" "Git 2\&.21\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * 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
.nf
\fIgit mktree\fR [\-z] [\-\-missing] [\-\-batch]
.fi
.sp
.SH "DESCRIPTION"
.sp
Reads standard input in non\-recursive \fBls\-tree\fR 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\&.
.SH "OPTIONS"
.PP
\-z
.RS 4
Read the NUL\-terminated
\fBls\-tree \-z\fR
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
\fB\-z\fR
option is used, lines are terminated with NUL\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite