From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?utf-8?Q?=C3=93scar_Fuentes?= Newsgroups: gmane.emacs.devel Subject: Re: Apologia for bzr Date: Fri, 03 Jan 2014 21:50:34 +0100 Message-ID: <87ha9k4wo5.fsf@wanadoo.es> References: <20140102095347.6834E381D0C@snark.thyrsus.com> <87fvp6bdd9.fsf_-_@ktab.red-bean.com> <83wqiixqbb.fsf@gnu.org> <20140102172804.GB13245@thyrsus.com> <83vby2xo6x.fsf@gnu.org> <20140102183432.GB13506@thyrsus.com> <83sit6xgfg.fsf@gnu.org> <8761q18kni.fsf@thinkpad.tsdh.org> <838uuxxsxu.fsf@gnu.org> <87sit56m1c.fsf@thinkpad.tsdh.org> <83ob3sx1pf.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1388782263 20765 80.91.229.3 (3 Jan 2014 20:51:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 3 Jan 2014 20:51:03 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 03 21:51:09 2014 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 1VzBhz-0000w7-1b for ged-emacs-devel@m.gmane.org; Fri, 03 Jan 2014 21:51:07 +0100 Original-Received: from localhost ([::1]:51787 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VzBhy-0001OY-NJ for ged-emacs-devel@m.gmane.org; Fri, 03 Jan 2014 15:51:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51965) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VzBhp-0001ON-Ld for emacs-devel@gnu.org; Fri, 03 Jan 2014 15:51:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VzBhj-00044M-Q1 for emacs-devel@gnu.org; Fri, 03 Jan 2014 15:50:57 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:46440) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VzBhj-000448-Jh for emacs-devel@gnu.org; Fri, 03 Jan 2014 15:50:51 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1VzBhf-0000Rt-Jn for emacs-devel@gnu.org; Fri, 03 Jan 2014 21:50:47 +0100 Original-Received: from 225.red-81-44-202.dynamicip.rima-tde.net ([81.44.202.225]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 03 Jan 2014 21:50:47 +0100 Original-Received: from ofv by 225.red-81-44-202.dynamicip.rima-tde.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 03 Jan 2014 21:50:47 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 17 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 225.red-81-44-202.dynamicip.rima-tde.net User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) Cancel-Lock: sha1:gftwJNDhd1BD6am3easj1fg+lCY= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 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:167232 Archived-At: Eli Zaretskii writes: > I guess we should stop investing so much effort in the Emacs manuals, > then -- there's so much resources out there, let the users look for > them instead. As already said, man pages are not for learning core concepts of the tool (except for the specific man pages devoted to that purpose, of course.) You can't expect to edit some files on a source tree versioned under git and then do a `git help commit' and learn how to commit your changes right away, because git uses some concepts which are not shared by other VCS you might know. You need to understand how git works first and learn the terminology. Really, I see no difference with any other non-trivial software package. It is not as if the output of C-h k M-w is self-contained and free of Emacs-specific jargon.