From: Jeff King <peff@peff.net>
Date: Fri, 24 Apr 2009 21:38:48 GMT
Subject: Re: [doc] User Manual Suggestion
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