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: On the subject of Git, Bazaar, and the future of Emacs development Date: Tue, 2 Apr 2013 15:47:51 +0000 Message-ID: <20130402154751.GB3278@acm.acm> References: <20130401203140.171a6d45@anarchist> <20130402145457.GA3278@acm.acm> <878v51arp7@ch.ristopher.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1364917709 25961 80.91.229.3 (2 Apr 2013 15:48:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 2 Apr 2013 15:48:29 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 02 17:48:56 2013 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 1UN3SA-0007fC-Mj for ged-emacs-devel@m.gmane.org; Tue, 02 Apr 2013 17:48:54 +0200 Original-Received: from localhost ([::1]:53635 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UN3Rm-0003Hq-4G for ged-emacs-devel@m.gmane.org; Tue, 02 Apr 2013 11:48:30 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50058) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UN3Rd-0003E2-ON for emacs-devel@gnu.org; Tue, 02 Apr 2013 11:48:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UN3RW-0003nJ-Fn for emacs-devel@gnu.org; Tue, 02 Apr 2013 11:48:21 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:51162 helo=mail.muc.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UN3RW-0003mo-68 for emacs-devel@gnu.org; Tue, 02 Apr 2013 11:48:14 -0400 Original-Received: (qmail 16729 invoked by uid 3782); 2 Apr 2013 15:48:11 -0000 Original-Received: from acm.muc.de (pD951B5B3.dip.t-dialin.net [217.81.181.179]) by colin.muc.de (tmda-ofmipd) with ESMTP; Tue, 02 Apr 2013 17:48:09 +0200 Original-Received: (qmail 4602 invoked by uid 1000); 2 Apr 2013 15:47:51 -0000 Content-Disposition: inline In-Reply-To: <878v51arp7@ch.ristopher.com> User-Agent: Mutt/1.5.21 (2010-09-15) X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 8.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:158545 Archived-At: On Tue, Apr 02, 2013 at 04:16:19PM +0100, Christopher Schmidt wrote: > Alan Mackenzie writes: > > hg wins here hands down. Given how many commands there are in git, > > having to study multi-hundred line man pages here seems suboptimal. > > Indeed, having to learn git could be a barrier to participation in > > projects which use it. > git is incredibly powerful. This is reflected by the amount and length > of the official documentation. Indeed. hg has about the same degree of power (reflected in the fact that many large projects use it), yet its entire documentation is in a single, easily searchable ~7000 line man page. > There is no need to study all git-related man-pages. When it comes to > understanding and implementing a conservative workflow one just needs a > handful of different commands with about one or two arguments each. As a beginner, one must first work out what these commands are, then continually look Somewhere Else to be reminded how to use them. hg is far superior here, in that its commands are fewer (and thus more powerful) and its help command is actually helpful. > I really like git's man pages. In my opinion, the documentation is > precise, meaningful and does not leave much room any questions. man pages are suboptimal for beginners. It's largely beginners who'll want to type "git help ....". > A lot of books have been written about git. In particular, please check > http://git-scm.com/book > This one is both tutorial and reference and has been translated to many > languages. I'll give it a look, sometime. > I do not think it takes much time to master git. Good! > Christopher -- Alan Mackenzie (Nuremberg, Germany).