From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.help Subject: Re: Emacs Book Vs Emacs Manuals Date: Sun, 17 May 2015 17:47:29 +0300 Message-ID: <83h9rbfegu.fsf@gnu.org> References: <87fv77barj.fsf@gnu.org> <87zj5fgpd8.fsf@newcastle.ac.uk> <83h9rnp0yy.fsf@gnu.org> <83zj5enihg.fsf@gnu.org> <554EFEFD.6090908@gmail.com> <833834o4rv.fsf@gnu.org> <834mnjm73d.fsf@gnu.org> <838ucpgepi.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1431874085 8513 80.91.229.3 (17 May 2015 14:48:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 17 May 2015 14:48:05 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun May 17 16:47:56 2015 Return-path: Envelope-to: geh-help-gnu-emacs@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 1Ytzr9-0006qo-Ae for geh-help-gnu-emacs@m.gmane.org; Sun, 17 May 2015 16:47:55 +0200 Original-Received: from localhost ([::1]:37679 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ytzr8-00032Y-Ka for geh-help-gnu-emacs@m.gmane.org; Sun, 17 May 2015 10:47:54 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52194) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ytzqy-00032S-Ah for help-gnu-emacs@gnu.org; Sun, 17 May 2015 10:47:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ytzqt-0007G1-92 for help-gnu-emacs@gnu.org; Sun, 17 May 2015 10:47:44 -0400 Original-Received: from mtaout23.012.net.il ([80.179.55.175]:47858) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ytzqt-0007Fd-0K for help-gnu-emacs@gnu.org; Sun, 17 May 2015 10:47:39 -0400 Original-Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0NOI00B000X1CI00@a-mtaout23.012.net.il> for help-gnu-emacs@gnu.org; Sun, 17 May 2015 17:47:37 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NOI00B8A13C8K70@a-mtaout23.012.net.il> for help-gnu-emacs@gnu.org; Sun, 17 May 2015 17:47:37 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.175 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:104473 Archived-At: > From: Vaidheeswaran C > Date: Sun, 17 May 2015 21:05:26 +0530 > > On Saturday 16 May 2015 01:02 PM, Eli Zaretskii wrote: > > > Again, I think we already do all that in the Emacs manuals, where > > appropriate. > > - Emacs Manual :: I am arguing for FSF-blessed, Task-oriented "Emacs > Primer". And I am trying to tell you that a task-oriented Emacs Book might not be the best idea. > - 'Appropriate' :: The word "Approrpriate" is situational. Who > decides what is appropriate? The maintainers, the > users or the author of the manual. The maintainers, who are also the authors of the manual. It is always the author who decides, and users then submit bug reports if they don't like the result. > In so far as "Emacs Primer" is concerned, the Noobs become > authorities. If they say something is "inappropriate" (from where > they stand), then it will be deemed as such, without further > disputation. The issue at hand is not what is "inappropriate", but what is "appropriate". Saying that some material is described in a way that hampers understanding and usability is not enough for fixing the inadequacy: whoever fixes that has to come up with a more "appropriate" alternative. IOW, the users complain about the "inappropriate", and no one casts doubt in their right to do so. But the complaint alone is not enough to come up with a better alternative. And that is what I was talking about. > > But please note the catch in this approach, if used indiscriminately: > > the number of potential "Tasks" that an Emacs user can face is > > virtually infinite. These tasks break into certain "building blocks", > > which are combined in many different ways. If you always describe the > > "tasks", then you will need to repeat the description of these > > building blocks time and time again, which is a disadvantage. > > The question is: Whose "disadvantage" are you talking about? Everyone's. > > IOW, the above methodology is suitable only to relatively simple tools > > that support a small number of well-defined tasks. Emacs is not like > > that, especially if you take ELisp into consideration, because that's > > a reasonably general-purpose programming language, where the > > task-based approach is unsuitable, IMO. > > In so far as "Emacs Primer" is concerned, Elisp will be out-of-scope. If so, you are limiting the usability of your book too much. Most of customizations, for example, need to use Lisp, or at least understand it. If you leave it out of scope, your book will be abandoned by many users, because most of the tips they will find in the net do use Lisp. > The cookbooks and recipes are particularly popular and useful > http://www.emacswiki.org/emacs/ElispCookbook. I'm saying that a cookbook approach is not advisable, to say the least, for a tool as complex and versatile/flexible as Emacs.