Subject: Info (point-entered, point-left): Doc incomplete, hence incorrect
From: Jambunathan K <[email-masked]>
To: [email-masked]
Date: Mon, 09 Sep 2013 19:04:59 +0530
List-Id: <debbugs-submit.debbugs.gnu.org>

The info doc (see below) makes no mention of intervals/text properties.
It should mention what intervals.c actually does.

,---- From intervals.c
|   /* We run point-left and point-entered hooks here, if the
|      two intervals are not equivalent.  These hooks take
|      (old_point, new_point) as arguments.  */
`----

,---- (info "(elisp) Special Properties")
| `point-entered'
| `point-left'
|      The special properties `point-entered' and `point-left' record
|      hook functions that report motion of point.  Each time point
|      moves, Emacs compares these two property values:
| 
|         * the `point-left' property of the character after the old
|           location, and
| 
|         * the `point-entered' property of the character after the new
|           location.
| 
|      If these two values differ, each of them is called (if not `nil')
|      with two arguments: the old value of point, and the new one.
`----