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: Keybinding styles Date: Thu, 16 Sep 2021 08:20:55 +0300 Message-ID: <83mtod9juw.fsf@gnu.org> References: <87tuim2bys.fsf@gmail.com> <5069841.y6mJfzL4n5@galex-713.eu> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31380"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, theophilusx@gmail.com, emacs-devel@gnu.org, andremegafone@gmail.com, monnier@iro.umontreal.ca, john@yates-sheets.org To: Alexandre Garreau Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Sep 16 07:22:15 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 1mQjqg-0007wG-Q3 for ged-emacs-devel@m.gmane-mx.org; Thu, 16 Sep 2021 07:22:14 +0200 Original-Received: from localhost ([::1]:39512 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQjqe-000716-Ue for ged-emacs-devel@m.gmane-mx.org; Thu, 16 Sep 2021 01:22:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45812) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQjpd-0006MO-DJ for emacs-devel@gnu.org; Thu, 16 Sep 2021 01:21:09 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:39966) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQjpb-0001ZL-9F; Thu, 16 Sep 2021 01:21:07 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:3535 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQjpS-0001Wi-5f; Thu, 16 Sep 2021 01:20:59 -0400 In-Reply-To: <5069841.y6mJfzL4n5@galex-713.eu> (message from Alexandre Garreau on Wed, 15 Sep 2021 23:29:24 +0200) 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:274790 Archived-At: > From: Alexandre Garreau > Cc: André A. Gomes , eliz@gnu.org, theophilusx@gmail.com, monnier@iro.umontreal.ca, john@yates-sheets.org > Date: Wed, 15 Sep 2021 23:29:24 +0200 > > Don’t we already have a special markup in texinfo for keybindings? No, we don't. (And it's not "we" who define the Texinfo markup, it's the Texinfo language, which is not maintained and developed by the Emacs project.) What is needed here is to have the _command_ invoked by a key sequence, rather than the key sequence itself, be mentioned in Texinfo and propagated to Info with some markup there, so that info.el could replace the command name by the actual key binding. Something like the \\[..] markup we have for doc strings. > otherwise we ought to: we control texinfo (essentially used for emacs and > some other popular gnu stuff (since it’s used by gnu stuff)), and the main > implementation already is emacs. That's not true. First, the Texinfo language is not controlled by the Emacs project, it's developed and maintained by a sibling GNU project. And second, there are actively developed Info readers that are not in Emacs: the trivial example is the stand-alone reader that is part of the Texinfo project. We cannot make unilateral changes in this area. > We could add some markup to contextualize the origin of keybindings (for > instance what mode/software the current section is talking about) I don't think I understand the details of this proposal, but in any case, many sections in the manual do not talk about a single major mode.