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.bugs Subject: bug#45536: [PATCH] Pretty-print keys without <> around modifiers Date: Fri, 01 Jan 2021 14:28:16 +0200 Message-ID: <83tus0g7tr.fsf@gnu.org> References: <83sg7oidp6.fsf@gnu.org> <87sg7oosmx.fsf@gnus.org> <97ADE294-0674-4CAC-96B1-DAD947BA3A32@acm.org> <87im8ioan4.fsf@gnus.org> <9029B6ED-5201-417A-AE37-44A564561BBA@acm.org> <87h7o1c4uv.fsf@gnus.org> <83zh1sg947.fsf@gnu.org> <020D0443-20C2-4F8B-81FE-F1040469E919@acm.org> 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="16057"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 45536@debbugs.gnu.org To: Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jan 01 13:29:27 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1kvJYd-00047a-9V for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 01 Jan 2021 13:29:27 +0100 Original-Received: from localhost ([::1]:38728 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kvJYc-0008HU-9d for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 01 Jan 2021 07:29:26 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55118) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kvJYF-0008GB-Um for bug-gnu-emacs@gnu.org; Fri, 01 Jan 2021 07:29:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44203) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kvJYE-0002k7-I2 for bug-gnu-emacs@gnu.org; Fri, 01 Jan 2021 07:29:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kvJYE-0002Of-Eg for bug-gnu-emacs@gnu.org; Fri, 01 Jan 2021 07:29:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Jan 2021 12:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45536 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 45536-submit@debbugs.gnu.org id=B45536.16095041239186 (code B ref 45536); Fri, 01 Jan 2021 12:29:02 +0000 Original-Received: (at 45536) by debbugs.gnu.org; 1 Jan 2021 12:28:43 +0000 Original-Received: from localhost ([127.0.0.1]:55749 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kvJXv-0002O6-JD for submit@debbugs.gnu.org; Fri, 01 Jan 2021 07:28:43 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:33680) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kvJXu-0002Nu-4M for 45536@debbugs.gnu.org; Fri, 01 Jan 2021 07:28:42 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:52451) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kvJXo-0002b2-Rm; Fri, 01 Jan 2021 07:28:36 -0500 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:4084 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kvJXo-0005X4-3T; Fri, 01 Jan 2021 07:28:36 -0500 In-Reply-To: <020D0443-20C2-4F8B-81FE-F1040469E919@acm.org> (message from Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= on Fri, 1 Jan 2021 13:10:28 +0100) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:197130 Archived-At: > From: Mattias Engdegård > Date: Fri, 1 Jan 2021 13:10:28 +0100 > Cc: Lars Ingebrigtsen , 45536@debbugs.gnu.org > > 1 jan. 2021 kl. 13.00 skrev Eli Zaretskii : > > > What the manual uses is the format makeinfo emits for keys and key > > sequences in the Info format. It is only very loosely related to the > > way we format key sequences in Emacs. > > But it is what users see when they read the manual in Info, so clearly they cannot be surprised or confused by it. The users also see that in Info manuals that have nothing to do with Emacs, so their surprise, if it exists, is misguided, and if they use what's in the manual to request that Emacs behaves the same, those requests are misdirected. Besides, your suggested changes don't produce results that are 100% identical with what's in Info manuals, either, so how would you explain the differences to those users? > When the manual seeks to make an explicit example (with '<' instead of @key), it uses the logical style as well. See the examples used to illustrate the manual entry for the 'kbd' function itself. That's the tiny minority of the examples you show, most of them are unrelated to 'kbd'.