If the value of the `help-echo' property is a function, that function
is called with three arguments WINDOW, OBJECT and POSITION. WINDOW is
-the window in which the help was found, OBJECT is the buffer or string
-which had the `help-echo' property. POSITION is the position within
-OBJECT under the mouse pointer. The function should return a help
-string or nil for none.
+the window in which the help was found.
+
+If OBJECT is a buffer, POS is the position in the buffer where the
+`help-echo' text property was found.
+
+If OBJECT is an overlay, that overlay has a `help-echo' property, and
+POS is the position in the overlay's buffer under the mouse.
+
+If OBJECT is a string (an overlay string or a string displayed with
+the `display' property). POS is the position in that string under the
+mouse.
If the value of the `help-echo' property is neither a function nor a
string, it is evaluated to obtain a help string.
2000-07-21 Gerd Moellmann <gerd@gnu.org>
+ * xterm.c (note_mouse_highlight): Process overlays in the right
+ order of priority.
+
* keyboard.c (show_help_echo, gen_help_event): Extend comments.
* xterm.c (note_mouse_highlight): If help-echo was found in an