From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#52870: Is displaying bindings in describe-function useful? Date: Sat, 15 Jan 2022 20:09:44 +0800 Message-ID: <87k0f1b3p3.fsf@yahoo.com> References: <83wnjnk0at.fsf@gnu.org> <83lf03jqvr.fsf@gnu.org> <83tueqimwc.fsf@gnu.org> <87bl0dwbrd.fsf@gnus.org> Reply-To: Po Lu Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2439"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.60 (gnu/linux) Cc: 52870@debbugs.gnu.org, Eli Zaretskii , Stefan Kangas To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jan 15 13:12:45 2022 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 1n8hvJ-0000Sw-90 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 15 Jan 2022 13:12:45 +0100 Original-Received: from localhost ([::1]:49502 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n8hvH-0000cF-5n for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 15 Jan 2022 07:12:43 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:47810) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n8htl-0000Yp-UR for bug-gnu-emacs@gnu.org; Sat, 15 Jan 2022 07:11:10 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46397) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n8htf-00068s-AR for bug-gnu-emacs@gnu.org; Sat, 15 Jan 2022 07:11:09 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n8hte-0006uz-F9 for bug-gnu-emacs@gnu.org; Sat, 15 Jan 2022 07:11:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Po Lu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 15 Jan 2022 12:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52870 X-GNU-PR-Package: emacs Original-Received: via spool by 52870-submit@debbugs.gnu.org id=B52870.164224860326508 (code B ref 52870); Sat, 15 Jan 2022 12:11:02 +0000 Original-Received: (at 52870) by debbugs.gnu.org; 15 Jan 2022 12:10:03 +0000 Original-Received: from localhost ([127.0.0.1]:39300 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n8hsh-0006tT-5h for submit@debbugs.gnu.org; Sat, 15 Jan 2022 07:10:03 -0500 Original-Received: from sonic311-23.consmr.mail.ne1.yahoo.com ([66.163.188.204]:36254) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n8hsf-0006sv-4x for 52870@debbugs.gnu.org; Sat, 15 Jan 2022 07:10:01 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1642248595; bh=DS8+bxNnSB4IDaFX+BWcw/3IfTPQH+9ysqZIBPKhrOs=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To; b=Bzu6w0IfFjepW6adEGOfK5HlXlBCHwBLpjs2DNVU5kpX3WUWBHsS3XHQFId/GkkeOJmEG2sjYuIWFeZ3yo7tViRZzMRniBiLn2nuaRcbaINfexiqPptcDKROBJ9Y8OgC129Hfxt9iHL/xiD9PYXXIyuCEruAp+1nZ1A/6oZRvlfxI5JVAvUKyL9c9fQCxTidcJ+3dnEo0NamDt4rMDZHRyQOfuboQKP8p6597JNKoyHFxlyEGyVOD8jbTWbuCu4ul6CtTVO018AUYsoMwYDepiRMLV0wvVDDJiH4wRbZTsgmdZbiQ/r7ns653Sy2HHEiAMvnEALXD2AQJI3CPiMYgw== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1642248595; bh=ox7bgIP/uOq9zCEXMBGxIr817E4qOwnzmxgR8pSa4JU=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=Xhp+h1yuCM2lerwqBT1HWCK88XTfEAOmdA4LnMJ6NdPPOzRUaYK2YaI91XyPwCqDNnyyd8dJOn1+4htzDrAQWhjHQVOEblxXXPSwFRkzhNxYVi+af43uiyRM5y0usW0JwwtftGxIEyelC7p6ITat3k4fslibRqCnUDrIWXLKTkxaRlj9ngKPPwBjqbpqlcugpd4h3s/rAsLkslcn53VCaoCZ28OGMAf6HOsYUnjWQsoLYjBCwcCNjG+UxESoFnsP7fdEgw5YL4UZy5bUlAldNfvh+dyZRHA6anaXQt4ISAyW3EedwIRL6xctNtf4rzcqwmp1LQgksR/k2QiiR8brTA== X-YMail-OSG: unh7T0UVM1lsjtZT2ctOxtTiYAWCX.t9dcvN_GHOXGo.bjKMt6f6YK8PqgHkgMS PeD2d9_u3xA71rIjHm3lWZtO2m.iDIicb4qRYZFFFM91cnouAp2EekvOle2UvretRaAI1tQOiPcd oY.rgAKXhD5h80J1CPJkeYP5NSWkkSOpeOKObUff82e6TGwxDYy8JXXxD4T.0GXb3YrEb8wF5xMg 46Y7FNWdHecHwfTdA68CO7jcYuAJLKwJcd935AA7L3cHUOr7J4NwEhaBDSHc8fk3MwfHiDaUoUXV KArivXDpYBF15lFgsM1Irv9n7kdRPdnhBDbyqARzCe7V8Klqh3T_7eMovAnvHDdEHwY5EfUzcwdE tOG.oBcs5.o0kSKAoF2hAThtIUcEsdB3L3PIghol00.wLm.8ylCodpK3PTZZx6pMi7laagmf1LI5 pWaZGjVDcPQhj.XZXte9Ns8Kd_26KDvMOORbSpf3xQIG9sv18FG_8KXjyA8mS238MjDNSiJlNHJ6 ZeLoBaJTS.Z58aZRyLj4fYkiec2eE6jvlH2PIKhKP73n5BPPgZ8ktIDNE4DYOKl2osuio7BG5sSu _NKgBF3Lss_aE6SCNh_b6QnqjJFzD4Bf1zHdYmlAU9aB2AkTq7rjIcC2EFuD1YxSzq7WUuh7sYBG 5wZGaMCqtYdrvuEZw8QEpxMH5ULbwHGg1kreMFfB6RN7Ld62xmQ1SwuG47T_BeOYyplcV3cOUVY1 HLXj6_qRgwHLA4IR9jPEqJpD26yoZWMLBoboD9WWKb2K.hMgztQDfsMf0.BM0WMmno7nl83K6CFS meuZI7_7MmRVztzYzhihpKGbRBvspTWR4BMgT8aiMO X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic311.consmr.mail.ne1.yahoo.com with HTTP; Sat, 15 Jan 2022 12:09:55 +0000 Original-Received: by kubenode512.mail-prod1.omega.sg3.yahoo.com (VZM Hermes SMTP Server) with ESMTPA ID afb89b1606d1d0623498ff787c4b9ce5; Sat, 15 Jan 2022 12:09:50 +0000 (UTC) In-Reply-To: <87bl0dwbrd.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sat, 15 Jan 2022 11:09:58 +0100") X-Mailer: WebService/1.1.19594 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo 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:224293 Archived-At: Lars Ingebrigtsen writes: > Eli Zaretskii writes: > >>> What is your rationale for this? Is it easier to accept if it is before >>> the "Probably introduced" line? >> >> The rationale is that hardly anyone ever looks at the "Probably >> introduced" line. Before it is slightly better, but not good enough: >> some doc strings are very long, so the menu-bar bindings will be >> pushed too far. > > I think saying explictly > > It can be invoked from the menu: "Help Menu" -> "Describe..." > > is a lot clearer (and helpful) for users than the current > > It is bound to C-h f, f, > . > > Perhaps keeping it grouped with the binding info would be good, though. > So: > > It is bound to C-h f and f > It can also be invoked from the menu: "Help Menu" -> "Describe" ... > > or something like that? FWIW I think it would be a good idea to do something like this: It is bound to C-h f, f, (which means it can be invoked from the menu: "Help Menu" -> "Describe" ...). Though I don't think I got the wording completely right there.