GNU bug report logs - #6595
24.0.50; tooltip doc

Previous Next

Full log

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 6595 <at> debbugs.gnu.org
Subject: Re: 24.0.50; tooltip doc
Date: Thu, 14 Jul 2011 02:08:37 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> The tooltip doc is not so great.
>
> Node Tooltips of the Emacs manual says nothing about tooltip mode being
> enabled by default.  And it says nothing about option
> `tooltip-use-echo-area'.
>
> More generally, it nowhere explains clearly what the recommended way of
> moving help to the echo area is (i.e. not using tooltips).  There is an
> option, `tooltip-use-echo-area', whose doc tells you that if you want
> help to appear in the echo area then you should customize this to
> non-nil and enable tooltip mode.

It says (now):

  You can toggle display of help tooltips (Tooltip mode) with the
command @kbd{M-x tooltip-mode}.  When Tooltip mode is disabled, the
help text is displayed in the echo area instead.

Which I think is clear enough.

> This is not clear to me.  Either there is a design flaw - perhaps
> `tooltip-use-echo-area' should be removed, or more likely something is
> simply missing from the doc.  Please explain - make this topic clear to
> users.

I think `tooltip-use-echo-area' should be obsoleted -- as you point out,
it seems nonsensical.

Does anybody know why `tooltip-use-echo-area' exists?  Hysterical
raisins?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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