unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#20169: 25.0.50; doc of `posn-actual-col-row'
@ 2015-03-22 18:38 Drew Adams
  2015-03-22 18:49 ` Eli Zaretskii
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2015-03-22 18:38 UTC (permalink / raw)
  To: 20169

Please add the information that is in the doc string to (elisp)
`Accessing Mouse'.  This means both the reference information about what
happens if POSITION does not contain the actual position and the guide
information about using `posn-col-row' in that case.

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=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#20169: 25.0.50; doc of `posn-actual-col-row'
  2015-03-22 18:38 Drew Adams
@ 2015-03-22 18:49 ` Eli Zaretskii
  0 siblings, 0 replies; 4+ messages in thread
From: Eli Zaretskii @ 2015-03-22 18:49 UTC (permalink / raw)
  To: Drew Adams; +Cc: 20169

> Date: Sun, 22 Mar 2015 11:38:19 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> 
> Please add the information that is in the doc string to (elisp)
> `Accessing Mouse'.  This means both the reference information about what
> happens if POSITION does not contain the actual position and the guide
> information about using `posn-col-row' in that case.

The first part is already there, isn't it?





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#20169: 25.0.50; doc of `posn-actual-col-row'
       [not found] ` <<83a8z4sw89.fsf@gnu.org>
@ 2015-03-22 19:51   ` Drew Adams
  2015-03-23 16:36     ` Eli Zaretskii
  0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2015-03-22 19:51 UTC (permalink / raw)
  To: Eli Zaretskii, Drew Adams; +Cc: 20169

> > Please add the information that is in the doc string to (elisp)
> > `Accessing Mouse'.  This means both the reference information about what
> > happens if POSITION does not contain the actual position and the guide
> > information about using `posn-col-row' in that case.
> 
> The first part is already there, isn't it?

Do you mean this?

  The function returns `nil' if POSITION does not include actual
  position values.

I meant that the manual should include the information that is in
the last two paragraphs of the doc string:

  Return nil if POSITION does not contain the actual position;
  in that case `posn-col-row' can be used to get approximate values.
  POSITION should be a list of the form returned by the `event-start'
  and `event-end' functions.

  This function does not account for the width on display, like the
  number of visual columns taken by a TAB or image.  If you need
  the coordinates of POSITION in character units, you should use
  `posn-col-row', not this function.

This is a lot more (and more useful) information than just what
is in its first line:

  Return nil if POSITION does not contain the actual position;





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#20169: 25.0.50; doc of `posn-actual-col-row'
  2015-03-22 19:51   ` bug#20169: 25.0.50; doc of `posn-actual-col-row' Drew Adams
@ 2015-03-23 16:36     ` Eli Zaretskii
  0 siblings, 0 replies; 4+ messages in thread
From: Eli Zaretskii @ 2015-03-23 16:36 UTC (permalink / raw)
  To: Drew Adams; +Cc: 20169-done

> Date: Sun, 22 Mar 2015 12:51:17 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 20169@debbugs.gnu.org
> 
> > > Please add the information that is in the doc string to (elisp)
> > > `Accessing Mouse'.  This means both the reference information about what
> > > happens if POSITION does not contain the actual position and the guide
> > > information about using `posn-col-row' in that case.
> > 
> > The first part is already there, isn't it?
> 
> Do you mean this?
> 
>   The function returns `nil' if POSITION does not include actual
>   position values.
> 
> I meant that the manual should include the information that is in
> the last two paragraphs of the doc string:
> 
>   Return nil if POSITION does not contain the actual position;
>   in that case `posn-col-row' can be used to get approximate values.
>   POSITION should be a list of the form returned by the `event-start'
>   and `event-end' functions.
> 
>   This function does not account for the width on display, like the
>   number of visual columns taken by a TAB or image.  If you need
>   the coordinates of POSITION in character units, you should use
>   `posn-col-row', not this function.
> 
> This is a lot more (and more useful) information than just what
> is in its first line:
> 
>   Return nil if POSITION does not contain the actual position;

Right, fixed.





^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2015-03-23 16:36 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <<33a115b6-7d7f-4a2b-a0a2-7c4de0522f0a@default>
     [not found] ` <<83a8z4sw89.fsf@gnu.org>
2015-03-22 19:51   ` bug#20169: 25.0.50; doc of `posn-actual-col-row' Drew Adams
2015-03-23 16:36     ` Eli Zaretskii
2015-03-22 18:38 Drew Adams
2015-03-22 18:49 ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).