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: Sun, 10 May 2015 09:11:49 -0700 (PDT) Message-ID: References: <<795eb88f-e9e7-4728-82d8-32d0caea52fb@default>> <<83bnhso5u8.fsf@gnu.org>> 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 1431274345 4894 80.91.229.3 (10 May 2015 16:12:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 10 May 2015 16:12:25 +0000 (UTC) Cc: 20540@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 10 18:12: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 1YrTpp-0000zY-SY for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 May 2015 18:12:10 +0200 Original-Received: from localhost ([::1]:33997 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrTpo-0001sm-6V for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 May 2015 12:12:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44984) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrTpj-0001sV-Ik for bug-gnu-emacs@gnu.org; Sun, 10 May 2015 12:12:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrTpi-0006mv-9N for bug-gnu-emacs@gnu.org; Sun, 10 May 2015 12:12:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58436) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrTpi-0006mn-6X for bug-gnu-emacs@gnu.org; Sun, 10 May 2015 12:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YrTph-0004PY-NZ for bug-gnu-emacs@gnu.org; Sun, 10 May 2015 12:12:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 10 May 2015 16:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20540 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20540-submit@debbugs.gnu.org id=B20540.143127431916948 (code B ref 20540); Sun, 10 May 2015 16:12:01 +0000 Original-Received: (at 20540) by debbugs.gnu.org; 10 May 2015 16:11:59 +0000 Original-Received: from localhost ([127.0.0.1]:40178 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YrTpe-0004PI-Ea for submit@debbugs.gnu.org; Sun, 10 May 2015 12:11:59 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:28717) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YrTpb-0004P2-Ui for 20540@debbugs.gnu.org; Sun, 10 May 2015 12:11:56 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t4AGBmDo030227 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 May 2015 16:11:50 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t4AGBm7N019918 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 10 May 2015 16:11:48 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t4AGBmKM032527; Sun, 10 May 2015 16:11:48 GMT In-Reply-To: <<83bnhso5u8.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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:102637 Archived-At: > > 3. ... the defcustom for `tooltip-frame-parameters' has no :type... >=20 > I cannot reproduce this one: my tooltip.el has this: Sorry, my bad. (Perhaps it was the gratuitous extra blank line after the first doc-string line that threw me off and made me think the doc string and definition ended there. Dunno why such lines are added sometimes. Those are (minor) bugs, AFAICT. I don't mean this as an excuse for my not reading the defcustom more carefully, but it might be the reason that I was mistaken.) And I see now that the doc string says that "font and color parameters are ignored, and the attributes of the `tooltip' face are used instead." It would be good to add info that to the doc in the manual, IMO. So yes, there is a :type. But the :type value should, I think, be something more like this, not just `sexp': :type '(alist :key-type (symbol :tag "Parameter") :value-type (sexp :tag "Value")) The :tag's are not required, but at least the type should be :alist, I think. Unless I'm missing something - can it ever be something besides an alist? Especially if only some frame parameters are allowed as keys (the others are ignored, so why allow them for customization?), maybe a more restrictive type than `symbol' should be used - e.g. `restricted-sexp' with matching for the allowed symbols. (You will perhaps argue that we didn't exclude including ignored parameters before, so this would be an incompatible change. I can't really argue against that, except to say that it still might not be bad to start now, raising an error when you try to add an "ignored" parameter.) > > 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. >=20 > See above: the doc string of tooltip-frame-parameters says font and > color parameters are ignored. #4 is about `help-echo'. Search the Elisp manual for `help-echo'. See node `Special Properties', for instance. Nowhere does it specify such limitations, AFAICT. And font and color parameters are not the only ones ignored. And see the rest of the bug report, including the part about `x-show-tip' - which face attributes and which frame parameters have no effect? And why is `help-echo' more limited wrt specifying tooltip appearance than is `x-show-tip'? There are several things said in the doc or doc strings here and there about tooltips, but (a) the doc is incomplete and (b) it's not clear what the relations between the various things are: `help-echo' string properties, `x-show-tip' frame, `tooltip-frame-parameters'. Apparently (from experimentation) `x-show-tip' does not bother with `tooltip-frame-parameters'. But you seem to be suggesting that a `help-echo' tooltip does, and that `help-echo' string properties are overridden by `tooltip-frame-parameters' frame-parameter limitations, and that all of this should be obvious. At least that's my guess, based on your repeating, for #4 (`help-echo'), the info about the doc string of `tooltip-frame-parameters'.