mirror of
https://github.com/git/git
synced 2024-08-28 03:59:25 +00:00
6af1f0192f
This is a complete rewrite of ls-tree to make it behave more
like what "/bin/ls -a" does in the current working directory.
Namely, the changes are:
- Unlike the old ls-tree behaviour that used paths arguments to
restrict output (not that it worked as intended---as pointed
out in the mailing list discussion, it was quite incoherent),
this rewrite uses paths arguments to specify what to show.
- Without arguments, it implicitly uses the root level as its
sole argument ("/bin/ls -a" behaves as if "." is given
without argument).
- Without -r (recursive) flag, it shows the named blob (either
file or symlink), or the named tree and its immediate
children.
- With -r flag, it shows the named path, and recursively
descends into it if it is a tree.
- With -d flag, it shows the named path and does not show its
children even if the path is a tree, nor descends into it
recursively.
This is still request-for-comments patch. There is no mailing
list consensus that this proposed new behaviour is a good one.
The patch to t/t3100-ls-tree-restrict.sh illustrates
user-visible behaviour changes. Namely:
* "git-ls-tree $tree path1 path0" lists path1 first and then
path0. It used to use paths as an output restrictor and
showed output in cache entry order (i.e. path0 first and then
path1) regardless of the order of paths arguments.
* "git-ls-tree $tree path2" lists path2 and its immediate
children but having explicit paths argument does not imply
recursive behaviour anymore, hence paths/baz is shown but not
paths/baz/b.
Signed-off-by: Junio C Hamano <junkio@cox.net>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
56 lines
976 B
Plaintext
56 lines
976 B
Plaintext
git-ls-tree(1)
|
|
==============
|
|
v0.1, May 2005
|
|
|
|
NAME
|
|
----
|
|
git-ls-tree - Lists the contents of a tree object.
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'git-ls-tree' [-d] [-r] [-z] <tree-ish> [paths...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Lists the contents of a tree object, like what "/bin/ls -a" does
|
|
in the current working directory.
|
|
|
|
OPTIONS
|
|
-------
|
|
<tree-ish>::
|
|
Id of a tree.
|
|
|
|
-d::
|
|
show only the named tree entry itself, not its children
|
|
|
|
-r::
|
|
recurse into sub-trees
|
|
|
|
-z::
|
|
\0 line termination on output
|
|
|
|
paths::
|
|
When paths are given, shows them. Otherwise implicitly
|
|
uses the root level of the tree as the sole path argument.
|
|
|
|
|
|
Output Format
|
|
-------------
|
|
<mode> SP <type> SP <object> TAB <file>
|
|
|
|
|
|
Author
|
|
------
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
Completely rewritten from scratch by Junio C Hamano <junkio@cox.net>
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
GIT
|
|
---
|
|
Part of the link:git.html[git] suite
|
|
|