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