From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Georges Ko Newsgroups: gmane.emacs.devel Subject: Re: How to make Emacs popular again. Date: Thu, 08 Oct 2020 22:05:07 +0800 Organization: gko.net Message-ID: References: <20200926163008.GS1349@protected.rcdrun.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1350"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (windows-nt) Hamster/2.0.0.1 To: emacs-devel@gnu.org Cancel-Lock: sha1:Mh8aVmitjgtlDeMjZePODynVnJk= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Oct 08 16:06:50 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 1kQWZF-0000EA-TX for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 16:06:49 +0200 Original-Received: from localhost ([::1]:55010 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQWZF-0004gx-0k for ged-emacs-devel@m.gmane-mx.org; Thu, 08 Oct 2020 10:06:49 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33846) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQWYb-00044c-BA for emacs-devel@gnu.org; Thu, 08 Oct 2020 10:06:09 -0400 Original-Received: from static.214.254.202.116.clients.your-server.de ([116.202.254.214]:39878 helo=ciao.gmane.io) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQWYZ-0003Dt-Cy for emacs-devel@gnu.org; Thu, 08 Oct 2020 10:06:09 -0400 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1kQWYV-0009s9-9V for emacs-devel@gnu.org; Thu, 08 Oct 2020 16:06:03 +0200 X-Injected-Via-Gmane: http://gmane.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=ged-emacs-devel@m.gmane-mx.org; helo=ciao.gmane.io X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/08 09:56:27 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -15 X-Spam_score: -1.6 X-Spam_bar: - X-Spam_report: (-1.6 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.25, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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:257206 Archived-At: Richard Stallman writes: > Can you suggest a way to make that easier for others in the future? > > > I didn't even distinguish correctly between Emacs and Emacs Lisp > > manuals, > > Can you suggest a way to clarify that? 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. In the Common Lisp HyperSpec, each chapter has a dictionary chapter at the end, listing all the functions, variables, etc. For example, if we look at Strings in http://www.lispworks.com/documentation/HyperSpec/Body/16_.htm, we can see: 16. Strings 16.1 String Concepts 16.2 The Strings Dictionary with the page "The Strings Dictionary" listing related elements: System Class STRING Type BASE-STRING Type SIMPLE-STRING Type SIMPLE-BASE-STRING Function SIMPLE-STRING-P Accessor CHAR, SCHAR Function STRING Function STRING-UPCASE, STRING-DOWNCASE, STRING-CAPITALIZE, NSTRING-UPCASE, NSTRING-DOWNCASE, NSTRING-CAPITALIZE Function STRING-TRIM, STRING-LEFT-TRIM, STRING-RIGHT-TRIM Function STRING=, STRING/=, STRING<, STRING>, STRING<=, STRING>=, STRING-EQUAL, STRING-NOT-EQUAL, STRING-LESSP, STRING-GREATERP, STRING-NOT-GREATERP, STRING-NOT-LESSP Function STRINGP Function MAKE-STRING In the Emacs Lisp manual, instead of: 4 Strings and Characters ************************ A string in Emacs Lisp is an array that contains an ordered sequence of characters. Strings are used as names of symbols, buffers, and files; to send messages to users; to hold text being copied between buffers; and for many other purposes. Because strings are so important, Emacs Lisp has many functions expressly for manipulating them. Emacs Lisp programs use strings more often than individual characters. *Note Strings of Events::, for special considerations for strings of keyboard character events. * Menu: * Basics: String Basics. Basic properties of strings and characters. * Predicates for Strings:: Testing whether an object is a string or char. ... it could be: 4 Strings and Characters ************************ A string in Emacs Lisp is an array that contains an ordered sequence of ... programs use strings more often than individual characters. --> [List of symbols] *Note Strings of Events::, for special considerations for strings of keyboard character events. * Menu: * Basics: String Basics. Basic properties of strings and characters. * Predicates for Strings:: Testing whether an object is a string or char. ... or 4 Strings and Characters ************************ A string in Emacs Lisp is an array that contains an ordered sequence of ... programs use strings more often than individual characters. *Note Strings of Events::, for special considerations for strings of keyboard character events. * Menu: --> * Strings and Characters Symbols. Symbols of strings and charactgers * Basics: String Basics. Basic properties of strings and characters. * Predicates for Strings:: Testing whether an object is a string or char. ... Georges -- Georges Ko gko@gko.net 2020-10-08