From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Imports / inclusion of s.el into Emacs Date: Sun, 03 May 2020 23:09:21 -0400 Message-ID: References: <831ro2tqqx.fsf@gnu.org> <4a1fd3f4-df92-c756-9874-4d07b54148ac@yandex.ru> <83v9lesapw.fsf@gnu.org> <83pnbms9m8.fsf@gnu.org> <83a72qs4z2.fsf@gnu.org> <83wo5uqoh5.fsf@gnu.org> <838si9qf7s.fsf@gnu.org> <83pnblov3t.fsf@gnu.org> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="114278"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, dgutov@yandex.ru, joaotavora@gmail.com, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Yuri Khan Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon May 04 05:16:52 2020 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 1jVRb9-000TcO-R9 for ged-emacs-devel@m.gmane-mx.org; Mon, 04 May 2020 05:16:51 +0200 Original-Received: from localhost ([::1]:54268 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVRb8-0003bS-Tl for ged-emacs-devel@m.gmane-mx.org; Sun, 03 May 2020 23:16:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35840) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jVRU2-0000Ft-Tl for emacs-devel@gnu.org; Sun, 03 May 2020 23:09:30 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:44170) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jVRU2-000511-Ie; Sun, 03 May 2020 23:09:30 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jVRTt-0007vI-Ae; Sun, 03 May 2020 23:09:23 -0400 In-Reply-To: (message from Yuri Khan on Sun, 3 May 2020 23:32:01 +0700) 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:248783 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > API lists are not tutorials. They are the reference manual, just > presented in a very condensed form. A user who is moderately > experienced with an API but has not committed it into memory will > sometimes forget exact names of functions, and a concise API list will > refresh his/her memory just enough to continue coding. That's a valid point. I think we could generate API lists like these automatically from the text of the Emacs Lisp Ref Manual. Just search through the chosen node (and its subnodes) for definition constructs, and process them to get calling sequences. Would someone like to try writing that? -- Dr Richard Stallman Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)