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: How to make Emacs popular again. Date: Fri, 09 Oct 2020 09:41:57 +0300 Message-ID: <835z7j7vey.fsf@gnu.org> References: <20200926163008.GS1349@protected.rcdrun.com> <83blhc7f4x.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31786"; mail-complaints-to="usenet@ciao.gmane.io" Cc: bobnewell@bobnewell.net, rms@gnu.org, rpluim@gmail.com, emacs-devel@gnu.org, joaotavora@gmail.com, ghe@sdf.org, mardani29@yahoo.es To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Oct 09 08:56:54 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 1kQmKj-0008AZ-Ry for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 08:56:53 +0200 Original-Received: from localhost ([::1]:46794 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQmKi-0001wK-QK for ged-emacs-devel@m.gmane-mx.org; Fri, 09 Oct 2020 02:56:52 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55528) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kQm6W-0001iz-Aj for emacs-devel@gnu.org; Fri, 09 Oct 2020 02:42:12 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:54170) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQm6U-0000r1-Dg; Fri, 09 Oct 2020 02:42:10 -0400 Original-Received: from [176.228.60.248] (port=4170 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kQm6J-0000U8-7S; Fri, 09 Oct 2020 02:41:59 -0400 In-Reply-To: (message from Stefan Monnier on Thu, 08 Oct 2020 17:57:12 -0400) 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:257251 Archived-At: > From: Stefan Monnier > Date: Thu, 08 Oct 2020 17:57:12 -0400 > Cc: bobnewell@bobnewell.net, rms@gnu.org, rpluim@gmail.com, emacs-devel@gnu.org, > joaotavora@gmail.com, ghe@sdf.org, > Daniel Martín > > > For interactive functions (a.k.a. "commands"), there's an ambiguity > > here: should the link lead to the Emacs user manual or to the Emacs > > Lisp Reference manual? We could show both, but that could confuse > > users (as opposed to Lisp programmers). > > I think something like: > > Also documented in the >Emacs user's manual<. > Also documented in the >ELisp programmer's reference<. And now newcomers might be confused: which of these should they click? To resolve the confusion, the "Also documented" part should be replaced by something more specific. But even then I'm not sure the confusion will go away completely. Sometimes it is better to have only one watch, even if that watch is slightly askew, than having several ones, each one showing a different time.