diff doc/lispref/display.texi @ 94197:3ce489895028

(Overlay Properties): Clarify role of underlying textprop and overlay keymaps for display strings.

--- a/doc/lispref/display.texi	Sun Apr 20 13:37:40 2008 +0000
+++ b/doc/lispref/display.texi	Sun Apr 20 13:38:00 2008 +0000
@@ -1512,6 +1512,14 @@
 property) rather than replacing it.
 @end table
 
+The @code{local-map} and @code{keymap} properties do not affect a
+string displayed by the @code{before-string}, @code{after-string}, or
+@code{display} properties.  This is only relevant for mouse clicks and
+other mouse events that fall on the string, since point is never on
+the string.  To bind special mouse events for the string, assign it a
+@code{local-map} or @code{keymap} text property.  @xref{Special
+Properties}.
+
 @node Finding Overlays
 @subsection Searching for Overlays