From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: module documentation draft Date: Fri, 29 Sep 2017 21:08:10 +0300 Message-ID: <83wp4h5qet.fsf@gnu.org> References: <83k20h78sb.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1506708512 19826 195.159.176.226 (29 Sep 2017 18:08:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 29 Sep 2017 18:08:32 +0000 (UTC) Cc: phst@google.com, p.stephani2@gmail.com, emacs-devel@gnu.org To: =?utf-8?Q?Aur=C3=A9lien?= Aptel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Sep 29 20:08:26 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dxzi1-0004Fk-OP for ged-emacs-devel@m.gmane.org; Fri, 29 Sep 2017 20:08:21 +0200 Original-Received: from localhost ([::1]:36509 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dxzi9-0001As-4D for ged-emacs-devel@m.gmane.org; Fri, 29 Sep 2017 14:08:29 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39725) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dxzi2-0001An-Rr for emacs-devel@gnu.org; Fri, 29 Sep 2017 14:08:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dxzhy-0000Lz-Hi for emacs-devel@gnu.org; Fri, 29 Sep 2017 14:08:22 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:50454) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dxzhy-0000Lv-Do; Fri, 29 Sep 2017 14:08:18 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1427 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dxzhx-0000uA-Tu; Fri, 29 Sep 2017 14:08:18 -0400 In-reply-to: (message from =?utf-8?Q?Aur=C3=A9lien?= Aptel on Fri, 29 Sep 2017 18:49:59 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:218926 Archived-At: > From: Aurélien Aptel > Date: Fri, 29 Sep 2017 18:49:59 +0200 > Cc: Philipp Stephani , Philipp Stephani , > Emacs development discussions > > On Fri, Sep 29, 2017 at 6:45 PM, Eli Zaretskii wrote: > > I already read this, when this was first announced in April. > > Unfortunately, the style and the methodology of the description > > differs significantly from what we use in the ELisp manual. So this > > text will have to be reworked, and I didn't yet find time to do it. > > Eli, I believe you're talking about a different document. Philipp's > documentation is much closer to a specification than a tutorial. > > https://phst.github.io/emacs-modules No, I'm talking about this very document. I won't argue with the "tutorial" part, but the point is the style and the methodology of introducing the features there is very different from what I expect of a chapter in the ELisp manual. Just read some chapter or section which describes a single large feature, and you will see the difference. I don't mean to denigrate Philipp's work in any way, I'm just saying that importing it into the ELisp manual needs some non-trivial work, that's all.