GNU bug report logs - #15312
Info (point-entered, point-left): Doc incomplete, hence incorrect

Previous Next

Full log

View this message in rfc822 format

From: Jambunathan K <kjambunathan <at> gmail.com>
To: 15312 <at> debbugs.gnu.org
Subject: bug#15312: Info (point-entered, point-left): Doc incomplete, hence incorrect
Date: Mon, 09 Sep 2013 19:04:59 +0530

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.
`----

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.