Re: [PATCH] Add a notice to the doc of git-ls-tree.

From: Petr Baudis <pasky@suse.cz>
Date: Jul 20, 2008, 23:39 UTC
Message-ID: <20080720233956.GH10151@machine.or.cz>
In-Reply-To: <7vy73w16nj.fsf@gitster.siamese.dyndns.org>

On Sun, Jul 20, 2008 at 04:24:00PM -0700, Junio C Hamano wrote:

Show 11 quoted lines

> Petr Baudis <pasky@suse.cz> writes:
> 
> > I think that ls-tree simply shouldn't auto-fill its pathspec based on
> > current prefix in case no pathspec was supplied. Patch to follow.
> 
> Have you dug the list archive from mid-to-late December 2005 that prompted
> the current behaviour (and introduction of --full-name)?  I haven't.  A
> change to always do the --full-name can only be justified by doing so and
> rehashing the issues.
> 
> On the other hand, "fix" is welcome.

You are right, now that I understand the issue better, there's no good fix for this except perhaps introducing --no-prefix, which is not my itch to scratch. Here's my original wording improvement:

	Note that if you are within a subdirectory of your working copy,
	'git ls-tree' will automatically prepend the subdirectory prefix
	to the specified paths, and assume the prefix specified in case
	no paths were given - no matter what the tree object is! Thus,
	within a subdirectory, 'git ls-tree' behaves as expected only
	when run on a root tree object.

-- 
				Petr "Pasky" Baudis
As in certain cults it is possible to kill a process if you know
its true name.  -- Ken Thompson and Dennis M. Ritchie