GNU bug report logs - #6595
24.0.50; tooltip doc

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 6595 in the body.
You can then email your comments to 6595 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; tooltip doc
Date: Fri, 9 Jul 2010 10:52:51 -0700

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.
 
But why?  Why is there this separate option, in addition to the option
`tooltip-mode', whose customization to nil has the same effect of moving
help to the echo area?
 
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.

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2010-06-28 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/xpm/include'
 

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/

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

From: Chong Yidong <cyd <at> gnu.org>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: Drew Adams <drew.adams <at> oracle.com>, 6595 <at> debbugs.gnu.org
Subject: Re: bug#6595: 24.0.50; tooltip doc
Date: Sat, 28 Jan 2012 13:04:41 +0800

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

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

If I'm not wrong, Emacs used to have a more limited facility for showing
echo area tips without going through tooltip.el.  Nowadays both
graphical and echo area tooltips use tooltip.el.  I've marked
`tooltip-use-echo-area' as obsolete.

Previous Next

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