Re: as promised, docs: git for the confused

From: Junio C Hamano <junkio@cox.net>
Date: Dec 8, 2005, 21:53 UTC
Message-ID: <7vk6efb6ib.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <20051208063409.31967.qmail@science.horizon.com>

linux@horizon.com writes:

Show 8 quoted lines

> * Terminology - heads, branches, refs, and revisions
>
> (This is a supplement to what's already in "man git".)
>
> The most common object needed by git primitives is a tree.  Since a
> commit points to a tree and a tag points to a commit, both of these are
> acceptable "tree-ish" objects and can be used interchangeably.  Likewise,
> a tag is "commit-ish" and can be used where a commit is required.

I am unsure if we want to further confuse readers by saying this, but technically, "Likewise, a tag which is commit-ish can be used in place of commit". Not all tags are necessarily commit-ish. v2.6.11 tag is tree-ish but not commit-ish for example. Typically, however, a tag is commit-ish.