Update Git docs to 2.29.2
[TortoiseGit.git] / doc / source / en / TortoiseGit / git_doc / git-write-tree.xml
blob75f1cd281e5059dfef7da12e84ddf07a24e1861f
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect2 SYSTEM "../../../dtd/dblite.dtd">\r
3 \r
4 <sect2 lang="en" id="git-write-tree(1)">\r
5     <title>git-write-tree(1)</title>\r
6 <indexterm>\r
7 <primary>git-write-tree(1)</primary>\r
8 </indexterm>\r
9 <simplesect id="git-write-tree(1)__name">\r
10 <title>NAME</title>\r
11 <simpara>git-write-tree - Create a tree object from the current index</simpara>\r
12 </simplesect>\r
13 <simplesect id="git-write-tree(1)__synopsis">\r
14 <title>SYNOPSIS</title>\r
15 <blockquote>\r
16 <literallayout><emphasis>git write-tree</emphasis> [--missing-ok] [--prefix=&lt;prefix&gt;/]</literallayout>\r
17 </blockquote>\r
18 </simplesect>\r
19 <simplesect id="git-write-tree(1)__description">\r
20 <title>DESCRIPTION</title>\r
21 <simpara>Creates a tree object using the current index. The name of the new\r
22 tree object is printed to standard output.</simpara>\r
23 <simpara>The index must be in a fully merged state.</simpara>\r
24 <simpara>Conceptually, <emphasis>git write-tree</emphasis> sync()s the current index contents\r
25 into a set of tree files.\r
26 In order to have that match what is actually in your directory right\r
27 now, you need to have done a <emphasis>git update-index</emphasis> phase before you did the\r
28 <emphasis>git write-tree</emphasis>.</simpara>\r
29 </simplesect>\r
30 <simplesect id="git-write-tree(1)__options">\r
31 <title>OPTIONS</title>\r
32 <variablelist>\r
33 <varlistentry>\r
34 <term>\r
35 --missing-ok\r
36 </term>\r
37 <listitem>\r
38 <simpara>\r
39         Normally <emphasis>git write-tree</emphasis> ensures that the objects referenced by the\r
40         directory exist in the object database.  This option disables this\r
41         check.\r
42 </simpara>\r
43 </listitem>\r
44 </varlistentry>\r
45 <varlistentry>\r
46 <term>\r
47 --prefix=&lt;prefix&gt;/\r
48 </term>\r
49 <listitem>\r
50 <simpara>\r
51         Writes a tree object that represents a subdirectory\r
52         <emphasis>&lt;prefix&gt;</emphasis>.  This can be used to write the tree object\r
53         for a subproject that is in the named subdirectory.\r
54 </simpara>\r
55 </listitem>\r
56 </varlistentry>\r
57 </variablelist>\r
58 </simplesect>\r
59 <simplesect id="git-write-tree(1)__git">\r
60 <title>GIT</title>\r
61 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>\r
62 </simplesect>\r
63 </sect2>\r