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

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

bug#18211: 24.4.50; doc string of `posnp'


From: Lars Ingebrigtsen
Subject: bug#18211: 24.4.50; doc string of `posnp'
Date: Sat, 30 Apr 2016 02:41:23 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux)

Drew Adams <address@hidden> writes:

> Doc string:
>
>  Return non-nil if OBJ appears to be a valid `posn' object.
>
> What is a `posn' object?  What is a valid one?
>
> (elisp) `Accessing Mouse' gives an understandable description.  If it is
> correct then use something similar for the doc string:
>
>      returns non-`nil' if OBJECT is a mouse position list,
>                                     ^^^^^^^^^^^^^^^^^^^^^
>      in either of the formats documented in *note Click
>      Events::); and `nil' otherwise.
>
> (FWIW, that manual text should not say "either", since there are more
> than two such formats.  It should say "one".)

It currently says:

posnp is a compiled Lisp function in ‘subr.el’.

(posnp OBJ)

Return non-nil if OBJ appears to be a valid ‘posn’ object specifying a window.
If OBJ is a valid ‘posn’ object, but specifies a frame rather
than a window, return nil.

-----

I still don't know what it is, though.  :-)

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





reply via email to

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