.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "GIT-LS-TREE" 1 "" "" ""
.SH NAME
git-ls-tree \- Lists the contents of a tree object
.SH "SYNOPSIS"


\fIgit\-ls\-tree\fR [\-d] [\-r] [\-t] [\-z] [\-\-name\-only] [\-\-name\-status] [\-\-full\-name] [\-\-abbrev=[<n>]] <tree\-ish> [paths...]

.SH "DESCRIPTION"


Lists the contents of a given tree object, like what "/bin/ls \-a" does in the current working directory\&. Note that the usage is subtly different, though \- \fIpaths\fR denote just a list of patterns to match, e\&.g\&. so specifying directory name (without \fI\-r\fR) will behave differently, and order of the arguments does not matter\&.

.SH "OPTIONS"

.TP
<tree\-ish>
Id of a tree\-ish\&.

.TP
\-d
Show only the named tree entry itself, not its children\&.

.TP
\-r
Recurse into sub\-trees\&.

.TP
\-t
Show tree entries even when going to recurse them\&. Has no effect if \fI\-r\fR was not passed\&. \fI\-d\fR implies \fI\-t\fR\&.

.TP
\-z
\\0 line termination on output\&.

.TP
\-\-name\-only, \-\-name\-status
List only filenames (instead of the "long" output), one per line\&.

.TP
\-\-abbrev[=<n>]
Instead of showing the full 40\-byte hexadecimal object lines, show only handful hexdigits prefix\&. Non default number of digits can be specified with \-\-abbrev=<n>\&.

.TP
paths
When paths are given, show them (note that this isn't really raw pathnames, but rather a list of patterns to match)\&. Otherwise implicitly uses the root level of the tree as the sole path argument\&.

.SH "OUTPUT FORMAT"

.nf
<mode> SP <type> SP <object> TAB <file>
.fi


When the \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.

.SH "AUTHOR"


Written by Petr Baudis <pasky@suse\&.cz> Completely rewritten from scratch by Junio C Hamano <junkio@cox\&.net>, another major rewrite by Linus Torvalds <torvalds@osdl\&.org>

.SH "DOCUMENTATION"


Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.


This manual page is a stub\&. You can help the git documentation by expanding it\&.

.SH "GIT"


Part of the \fBgit\fR(7) suite