bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#20169: 25.0.50; doc of `posn-actual-col-row'


From: Eli Zaretskii
Subject: bug#20169: 25.0.50; doc of `posn-actual-col-row'
Date: Mon, 23 Mar 2015 18:36:45 +0200

> Date: Sun, 22 Mar 2015 12:51:17 -0700 (PDT)
> From: Drew Adams <address@hidden>
> Cc: address@hidden
> 
> > > 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.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]