Re: [doc] User Manual Suggestion

From: David Abrahams <dave@boostpro.com>
Date: Apr 25, 2009, 00:19 UTC
Message-ID: <4E155CC5-B20A-4B79-8CBF-9D1E0E36920F@boostpro.com>
In-Reply-To: <20090424213848.GA14493@coredump.intra.peff.net>

On Apr 24, 2009, at 5:38 PM, Jeff King wrote:

Show 19 quoted lines

> 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).

I don't believe you need to know about trees and blobs to make sense of that. Those are just directories and files. The whole idea that trees are a more-general thing that could be used to represent something other than directory structure and blobs could be used to represent something other than file contents is way below most peoples' need-to-know threshold.

-- David Abrahams BoostPro Computing http://boostpro.com