Re: "What's This?" in Describe submenu

[Luc Teirlinck <teirllm@dms.auburn.edu>]

Eli Zaretskii wrote:

   Surely, it should be possible to explain what some menu or button does
   without going to the manual!

It should be possible to explain what a menu item or button does
without going either to the manual _or_ the docstring.  Ideally, the
name makes it clear, if not the tooltip should make it clear.

For instance:

   Unless, of course, we change the name to "Describe Key or Menu Item
   or Toolbar Button or Custom Button or Mode-line Click or...".

No, one could just make the tooltip say:

Display documentation of command bound to a key, menu-item or mouse click.

Note that the person who started the thread you mentioned did not ask
for docstrings because the tooltips were not clear enough.  He wanted
to get rid of the tooltips because he found the names were already
clear enough and because he found tooltips popping up where he was
working annoying.  He wanted the tooltips (not docstrings) to only
show up after pressing S-F1.

Somehow. nobody told him that he could just disable Tooltip mode and
that the tooltips would still be available in the echo area. 

Sincerely,

Luc.