From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: base Date: Wed, 25 Aug 2010 21:51:35 +0300 Message-ID: <83sk22msp4.fsf@gnu.org> References: <20100822120642.GA1794@muc.de> <87bp8uzu9d.fsf@mithlond.arda> <871v9o7dmf.fsf@uwakimon.sk.tsukuba.ac.jp> <87wrrg5rzg.fsf@uwakimon.sk.tsukuba.ac.jp> <87r5ho5gyr.fsf@uwakimon.sk.tsukuba.ac.jp> <87hbij6hib.fsf@uwakimon.sk.tsukuba.ac.jp> <87k4nf7ezq.fsf@catnip.gol.com> <878w3v7dd2.fsf@catnip.gol.com> <83wrrfmljv.fsf@gnu.org> <87d3t75crc.fsf@uwakimon.sk.tsukuba.ac.jp> <8739u265eq.fsf@uwakimon.sk.tsukuba.ac.jp> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1282762194 25063 80.91.229.12 (25 Aug 2010 18:49:54 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 25 Aug 2010 18:49:54 +0000 (UTC) Cc: miles@gnu.org, emacs-devel@gnu.org To: "Stephen J. Turnbull" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Aug 25 20:49:50 2010 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OoL2f-0007TW-JW for ged-emacs-devel@m.gmane.org; Wed, 25 Aug 2010 20:49:46 +0200 Original-Received: from localhost ([127.0.0.1]:47454 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OoL2e-0005E8-Ln for ged-emacs-devel@m.gmane.org; Wed, 25 Aug 2010 14:49:44 -0400 Original-Received: from [140.186.70.92] (port=39146 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OoL2V-0005Dn-I6 for emacs-devel@gnu.org; Wed, 25 Aug 2010 14:49:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OoL2U-0002Lt-0D for emacs-devel@gnu.org; Wed, 25 Aug 2010 14:49:35 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:49188) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OoL2T-0002Lk-NR; Wed, 25 Aug 2010 14:49:33 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0L7Q00H001KKAX00@a-mtaout22.012.net.il>; Wed, 25 Aug 2010 21:49:31 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.70.215.111]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L7Q00GAM1MFAHA0@a-mtaout22.012.net.il>; Wed, 25 Aug 2010 21:49:29 +0300 (IDT) In-reply-to: <8739u265eq.fsf@uwakimon.sk.tsukuba.ac.jp> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:129223 Archived-At: > From: "Stephen J. Turnbull" > Cc: emacs-devel@gnu.org, > miles@gnu.org > Date: Thu, 26 Aug 2010 01:09:01 +0900 > > For git, it's in the Community Book, > http://book.git-scm.com/1_the_git_object_model.html, and following > chapters. > [...] > For Mercurial, the structure of a branch and its associated databases > is described in The Book, > http://hgbook.red-bean.com/read/behind-the-scenes.html. That's not a "mental model", at least not by your definition (nor by mine, should I guess what that is). That's the data structures part of the internals manual. I don't see how users would need to know that stuff in order to be able to use the tool safely and efficiently. It's like saying that Emacs users need to know how Lisp data types are implemented or what is the glyph matrix, in order to make good _use_ of Emacs (as opposed to _extend__ it). Sure, it's nice to know all that, but it isn't (and shouldn't) be necessary for a user. If you want to _extend_ the tool, then yes, you'd need this and some more. > I don't think any such thing exists for bzr. http://doc.bazaar.canonical.com/bzr.2.2/developers/overview.html and other docs in that area comes close, maybe. But that stuff is rightfully in the developers' department, IMO. > BTW, I have zero sympathy for the point of view that printed books and > HTML don't count as documentation unless they're distributed with the > program. Well, we disagree, then.