From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: master 5b1109394c: ; * lisp/edmacro.el: Minor doc fixes. Date: Thu, 23 Jun 2022 11:15:43 +0200 Message-ID: References: <8335fwkd4i.fsf@gnu.org> <83a6a4exzk.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27625"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Emacs developers To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jun 23 11:18:27 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 1o4Iyp-00075Z-5h for ged-emacs-devel@m.gmane-mx.org; Thu, 23 Jun 2022 11:18:27 +0200 Original-Received: from localhost ([::1]:57908 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o4Iyo-00082P-0H for ged-emacs-devel@m.gmane-mx.org; Thu, 23 Jun 2022 05:18:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42264) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4IwQ-0005pI-Hy for emacs-devel@gnu.org; Thu, 23 Jun 2022 05:15:58 -0400 Original-Received: from mail-pl1-x632.google.com ([2607:f8b0:4864:20::632]:47086) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o4IwO-0002vY-Ea; Thu, 23 Jun 2022 05:15:57 -0400 Original-Received: by mail-pl1-x632.google.com with SMTP id q18so6199298pld.13; Thu, 23 Jun 2022 02:15:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=mMM1EM3t8jbzMCbymDiMZ9U8w028O+5NafVOqHl7EAQ=; b=RK4ECMi4+13/Q/eB34LiwWp8WkQ4dhlU5eWOsT6xmSRVXH9FoX5iGqxeUrrEVzgq9X q69xD7PY1zDFb82c+LMTHOolpyIMw4wTEzay92zRSejI4T8Q382uhLQwkl7xZQP2A4IV j4cQYiO7jQkvUCd0vMq+7iPR8mexzA3CiXyT8AKDQdGKavE9doGkW6uB6EFCKUpiWLPz ESQb82B1m/Aq+EPx7rTpOXxa4CAybwseOoBphgynAeV6E3dDtFm5FW4DQ5MlX1bZmn4S PMWyipKPQOcchahNpGnqErPHtqXpojzsvyMDA4iYNpx7eVSneCBzTo3dzoO0VAlkkAQ6 27+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=mMM1EM3t8jbzMCbymDiMZ9U8w028O+5NafVOqHl7EAQ=; b=W/KQ2q36XElwsxjnnlt2u9giP/v37rb+wRAHqnP92ihkWaNWNQvfQ0r3QcXqF0bV4K EiZ+jiboZO9TFdnlVDRyChaiYCNhHBI8D9OLP0v1xLWzMhkFGjnLrQ/NFvFRm88iSrbi Es1MLXQOXXPHW5T/pITOTDjZk24/hw5fqLvBUQnIRORvWsyU2zLTfKuZcCGzZFvIfRuE SyXHbbom9rcgs5BH1GoA7PHxznWcJNhegkBLr1FDuuRYEMw/+mgYCUHsCWGTyJw43KLP FDzWj7/tOZp4Kt9/McLDlkyheNgDbUIsvOWhkoMZaTb1EbCAw+VgxjUyo5e61ZMA1WJ4 gWiQ== X-Gm-Message-State: AJIora+t9IzIIBLV6LeLDh1/oV+iYS3Uysp2uPOzufPHPWAZ4OBDzEhy AFIEXFWVulFCnA04fjTWros1b3GV3+GF9xLEawxwq6Y/GJY= X-Google-Smtp-Source: AGRyM1tWPVgFrB2o2I0YamCS8E4k36xxyo2dZQBBD+D56VbDGTH2EPw6qoBHHbSy1TFbqq9a54K9Y7WuL5yec7Yd1qI= X-Received: by 2002:a17:902:aa86:b0:168:f0ef:95f6 with SMTP id d6-20020a170902aa8600b00168f0ef95f6mr38102986plr.145.1655975754596; Thu, 23 Jun 2022 02:15:54 -0700 (PDT) In-Reply-To: <83a6a4exzk.fsf@gnu.org> Received-SPF: pass client-ip=2607:f8b0:4864:20::632; envelope-from=stefankangas@gmail.com; helo=mail-pl1-x632.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:291532 Archived-At: Eli Zaretskii writes: > Again, that's not what I asked. I asked whether _all_ references to > these keys in doc strings should be quoted. If these are keybindings, then yes. I think we have cases where RET does not refer to a keybinding. In such cases, it should not be tagged. > 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? I think we should ask contributors to do that, yes. I'd encourage everyone to tag keybindings as such with substitute-command-keys when they run into them. However, it would be nice if we thought of more clear conventions in these common cases: 1. M-x some-prompting-command RET 2. M-x some-prompting-command some-user-input RET Should there be a non-fontified space between the command name and RET in (1) or should they have the same face? Should "some-user-input" in (2) have the same face as a keybinding, or should we have a separate face (for example: no face at all by convention) for replies to prompts?