From unknown Tue Jun 17 23:30:16 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#20164 <20164@debbugs.gnu.org> To: bug#20164 <20164@debbugs.gnu.org> Subject: Status: 25.0.50; Do not tell users that `x-show-tip' is internal Reply-To: bug#20164 <20164@debbugs.gnu.org> Date: Wed, 18 Jun 2025 06:30:16 +0000 retitle 20164 25.0.50; Do not tell users that `x-show-tip' is internal reassign 20164 emacs submitter 20164 Drew Adams severity 20164 wishlist tag 20164 wontfix thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Mar 22 12:40:41 2015 Received: (at submit) by debbugs.gnu.org; 22 Mar 2015 16:40:41 +0000 Received: from localhost ([127.0.0.1]:60833 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YZivY-0003rD-Se for submit@debbugs.gnu.org; Sun, 22 Mar 2015 12:40:41 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34859) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YZivT-0003qt-Lc for submit@debbugs.gnu.org; Sun, 22 Mar 2015 12:40:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YZivN-0001AW-Lv for submit@debbugs.gnu.org; Sun, 22 Mar 2015 12:40:30 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:55258) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YZivN-0001AQ-JN for submit@debbugs.gnu.org; Sun, 22 Mar 2015 12:40:29 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:36578) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YZivM-0000K3-LN for bug-gnu-emacs@gnu.org; Sun, 22 Mar 2015 12:40:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YZivG-00017x-Ux for bug-gnu-emacs@gnu.org; Sun, 22 Mar 2015 12:40:28 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:26576) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YZivG-000176-OW for bug-gnu-emacs@gnu.org; Sun, 22 Mar 2015 12:40:22 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t2MGeLU9028674 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 22 Mar 2015 16:40:21 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t2MGeLUv002361 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sun, 22 Mar 2015 16:40:21 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t2MGeKOv004359 for ; Sun, 22 Mar 2015 16:40:21 GMT MIME-Version: 1.0 Message-ID: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> Date: Sun, 22 Mar 2015 09:40:22 -0700 (PDT) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; Do not tell users that `x-show-tip' is internal X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) The doc string says this: This is an internal function; Lisp code should call `tooltip-show'. Why? While it is true that you can get, using `tooltip-show', the behavior of arg PARMS by binding `tooltip-frame-parameters', the behavior of args DX and DY by binding `tooltip-x-offset' and `tooltip-y-offset', and the behavior of arg TIMEOUT by binding `tooltip-hide-delay' (which is not documented, BTW), you cannot the behavior of arg FRAME. And binding user options is not really a great way to control the function behavior, in general. So `tooltip-show' is not really a user-level substitute for "internal" `x-tooltip-show'. What's more, the doc of `tooltip-show' explicitly refers to how variable `x-max-tooltip-size' affects the behavior. Why refer to that "internal" variable? And if it is not "internal" then why does it have the prefix `x-'? Why isn't there a `tooltip-max-size' option, corresponding to the other `tooltip-*' options? It looks like this design/implementation is incomplete. It is great to have `tooltip-mode' and `tooltip-show'. But we should not be telling users to use only `tooltip-show' and not `x-show-tip'. I see no reason for that. The two functions are different; that's all. Neither should be considered more "internal" than the other. 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' From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 08:28:52 2019 Received: (at 20164) by debbugs.gnu.org; 2 Aug 2019 12:28:52 +0000 Received: from localhost ([127.0.0.1]:55991 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htWg0-0004cY-9i for submit@debbugs.gnu.org; Fri, 02 Aug 2019 08:28:52 -0400 Received: from quimby.gnus.org ([80.91.231.51]:58008) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htWfy-0004cO-JY for 20164@debbugs.gnu.org; Fri, 02 Aug 2019 08:28:50 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htWfu-0001vT-DH; Fri, 02 Aug 2019 14:28:48 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#20164: 25.0.50; Do not tell users that `x-show-tip' is internal References: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> Date: Fri, 02 Aug 2019 14:28:45 +0200 In-Reply-To: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> (Drew Adams's message of "Sun, 22 Mar 2015 09:40:22 -0700 (PDT)") Message-ID: <87ftmjrbsy.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > The doc string says this: > > This is an internal function; Lisp code should call `tooltip-show'. > > Why? While it is true that you can get, using `tooltip-show', the > behavior of arg PARMS by bin [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 20164 Cc: 20164@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Drew Adams writes: > The doc string says this: > > This is an internal function; Lisp code should call `tooltip-show'. > > Why? While it is true that you can get, using `tooltip-show', the > behavior of arg PARMS by binding `tooltip-frame-parameters', the behavior > of args DX and DY by binding `tooltip-x-offset' and `tooltip-y-offset', > and the behavior of arg TIMEOUT by binding `tooltip-hide-delay' (which is > not documented, BTW), you cannot the behavior of arg FRAME. And binding > user options is not really a great way to control the function behavior, > in general. I agree that the calling conventions for `x-show-tip' seems to be much nicer than `tooltip-show'. > So `tooltip-show' is not really a user-level substitute for "internal" > `x-tooltip-show'. > > What's more, the doc of `tooltip-show' explicitly refers to how variable > `x-max-tooltip-size' affects the behavior. Why refer to that "internal" > variable? And if it is not "internal" then why does it have the prefix > `x-'? Why isn't there a `tooltip-max-size' option, corresponding to the > other `tooltip-*' options? The commit that added the line about it being internal just says "doc fix", so I can only guess what the reason behind it was: Perhaps we're trying to get away from all `x-' functions and replace them with generic functions? But, as you say, then it's odd that we still have `x-max-tooltip-size'. So perhaps the way forward here is to make `x-max-tooltip-size' an obsolete alias for a new variable `tooltip-max-size'? And add a way to specify the FRAME parameter somehow... but the calling convention for that function is kinda meh. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 10:21:08 2019 Received: (at 20164) by debbugs.gnu.org; 2 Aug 2019 14:21:08 +0000 Received: from localhost ([127.0.0.1]:57505 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htYQe-0001fd-Go for submit@debbugs.gnu.org; Fri, 02 Aug 2019 10:21:08 -0400 Received: from eggs.gnu.org ([209.51.188.92]:51273) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htYQc-0001eo-B7 for 20164@debbugs.gnu.org; Fri, 02 Aug 2019 10:21:06 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:40098) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1htYQW-0007oD-W6; Fri, 02 Aug 2019 10:21:01 -0400 Received: from [176.228.60.248] (port=2636 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1htYQW-00010W-G1; Fri, 02 Aug 2019 10:21:00 -0400 Date: Fri, 02 Aug 2019 17:20:53 +0300 Message-Id: <83imrffy2i.fsf@gnu.org> From: Eli Zaretskii To: Lars Ingebrigtsen In-reply-to: <87ftmjrbsy.fsf@mouse.gnus.org> (message from Lars Ingebrigtsen on Fri, 02 Aug 2019 14:28:45 +0200) Subject: Re: bug#20164: 25.0.50; Do not tell users that `x-show-tip' is internal References: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> <87ftmjrbsy.fsf@mouse.gnus.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 20164 Cc: 20164@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lars Ingebrigtsen > Date: Fri, 02 Aug 2019 14:28:45 +0200 > Cc: 20164@debbugs.gnu.org > > Drew Adams writes: > > > The doc string says this: > > > > This is an internal function; Lisp code should call `tooltip-show'. > > > > Why? While it is true that you can get, using `tooltip-show', the > > behavior of arg PARMS by binding `tooltip-frame-parameters', the behavior > > of args DX and DY by binding `tooltip-x-offset' and `tooltip-y-offset', > > and the behavior of arg TIMEOUT by binding `tooltip-hide-delay' (which is > > not documented, BTW), you cannot the behavior of arg FRAME. And binding > > user options is not really a great way to control the function behavior, > > in general. I wonder when we will stop wasting time and energy on hair-splitting reports such as this one. Probably never. Sigh. > I agree that the calling conventions for `x-show-tip' seems to be much > nicer than `tooltip-show'. If you do, please explain it to me, because the above arguments don't convince me, certainly not that x-show-tip's API is "nicer". Maybe I'm missing something. Tooltips are about showing short hints about various elements of the UI, they are not general-purpose tools for showing arbitrary text in arbitrary places. And tooltip-show looks entirely reasonable and adequate for the job as defined above. It could be that someone tried to use tooltips as poor-man's child frames, but we now have those as first-class objects, so any such (ab)use would be unnecessary. > > So `tooltip-show' is not really a user-level substitute for "internal" > > `x-tooltip-show'. > > > > What's more, the doc of `tooltip-show' explicitly refers to how variable > > `x-max-tooltip-size' affects the behavior. Why refer to that "internal" > > variable? And if it is not "internal" then why does it have the prefix > > `x-'? Why isn't there a `tooltip-max-size' option, corresponding to the > > other `tooltip-*' options? I don't remember why I added a reference to that variable when I extended the doc string of tooltip-show in 2001(!), but I hope no one will argue that it's important to know the displayed text might be truncated. > The commit that added the line about it being internal just says "doc > fix", Guilty as charged ;-) > so I can only guess what the reason behind it was No need for guessing; see the short discussion starting at https://lists.gnu.org/archive/html/emacs-pretest-bug/2007-03/msg00261.html The conclusion to take out of that discussion is that whoever uses x-show-tip should know very well what they are doing, which is another way of saying "kids, don't try that at home", a.k.a. "an internal function". > So perhaps the way forward here is to make `x-max-tooltip-size' an > obsolete alias for a new variable `tooltip-max-size'? And add a way to > specify the FRAME parameter somehow... but the calling convention for > that function is kinda meh. Before we do something like that, I'd like someone to explain why would they need to call x-show-tip for showing a tooltip. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 11:38:59 2019 Received: (at 20164) by debbugs.gnu.org; 2 Aug 2019 15:38:59 +0000 Received: from localhost ([127.0.0.1]:57619 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htZdy-0005pe-QA for submit@debbugs.gnu.org; Fri, 02 Aug 2019 11:38:59 -0400 Received: from userp2130.oracle.com ([156.151.31.86]:33954) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htZdx-0005pQ-99 for 20164@debbugs.gnu.org; Fri, 02 Aug 2019 11:38:57 -0400 Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x72FcnYO182372; Fri, 2 Aug 2019 15:38:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=YE2fPleLl8S6lF6NU+U6+K6fJ3xiW++7HnnYLqMkCLQ=; b=EbRtfgsVK2pgI7YjIWq5kNL8bx5pBGi4ymzvkL7sDaXrw0AM6xWT2Bxyu1oXpJ0IUt6V Mmkk626myGP7iQS2k9zO6oeiuqJWQDqCZWfPsmwPFT8vn1HdL2lOpszxe+tkN+cSaNpJ YLI+G7Ywwe6ed7JrW2/edSM456KEja05oTjQo8kcTupPyRf0iYUGTj05gqwwKV08/yPM XHRCfBXGR69CU9EUkofLYJNn2/WKkh/+qxlDnByy8RFN+dz9pMG/odyVKc8LqumuQht1 U1Mn6ioZwicXGCIz7lnX26uPSzgMjRAAllqieramq3eZR9KgMWh40UBvHo2R4WGrpzr3 Aw== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2130.oracle.com with ESMTP id 2u0e1ub651-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 02 Aug 2019 15:38:49 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x72FbsM2129074; Fri, 2 Aug 2019 15:38:43 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3030.oracle.com with ESMTP id 2u38fcbnfy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 02 Aug 2019 15:38:43 +0000 Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x72FcgqU023807; Fri, 2 Aug 2019 15:38:42 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 2 Aug 2019 08:38:41 -0700 (PDT) From: Drew Adams To: Lars Ingebrigtsen Subject: RE: bug#20164: 25.0.50; Do not tell users that `x-show-tip' is internal References: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> <87ftmjrbsy.fsf@mouse.gnus.org> In-Reply-To: <87ftmjrbsy.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9337 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908020159 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9337 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908020160 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 20164 Cc: 20164@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > So perhaps the way forward here is to make `x-max-tooltip-size' an > obsolete alias for a new variable `tooltip-max-size'? And add a way to > specify the FRAME parameter somehow... but the calling convention for > that function is kinda meh. I guess you're asking others. If you're also asking me then my answer is in the bug report. To be specific: 1. Yes, rename `x-max-tooltip-size' as you suggest. 2. Don't make `x-show-tip' internal or tell users it's internal. 3. Don't point users of `x-show-tip' to `tooltip-show'. That's not at all the same thing. Just rehabilitate `x-show-tip'. 4. If you want to rename all of the `x-*' stuff to remove that prefix, fine by me (assuming `x-*' aliases for backward compatibility). From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 14:04:02 2019 Received: (at 20164) by debbugs.gnu.org; 2 Aug 2019 18:04:02 +0000 Received: from localhost ([127.0.0.1]:57677 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htbuM-0001HS-0w for submit@debbugs.gnu.org; Fri, 02 Aug 2019 14:04:02 -0400 Received: from quimby.gnus.org ([80.91.231.51]:33396) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htbuK-0001HF-9g for 20164@debbugs.gnu.org; Fri, 02 Aug 2019 14:04:00 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htbuF-0004e7-MD; Fri, 02 Aug 2019 20:03:58 +0200 From: Lars Ingebrigtsen To: Eli Zaretskii Subject: Re: bug#20164: 25.0.50; Do not tell users that `x-show-tip' is internal References: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> <87ftmjrbsy.fsf@mouse.gnus.org> <83imrffy2i.fsf@gnu.org> Date: Fri, 02 Aug 2019 20:03:54 +0200 In-Reply-To: <83imrffy2i.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 02 Aug 2019 17:20:53 +0300") Message-ID: <87imrfphpx.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eli Zaretskii writes: >> I agree that the calling conventions for `x-show-tip' seems to be much >> nicer than `tooltip-show'. > > If you do, please explain it to me, because the above arguments don't > convince me, certain [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 20164 Cc: 20164@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Eli Zaretskii writes: >> I agree that the calling conventions for `x-show-tip' seems to be much >> nicer than `tooltip-show'. > > If you do, please explain it to me, because the above arguments don't > convince me, certainly not that x-show-tip's API is "nicer". Maybe > I'm missing something. I think explicit parameters to a function is almost always to be preferred to binding variables and then calling a function that takes no parameters. In this case, you're supposed bind `tooltip-{x,y}-offset' according to the doc string. > No need for guessing; see the short discussion starting at > > https://lists.gnu.org/archive/html/emacs-pretest-bug/2007-03/msg00261.html > > The conclusion to take out of that discussion is that whoever uses > x-show-tip should know very well what they are doing, which is another > way of saying "kids, don't try that at home", a.k.a. "an internal > function". Makes sense to me, and I'm closing this bug report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 14:04:15 2019 Received: (at control) by debbugs.gnu.org; 2 Aug 2019 18:04:15 +0000 Received: from localhost ([127.0.0.1]:57680 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htbuY-0001I9-J6 for submit@debbugs.gnu.org; Fri, 02 Aug 2019 14:04:15 -0400 Received: from quimby.gnus.org ([80.91.231.51]:33416) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htbuU-0001Hz-8z for control@debbugs.gnu.org; Fri, 02 Aug 2019 14:04:10 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htbuR-0004eI-MD for control@debbugs.gnu.org; Fri, 02 Aug 2019 20:04:09 +0200 Date: Fri, 02 Aug 2019 20:04:07 +0200 Message-Id: <87h86zphpk.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #20164 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 20164 wontfix close 20164 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 20164 wontfix close 20164 quit From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 02 14:57:54 2019 Received: (at 20164) by debbugs.gnu.org; 2 Aug 2019 18:57:54 +0000 Received: from localhost ([127.0.0.1]:57719 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htckT-0004o8-Tu for submit@debbugs.gnu.org; Fri, 02 Aug 2019 14:57:54 -0400 Received: from eggs.gnu.org ([209.51.188.92]:56708) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htckS-0004ns-2L for 20164@debbugs.gnu.org; Fri, 02 Aug 2019 14:57:52 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44060) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1htckM-00023j-HQ; Fri, 02 Aug 2019 14:57:46 -0400 Received: from [176.228.60.248] (port=3649 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1htckJ-0006m2-VS; Fri, 02 Aug 2019 14:57:44 -0400 Date: Fri, 02 Aug 2019 21:57:39 +0300 Message-Id: <835znffl98.fsf@gnu.org> From: Eli Zaretskii To: Lars Ingebrigtsen In-reply-to: <87imrfphpx.fsf@mouse.gnus.org> (message from Lars Ingebrigtsen on Fri, 02 Aug 2019 20:03:54 +0200) Subject: Re: bug#20164: 25.0.50; Do not tell users that `x-show-tip' is internal References: <7d0f8249-d653-40f9-8534-9ffe29d689a2@default> <87ftmjrbsy.fsf@mouse.gnus.org> <83imrffy2i.fsf@gnu.org> <87imrfphpx.fsf@mouse.gnus.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 20164 Cc: 20164@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Lars Ingebrigtsen > Cc: drew.adams@oracle.com, 20164@debbugs.gnu.org > Date: Fri, 02 Aug 2019 20:03:54 +0200 > > Eli Zaretskii writes: > > >> I agree that the calling conventions for `x-show-tip' seems to be much > >> nicer than `tooltip-show'. > > > > If you do, please explain it to me, because the above arguments don't > > convince me, certainly not that x-show-tip's API is "nicer". Maybe > > I'm missing something. > > I think explicit parameters to a function is almost always to be > preferred to binding variables and then calling a function that takes no > parameters. In this case, you're supposed bind `tooltip-{x,y}-offset' > according to the doc string. Only if you for some reason don't like the defaults. Which should happen rarely, if ever. > > https://lists.gnu.org/archive/html/emacs-pretest-bug/2007-03/msg00261.html > > > > The conclusion to take out of that discussion is that whoever uses > > x-show-tip should know very well what they are doing, which is another > > way of saying "kids, don't try that at home", a.k.a. "an internal > > function". > > Makes sense to me, and I'm closing this bug report. Thanks. From unknown Tue Jun 17 23:30:16 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 31 Aug 2019 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator