From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Abrahams Subject: Re: [doc] User Manual Suggestion Date: Fri, 24 Apr 2009 20:53:37 -0400 Message-ID: <1A9F6DB0-983F-4A5B-B3B7-33227C11F36A@boostpro.com> References: <200904240051.46233.johan@herland.net> <200904242230.13239.johan@herland.net> <20090424213848.GA14493@coredump.intra.peff.net> <4E155CC5-B20A-4B79-8CBF-9D1E0E36920F@boostpro.com> <20090425003531.GA18125@coredump.intra.peff.net> Mime-Version: 1.0 (Apple Message framework v930.4) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Cc: Daniel Barkalow , Johan Herland , Michael Witten , git@vger.kernel.org, "J. Bruce Fields" To: Jeff King X-From: git-owner@vger.kernel.org Sat Apr 25 02:55:14 2009 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1LxWAj-0001z1-A2 for gcvg-git-2@gmane.org; Sat, 25 Apr 2009 02:55:13 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752140AbZDYAxk (ORCPT ); Fri, 24 Apr 2009 20:53:40 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1751744AbZDYAxk (ORCPT ); Fri, 24 Apr 2009 20:53:40 -0400 Received: from boost-consulting.com ([206.71.190.141]:57785 "EHLO boost-consulting.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750890AbZDYAxj (ORCPT ); Fri, 24 Apr 2009 20:53:39 -0400 Received: from [192.168.188.150] (207-172-223-249.c3-0.smr-ubr3.sbo-smr.ma.static.cable.rcn.com [207.172.223.249]) (Authenticated sender: dave) by boost-consulting.com (Postfix) with ESMTPSA id 11C001CC1F; Fri, 24 Apr 2009 17:51:07 -0700 (PDT) In-Reply-To: <20090425003531.GA18125@coredump.intra.peff.net> X-Mailer: Apple Mail (2.930.4) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Apr 24, 2009, at 8:35 PM, Jeff King wrote: > On Fri, Apr 24, 2009 at 08:19:18PM -0400, David Abrahams wrote: > >>> git show master >>> git show master:Documentation >>> git show master:Makefile >>> >> 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. > > Actually, it is not the generally of trees that I think is interesting > there, but the generality of _objects_. That is, each of those > things is > a first-class object, and has a unique name by which it can be > referred. I'm sorry, but I think most people would find that so unremarkable that making a big deal about it would lead to "what am I missing here" confusion. Maybe a person who's exclusively used CVS (or older) technologies before coming to Git would be happy to know that, but it's sort of obvious. In CVS the lack of first-class directories sticks out like a sore thumb. -- David Abrahams BoostPro Computing http://boostpro.com