Subject: Re: bug#15312: Info (point-entered, point-left): Doc incomplete, hence incorrect

From: Jambunathan K <[email-masked]>
Date: Wed, 11 Sep 2013 15:25:56 +0530

>>     (defun --point-entered (&rest args)
>>       (message "entered: %s" args))
>> 
>>     (defun --point-left (&rest args)
>>       (message "left: %s" args))
>> 
>>     (add-text-properties (point-min) (point-max) 
>>                          '(point-left --point-left
>>                                       point-entered --point-entered))
>
> It is not clear to me where did you expect the hooks to be called,
> based on the documentation.  

> Was it for every character? 

Based on documentation.  Yes, for every char.

> only at point-min and point-max? 

No.

> And in any case, why do you assume this is a documentation bug

I am not ASSUMING that it is a doc bug.  It IS a doc bug.  The doc IS
obviously not matching the implementation.

> as opposed to a bug in the implementation?

Well, if you want to promote this report to a bug in implementation, I
have no reservations.  But the onus is in on YOU to argue on what counts
it can be deeemed as a bug in implementation.