Merge with gitk.
[git.git] / Documentation / git-ls-tree.txt
1 git-ls-tree(1)
2 ==============
3 v0.1, May 2005
4
5 NAME
6 ----
7 git-ls-tree - Lists the contents of a tree object.
8
9
10 SYNOPSIS
11 --------
12 'git-ls-tree' [-d] [-r] [-z] <tree-ish> [paths...]
13
14 DESCRIPTION
15 -----------
16 Lists the contents of a tree object, like what "/bin/ls -a" does
17 in the current working directory.
18
19 OPTIONS
20 -------
21 <tree-ish>::
22         Id of a tree-ish.
23
24 -d::
25         show only the named tree entry itself, not its children
26
27 -r::
28         recurse into sub-trees
29
30 -z::
31         \0 line termination on output
32
33 paths::
34         When paths are given, show them.  Otherwise implicitly
35         uses the root level of the tree as the sole path argument.
36
37
38 Output Format
39 -------------
40         <mode> SP <type> SP <object> TAB <file>
41
42
43 Author
44 ------
45 Written by Linus Torvalds <torvalds@osdl.org>
46 Completely rewritten from scratch by Junio C Hamano <junkio@cox.net>
47
48 Documentation
49 --------------
50 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
51
52 GIT
53 ---
54 Part of the link:git.html[git] suite
55