gitweb: Document features better
[git.git] / Documentation / git-write-tree.txt
blobc85fa89c30e25ed026d2e95a2b537798f878e50f
1 git-write-tree(1)
2 =================
4 NAME
5 ----
6 git-write-tree - Creates a tree object from the current index
9 SYNOPSIS
10 --------
11 'git-write-tree' [--missing-ok] [--prefix=<prefix>/]
13 DESCRIPTION
14 -----------
15 Creates a tree object using the current index.
17 The index must be in a fully merged state.
19 Conceptually, `git-write-tree` sync()s the current index contents
20 into a set of tree files.
21 In order to have that match what is actually in your directory right
22 now, you need to have done a `git-update-index` phase before you did the
23 `git-write-tree`.
26 OPTIONS
27 -------
28 --missing-ok::
29         Normally `git-write-tree` ensures that the objects referenced by the
30         directory exist in the object database.  This option disables this
31         check.
33 --prefix=<prefix>/::
34         Writes a tree object that represents a subdirectory
35         `<prefix>`.  This can be used to write the tree object
36         for a subproject that is in the named subdirectory.
39 Author
40 ------
41 Written by Linus Torvalds <torvalds@osdl.org>
43 Documentation
44 --------------
45 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
47 GIT
48 ---
49 Part of the gitlink:git[7] suite