git-am: do not lose already edited final-commit when resuming.
[git/jnareb-git/bp-gitweb.git] / Documentation / git-ls-tree.txt
blobba0438e9ad444d3647af192f3483f27a73f8e294
1 git-ls-tree(1)
2 ==============
4 NAME
5 ----
6 git-ls-tree - Lists the contents of a tree object.
9 SYNOPSIS
10 --------
11 'git-ls-tree' [-d] [-r] [-z] <tree-ish> [paths...]
13 DESCRIPTION
14 -----------
15 Lists the contents of a tree object, like what "/bin/ls -a" does
16 in the current working directory.
18 OPTIONS
19 -------
20 <tree-ish>::
21         Id of a tree-ish.
23 -d::
24         show only the named tree entry itself, not its children
26 -r::
27         recurse into sub-trees
29 -z::
30         \0 line termination on output
32 paths::
33         When paths are given, show them.  Otherwise implicitly
34         uses the root level of the tree as the sole path argument.
37 Output Format
38 -------------
39         <mode> SP <type> SP <object> TAB <file>
41 When `-z` option is not used, TAB, LF, and backslash characters
42 in pathnames are represented as `\t`, `\n`, and `\\`,
43 respectively.
46 Author
47 ------
48 Written by Linus Torvalds <torvalds@osdl.org>
49 Completely rewritten from scratch by Junio C Hamano <junkio@cox.net>
51 Documentation
52 --------------
53 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
55 GIT
56 ---
57 Part of the gitlink:git[7] suite