From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Getting ready to land native-compilation on master Date: Sat, 10 Apr 2021 10:23:02 +0300 Message-ID: <835z0u7gdl.fsf@gnu.org> References: <87a6q7xtz1.fsf@subst.net> <83czv36zjb.fsf@gnu.org> <86y2drc88j.fsf@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3701"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Andy Moreton Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Apr 10 09:24:04 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lV7yO-0000rP-NC for ged-emacs-devel@m.gmane-mx.org; Sat, 10 Apr 2021 09:24:04 +0200 Original-Received: from localhost ([::1]:53088 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lV7yN-0005EE-PP for ged-emacs-devel@m.gmane-mx.org; Sat, 10 Apr 2021 03:24:03 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54926) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lV7xe-0004He-79 for emacs-devel@gnu.org; Sat, 10 Apr 2021 03:23:18 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:40812) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lV7xe-00022X-05; Sat, 10 Apr 2021 03:23:18 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:1512 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lV7xc-0001aT-MY; Sat, 10 Apr 2021 03:23:17 -0400 In-Reply-To: <86y2drc88j.fsf@gmail.com> (message from Andy Moreton on Sat, 10 Apr 2021 01:07:40 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:267776 Archived-At: > From: Andy Moreton > Date: Sat, 10 Apr 2021 01:07:40 +0100 > > >> > >> > >> > >> > >> ATM to go further I think the approach would be dumping passes and/or > >> starting to look into the source code. I tried my best to share with > >> the community what I was working on and how but is not the easiest when > >> the thing is being worked. > > > > I think it would be good to take the relevant parts of your blog and > > rewrite them as introductory commentary to the code in comp.el, with > > the goal of providing enough overview and background information to > > let people discover the details by reading the code. > > Perhaps some of this material could be added to the "GNU Emacs > Internals" section of the elisp manual. Some of it, probably. But most of that stuff is inappropriate for the manual. We have in several files large commentaries that provide overview of the design and implementation of various features. For example, the beginning of xdisp.c and coding.c, the overview of w32 subprocess support in w32proc.c, etc. I was thinking about a similar overview in comp.el.