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: master 5b1109394c: ; * lisp/edmacro.el: Minor doc fixes. Date: Thu, 23 Jun 2022 08:43:11 +0300 Message-ID: <83a6a4exzk.fsf@gnu.org> References: <8335fwkd4i.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31111"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jun 23 07:49:29 2022 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 1o4Fib-000809-6f for ged-emacs-devel@m.gmane-mx.org; Thu, 23 Jun 2022 07:49:29 +0200 Original-Received: from localhost ([::1]:51232 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o4FiZ-0000EI-Sa for ged-emacs-devel@m.gmane-mx.org; Thu, 23 Jun 2022 01:49:27 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34390) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4Fcl-0006eH-62 for emacs-devel@gnu.org; Thu, 23 Jun 2022 01:43:29 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:34906) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4Fck-0004Nv-U8; Thu, 23 Jun 2022 01:43:26 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=qENaQ7nttTBOAFcjP7+GBY3hmSXCa+bhpO6g4315cxw=; b=bwTom67q2lqW TLNJ03NaePvn92KKoHfBig04kIFOl3OLLT33x316b93PSDpU00wUm2fBDMNjkBvmt8kQiNUptEQr8 /V4eiweOag+F+Myt4rNavDg3ZE1iDAv+nvEP+vbhmvLzvAObZ/epL7419Lfd3HOuez7Vr50Ep6aUf Sis+wiynlRthDxOqTYsrXSGoo8vYam/49/jdZSCBwzFz0ZXOwpFSUvrzb6t5JrV6STDXspKH14fFE lnNB3A44YrfzmB3PxEhXJHsxbtFaVKHmaTJ0NYRM3DYSYKwP9lrhqJ9c0hyvtIbxs7FbkK3QDxFuj 8msNX1NpJo4s+L1iCBAujw==; Original-Received: from [87.69.77.57] (port=4492 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 1o4Fcd-00026V-Gp; Thu, 23 Jun 2022 01:43:20 -0400 In-Reply-To: (message from Stefan Kangas on Wed, 22 Jun 2022 22:17:45 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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:291524 Archived-At: > From: Stefan Kangas > Date: Wed, 22 Jun 2022 22:17:45 +0200 > Cc: Emacs developers > > Eli Zaretskii writes: > > > Stefan, I don't understand this change. Is it no longer "kosher" to > > use RET, TAB, SPC, etc. in our doc strings? Why do we need to quote > > these simple keys? > > The reason for fontifying them is consistency, so that keybindings are > always displayed the same in *Help*. > > AFAIU, such consistency is important for effective UX design. Again, that's not what I asked. I asked whether _all_ references to these keys in doc strings should be quoted. If the answer is YES, I guess that means we will soon see changes to that effect all over the place in the existing code, and we should comment on patches which don't do that to tell the contributors to do so. Right?