Re: Some Documentation/Usage Notes

From: Junio C Hamano <junkio@cox.net>
Date: Dec 6, 2005, 06:11 UTC
Message-ID: <7v64q27o1s.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <E1EjVGk-00015M-Np@jdl.com>

Jon Loeliger <jdl@freescale.com> writes:

Show 6 quoted lines

> Note to $self -- here are some tidbits ToDo:
>
> o   --help  doesn't work on:
>       git-hash-object
> 	git-init-db
> 	git-write-tree

Noted.  Thanks.

> o   There is an odd <any-file-on-the-filesystem> argment named
>     in the git-hash-object documentation.  Would <file> be better
>     and more consistent?  Or is there some subtlety that I am missing?

The subtlety is that it is the only parameter to the coreish command set that happily named a file outside the project directory (i.e. you can say "git-hash-object /etc/passwd" but you cannot say "git-update-index /etc/passwd" --- even if your repository is at /.git, you would say "git-update-index etc/passwd" for that). But you are right. That distinction is irrelevant.