GNU bug report logs - #52870
Is displaying <menu-bar> bindings in describe-function useful?

Previous Next

Full log

Message #41 received at 52870 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Lars Ingebrigtsen <larsi <at> gnus.org>, Eli Zaretskii <eliz <at> gnu.org>
Cc: 52870 <at> debbugs.gnu.org
Subject: Re: bug#52870: Is displaying <menu-bar> bindings in describe-function
 useful?
Date: Sat, 15 Jan 2022 02:29:22 -0800

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

>> 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.

FWIW, I disagree that putting it at the end "pushes it too far".
Most docstrings can fit on a single screen so users will quickly learn
where to find it.

> Perhaps keeping it grouped with the binding info would be good, though.
> So:
>
> It is bound to C-h f and <help> f
> It can also be invoked from the menu: "Help Menu" -> "Describe" ...
>
> or something like that?

Sounds good to me.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.