From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#36232: 26.2; (elisp) `Click Events': OBJECT "string-type text property" etc. Date: Sat, 15 Jun 2019 14:21:50 -0700 (PDT) Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="77806"; mail-complaints-to="usenet@blaine.gmane.org" To: 36232@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 15 23:23:16 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hcG8m-000K2Q-8B for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Jun 2019 23:23:12 +0200 Original-Received: from localhost ([::1]:36624 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hcG8k-0007RD-Rb for geb-bug-gnu-emacs@m.gmane.org; Sat, 15 Jun 2019 17:23:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47476) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hcG8e-0007Qv-J4 for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:23:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hcG8d-0002n7-DP for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:23:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53970) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hcG8c-0002mQ-Qn for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:23:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hcG8c-0007FP-Kp for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:23: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, 15 Jun 2019 21:23:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 36232 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.156063372427725 (code B ref -1); Sat, 15 Jun 2019 21:23:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 15 Jun 2019 21:22:04 +0000 Original-Received: from localhost ([127.0.0.1]:39281 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hcG7f-0007D7-Sk for submit@debbugs.gnu.org; Sat, 15 Jun 2019 17:22:04 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:46888) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hcG7e-0007Cp-89 for submit@debbugs.gnu.org; Sat, 15 Jun 2019 17:22:02 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47293) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hcG7d-0007Na-08 for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:22:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hcG7b-0001Op-R3 for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:22:00 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:39072) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hcG7b-0001MQ-H9 for bug-gnu-emacs@gnu.org; Sat, 15 Jun 2019 17:21:59 -0400 Original-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 x5FLJuwK124537 for ; Sat, 15 Jun 2019 21:21:54 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=3Bi5HX/+H6Inpg2EESHgc3B9y3RctnCwkob6OivpqsQ=; b=RjSfp6ddmrvm3xkpHPEv3/W384enu8tuCZfWtJ+khn6uzy5PCLR+8BXGardwr8SrF8DL MfxMWf2eywOnyo+tHG9Me6dqZPM7C+FV/60Z6aq9dPArOSbBSleA3DGgdMGeM5tWDfeW d1kGs11F+U5E1gUBEqfLAr6JLUT5Z+uaufaPF/eSLxVyKscIj53OCsJLtcQ3U3LYKi4s /KU0lCqpKq0SuJ/ipbHjUaky+4sKe/XpjNXrJm9ezfQ7MSTfFqtbQIz6ThiUwwUd5EWh ZbIaFp/7R8fDZ95CuoZqt8oK5z5E4hb/m2OnaPlOtA+xnZYB/pScvDo+x3aoPR18KYRg yA== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2130.oracle.com with ESMTP id 2t4r3t9ksg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 15 Jun 2019 21:21:54 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5FLKJT7150332 for ; Sat, 15 Jun 2019 21:21:53 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3020.oracle.com with ESMTP id 2t4rg26y9p-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 15 Jun 2019 21:21:53 +0000 Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x5FLLpDL021592 for ; Sat, 15 Jun 2019 21:21:52 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4861.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9289 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 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-1810050000 definitions=main-1906150201 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9289 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1906150201 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:160630 Archived-At: No clue what is meant by "string-type text property". Which text properties are string-type text properties? OBJECT is apparently either nil or (STRING . STRING-POS), where STRING is the string clicked on and STRING-POS is the position in the string where clicked. But: 1. Why call that OBJECT instead of, say, STRING-INFO? What kind of object is it? If the value is nil doesn't it just mean that a string was not clicked on? 2. What text properties are string-type properties? This doc would likely be clearer if something were said about what kind of "objects" it tries to talk about, in general (assuming that all of the occurrences of "object" mean the same kind of thing). That's just a guess, as I have no good idea what it is trying to say. This apparently affects also `posn-object' (e.g. in (elisp `Accessing Mouse'). There it talks about a string or an image in a POSITION. Does "object" just mean string or image? How can a string be in a position? And the doc string of `posn-object' talks about "the object of POSITION." Again, unclear what that object is. `posn-object-x-y' is described as coordinates relative to a corner of "the object in POSITION" - what kind of cornered object is this, and what/where are its "corners"? And "if the POSITION is on buffer text" (huh? a position on text?) then it returns "the relative position of the ... character closest to that position." Unintelligible to me. There must be a clear way of saying what this is trying to say, whatever that is. Also there, `posnp' says that its arg (OBJECT) is a position list "in either of the formats documented in Click Events..." What are those two formats? I don't see two position-list formats identified as such in that node. Unclear, to me. Ostensibly it's about the POSITION (a list) you get from clicking either an image or some buffer text (but string? what string?). Why, and what, objects are introduced to describe the list is unclear to me. Going to the parent node, `Input Events', OBJECT is an input event or event type. Is that the same kind of object the other nodes are talking about? How so? Trying to plug in "input event or event type" to the various occurrences of "object" doesn't seem to make sense in most cases. If this all makes perfect sense to its author, fine. Consider it the feedback of this user that the description is not understandable - hope the feedback helps somehow. In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32) of 2019-04-13 Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749 Windowing system distributor `Microsoft Corp.', version 10.0.17134 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''