GNU bug report logs -
#36232
26.2; (elisp) `Click Events': OBJECT "string-type text property" etc.
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Sat, 15 Jun 2019 21:23:02 UTC
Severity: minor
Found in version 26.2
Done: Eli Zaretskii <eliz <at> gnu.org>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your bug report
#36232: 26.2; (elisp) `Click Events': OBJECT "string-type text property" etc.
which was filed against the emacs package, has been closed.
The explanation is attached below, along with your original report.
If you require more details, please reply to 36232 <at> debbugs.gnu.org.
--
36232: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=36232
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
> Date: Sat, 15 Jun 2019 14:21:50 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
>
> No clue what is meant by "string-type text property".
>
> Which text properties are string-type text properties?
It's a string that comes from a text property or from an overlay.
> 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?
Because nil stands for a buffer, not just for the lack of a string.
> 2. What text properties are string-type properties?
Asked and answered.
> 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.
It can talk about any Lisp object, or I don't understand the question.
> 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?
See above.
> And the doc string of `posn-object' talks about "the object of
> POSITION." Again, unclear what that object is.
See above. "OBJECT in POSITION" refers to the object recorded in (or
described by) POSITION.
> `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"?
Every object on display, be it a character glyph, a display string, an
image, or anything else, has 2 dimensions, which means it has 4
corners.
> And "if the POSITION is on buffer text" (huh? a position on text?)
POSITION describes a click, remember?
> 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.
I hope the modified text is more clear.
> 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?
"In the format". ("Either of the formats" doesn't necessarily mean
there are two of them.)
> 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?
No.
> 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.
I improved the wording (in the emacs-26 branch), you are invited to
take a look.
[Message part 3 (message/rfc822, inline)]
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=x86_64-w64-mingw32
--without-compress-install 'CFLAGS=-O2 -static -g3''
This bug report was last modified 5 years and 335 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.