From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Marcin Borkowski Newsgroups: gmane.emacs.devel Subject: Re: Docstrings and manuals Date: Mon, 18 Apr 2016 18:30:49 +0200 Message-ID: <87lh4ac212.fsf@mbork.pl> References: <6ok2vyzwf9.fsf@fencepost.gnu.org> <08f70cda-44be-0657-e50a-2b2c80d2c21c@yandex.ru> <87oa9dzgl0.fsf@gmx.de> <87potshczh.fsf@gmx.de> <87h9f4ghzg.fsf@gmx.de> <8737qnc8ep.fsf@gmx.de> <87k2jwd3gr.fsf_-_@gmx.de> <8dfdfe5d-41fe-7c05-0054-0bd3e589390e@yandex.ru> <8737qkcwoo.fsf@gmx.de> <909c91ef-aa2e-4bcc-9828-603c4203e3d0@yandex.ru> <83ziss9sml.fsf@gnu.org> <878u0bcc0b.fsf@russet.org.uk> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1460997205 8906 80.91.229.3 (18 Apr 2016 16:33:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 18 Apr 2016 16:33:25 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 18 18:33:16 2016 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 1asC6t-0008Ff-8W for ged-emacs-devel@m.gmane.org; Mon, 18 Apr 2016 18:33:15 +0200 Original-Received: from localhost ([::1]:41149 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1asC6s-0008Sg-Mr for ged-emacs-devel@m.gmane.org; Mon, 18 Apr 2016 12:33:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39100) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1asC5a-00070I-5C for emacs-devel@gnu.org; Mon, 18 Apr 2016 12:32:51 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1asC4x-0004dq-VW for emacs-devel@gnu.org; Mon, 18 Apr 2016 12:31:54 -0400 Original-Received: from mail.mojserwer.eu ([195.110.48.8]:60469) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1asC4x-0004aw-MK for emacs-devel@gnu.org; Mon, 18 Apr 2016 12:31:15 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by mail.mojserwer.eu (Postfix) with ESMTP id 57054AD7C7F; Mon, 18 Apr 2016 18:30:53 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at mail.mojserwer.eu Original-Received: from mail.mojserwer.eu ([127.0.0.1]) by localhost (mail.mojserwer.eu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id OCMiVOvYJd0T; Mon, 18 Apr 2016 18:30:50 +0200 (CEST) Original-Received: from localhost (98-171.echostar.pl [213.156.98.171]) by mail.mojserwer.eu (Postfix) with ESMTPSA id 5EF74AD7C7D; Mon, 18 Apr 2016 18:30:50 +0200 (CEST) User-agent: mu4e 0.9.13; emacs 25.1.50.8 In-reply-to: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 195.110.48.8 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:203056 Archived-At: On 2016-04-18, at 15:47, Stefan Monnier wrote: > This said, the manual was also intended to be used as > a plain-old-burnable book. So if we decide to reduce the amount of > "reference info" by referring to docstrings, that means we mostly give > up on using lispref as a book and instead we force its use from > within Emacs. I think it's an acceptable choice, but I wouldn't be > surprised to hear other opinions. Like mine. Back in the old days, when I was a student and had a lot of time, I read most of the Emacs manual. (Yes, I did it on my computer, but today I'd probably do it on my ebook reader. And I have the Elisp reference on said reader, and I used to read it while commuting some time ago. Referring to docstrings would only aggravate me.) > Stefan Best, -- Marcin Borkowski http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski Faculty of Mathematics and Computer Science Adam Mickiewicz University