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