From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#20540: 25.0.50; Document tooltip woes, including `help-echo' Date: Sat, 9 May 2015 16:27:05 -0700 (PDT) Message-ID: <795eb88f-e9e7-4728-82d8-32d0caea52fb@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1431214113 10722 80.91.229.3 (9 May 2015 23:28:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 May 2015 23:28:33 +0000 (UTC) To: 20540@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 10 01:28:12 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1YrEAF-0004cj-2K for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 May 2015 01:28:11 +0200 Original-Received: from localhost ([::1]:60681 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrEAE-00041O-7y for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 May 2015 19:28:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52205) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrEAA-00041I-Sy for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:28:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrEA6-0001Re-RC for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:28:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58042) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrEA6-0001RW-NQ for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:28:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YrEA6-0002PW-Dt for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:28:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 09 May 2015 23:28:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20540 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.14312140459153 (code B ref -1); Sat, 09 May 2015 23:28:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 9 May 2015 23:27:25 +0000 Original-Received: from localhost ([127.0.0.1]:39784 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YrE9V-0002NU-0h for submit@debbugs.gnu.org; Sat, 09 May 2015 19:27:25 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38575) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YrE9R-0002ND-Ta for submit@debbugs.gnu.org; Sat, 09 May 2015 19:27:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrE9H-0000tD-TV for submit@debbugs.gnu.org; Sat, 09 May 2015 19:27:16 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:54616) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrE9H-0000t7-QK for submit@debbugs.gnu.org; Sat, 09 May 2015 19:27:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52072) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrE9G-0003zh-PX for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:27:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrE9C-0000sS-OJ for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:27:10 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:46086) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrE9C-0000sG-GJ for bug-gnu-emacs@gnu.org; Sat, 09 May 2015 19:27:06 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t49NR4oT024768 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 9 May 2015 23:27:05 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t49NR475030539 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sat, 9 May 2015 23:27:04 GMT Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t49NR4aL029607 for ; Sat, 9 May 2015 23:27:04 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:102627 Archived-At: 1. If you create a tooltip using, say, `x-show-tip', you can control the font, text color and size, background color, etc. Well, only some frame parameters seem to have any effect, when passed in argument PARMS. Just which parameters can or cannot be used for PARMS should be documented. 2. The word `tooltip' is hardly mentioned in the doc. Another doc fix would be to document `tooltip-mode' properly in the Elisp manual, saying which frame parameters you can use for `tooltip-frame-parameters', etc. 3. A related bug in `tooltip.el' is that the defcustom for `tooltip-frame-parameters' has no :type. Impossible for a user to customize the value properly using Customize. And no help about which parameters can be used effectively (see #2, above). 4. `help-echo': No doc saying whether the string can be propertized, and if so, which properties have any effect. Although `x-show-tip' seems to let you change the char size, color, background color, etc., and you can use property `display' with `help-echo', apparently you cannot change the face attributes of the `help-echo' string so that the appearance changes. This is quite a limitation, AFAICT. All of this kind of thing should be documented: what you can and cannot do - which parameters have an effect. You can make `help-echo' show an image instead of text, but you cannot simply change the text appearance of a `help-echo' string? How are users supposed to guess what is possible? Should be documented. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'