Re: [doc] User Manual Suggestion

From: Jeff King <peff@peff.net>
Date: Apr 24, 2009, 21:38 UTC
Message-ID: <20090424213848.GA14493@coredump.intra.peff.net>
In-Reply-To: <alpine.LNX.2.00.0904241655090.2147@iabervon.org>

On Fri, Apr 24, 2009 at 05:34:00PM -0400, Daniel Barkalow wrote:

> I'd say that blobs and trees are an implementation detail of "the full 
> content of a version of the project", not something conceptually 
> important. Likewise, the date representation used in commits isn't

I disagree. I think it's important to note that trees and blobs have a name, and you can refer to them. Once you know that, the fact that you can do:

  git show master
  git show master:Documentation
  git show master:Makefile

just makes sense. You are always just specifying an object, but the type is different for each (and show "does the right thing" based on object type).

No, that isn't critical for understanding how _commit_ operations work, but I think that is exactly the sort of conceptual knowledge that let people use git more fully.

-Peff