From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Lists of symbols in the Lisp Manual Date: Thu, 08 Oct 2020 23:32:53 -0400 Message-ID: References: <20200926163008.GS1349@protected.rcdrun.com> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40690"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Georges Ko Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 09 05:34:03 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 1kQjAQ-000ATH-EB for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 05:34:02 +0200 Original-Received: from localhost ([::1]:49894 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQjAP-0002CW-Ca for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 23:34:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54718) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQj9L-0001Oq-TS for emacs-devel@gnu.org; Thu, 08 Oct 2020 23:32:55 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:51323) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQj9L-0005TR-6T; Thu, 08 Oct 2020 23:32:55 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1kQj9J-000484-Oo; Thu, 08 Oct 2020 23:32:53 -0400 In-Reply-To: (message from Georges Ko on Thu, 08 Oct 2020 22:05:07 +0800) 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:257245 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. ]]] > Regarding the Emacs Lisp manual, something that would be helpful is to > list the functions, user options, commands, etc. of each chapter at the > top or in its own section, so that one doesn't need to go to that > specific chapter just to get the forgotten name of a function or one can > quickly see all the symbols in one page for a topic. I have trouble understanding that concretely. It says to add a list to each chapter, so that people don't have to go to that chapter. That seems self-contradictory. I suppose that you have a coherent idea in mind, and that it involves adding lots of lists to the manual. This could make the manual substantially longer and thus substantially raise the price of the printed manual. That would be a substantial drawback. Is this something that you would only want on line? If it is only on line, it would not have that drawback. Scripts could generate those lists by scanning the source of the Lisp Manual. -- 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)