From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: VC mode and git Date: Wed, 1 Apr 2015 16:36:51 +0000 Message-ID: <20150401163651.GC2633@acm.fritz.box> References: <20150331085055.GA2871@acm.fritz.box> <87zj6tiko1.fsf@uwakimon.sk.tsukuba.ac.jp> <20150331104935.GB2871@acm.fritz.box> <87y4mdi7tj.fsf@uwakimon.sk.tsukuba.ac.jp> <20150331214347.GH2871@acm.fritz.box> <20150401103225.GA2633@acm.fritz.box> <837ftvsy5f.fsf@gnu.org> <87iodfc2yh.fsf@wanadoo.es> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1427906239 15205 80.91.229.3 (1 Apr 2015 16:37:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 1 Apr 2015 16:37:19 +0000 (UTC) Cc: emacs-devel@gnu.org To: =?iso-8859-1?Q?=D3scar?= Fuentes Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Apr 01 18:37:12 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1YdLdf-0006xH-Kx for ged-emacs-devel@m.gmane.org; Wed, 01 Apr 2015 18:37:12 +0200 Original-Received: from localhost ([::1]:54013 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YdLdf-0003br-1x for ged-emacs-devel@m.gmane.org; Wed, 01 Apr 2015 12:37:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44399) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YdLdb-0003bX-JA for emacs-devel@gnu.org; Wed, 01 Apr 2015 12:37:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YdLdX-0008D3-Gg for emacs-devel@gnu.org; Wed, 01 Apr 2015 12:37:07 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:10801 helo=mail.muc.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YdLdX-0008Cy-7X for emacs-devel@gnu.org; Wed, 01 Apr 2015 12:37:03 -0400 Original-Received: (qmail 79843 invoked by uid 3782); 1 Apr 2015 16:37:01 -0000 Original-Received: from acm.muc.de (pD951AF7A.dip0.t-ipconnect.de [217.81.175.122]) by colin.muc.de (tmda-ofmipd) with ESMTP; Wed, 01 Apr 2015 18:37:00 +0200 Original-Received: (qmail 25266 invoked by uid 1000); 1 Apr 2015 16:36:51 -0000 Content-Disposition: inline In-Reply-To: <87iodfc2yh.fsf@wanadoo.es> User-Agent: Mutt/1.5.23 (2014-03-12) X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x X-Received-From: 193.149.48.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:184744 Archived-At: Hello, Óscar. On Wed, Apr 01, 2015 at 04:56:06PM +0200, Óscar Fuentes wrote: > Eli Zaretskii writes: > >> Manpages are not tutorials. There are a lot of good tutorials > >> available. Just use them. > > There's a large gap between where the tutorials leave off and the man > > pages pick up. I found nothing to fill that gap, in terms of > > background information regarding what is going on. There are a lot of > > specific questions answered on StackOverflow and such likes, but they > > provide cookbook-style solutions, which is very good for solving > > specific problems, but not if one wants to understand what's going on > > better. > Please note that Alan mentioned several times that he is not interested > on the "what's going on" part of Git (which IMO is a reasonable stance, > but I do not understand why he insists on ignoring the advice about not > using the man pages for learning how to use Git and read instead some of > the multiple tutorials and introductions available on the 'net.) These tutorials all deal with the basics. I've read (parts of) a few of them. Their information density is very low - such is the nature of tutorials. If I have to skim over yet another exposition of how wonderful it is that VCSs can work with branches, and so on, I think I'll scream. I think there's been just one concrete tutorial suggested to me, and that was . I'm sure it's an excellent book, but it's several hundred pages long. What I need is an information density which is typical of man pages (or of the Emacs manuals). I am frustrated and angered that the git man pages don't have this information density - they suffer from vagueness amongst other things - but they're all that there is. > > So once you are past the basic stuff, you have nowhere else > > to go to learn more, except from your own experience. > IIRC there are several technical articles about the innards of Git. -- Alan Mackenzie (Nuremberg, Germany).