Autogenerated manpages for v2.44.0-rc1-17-g3e0d3
[git-manpages.git] / man1 / git-write-tree.1
blobaf7915349d04f42d5cd05b5d9d4492147fe78011
1 '\" t
2 .\"     Title: git-write-tree
3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\"      Date: 2024-02-15
6 .\"    Manual: Git Manual
7 .\"    Source: Git 2.44.0.rc1.17.g3e0d3cd5c7
8 .\"  Language: English
9 .\"
10 .TH "GIT\-WRITE\-TREE" "1" "2024\-02\-15" "Git 2\&.44\&.0\&.rc1\&.17\&.g3" "Git Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 git-write-tree \- Create a tree object from the current index
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 \fIgit write\-tree\fR [\-\-missing\-ok] [\-\-prefix=<prefix>/]
36 .fi
37 .sp
38 .SH "DESCRIPTION"
39 .sp
40 Creates a tree object using the current index\&. The name of the new tree object is printed to standard output\&.
41 .sp
42 The index must be in a fully merged state\&.
43 .sp
44 Conceptually, \fIgit write\-tree\fR sync()s the current index contents into a set of tree files\&. In order to have that match what is actually in your directory right now, you need to have done a \fIgit update\-index\fR phase before you did the \fIgit write\-tree\fR\&.
45 .SH "OPTIONS"
46 .PP
47 \-\-missing\-ok
48 .RS 4
49 Normally
50 \fIgit write\-tree\fR
51 ensures that the objects referenced by the directory exist in the object database\&. This option disables this check\&.
52 .RE
53 .PP
54 \-\-prefix=<prefix>/
55 .RS 4
56 Writes a tree object that represents a subdirectory
57 \fB<prefix>\fR\&. This can be used to write the tree object for a subproject that is in the named subdirectory\&.
58 .RE
59 .SH "GIT"
60 .sp
61 Part of the \fBgit\fR(1) suite