From: Chong Yidong <cyd@stupidchicken.com>
Date: Sun, 20 Apr 2008 13:38:00 +0000 (+0000)
Subject: (Overlay Properties): Clarify role of underlying textprop and overlay
X-Git-Tag: emacs-pretest-23.0.90~6174
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=32c9459805678310176a9dc2f539ee072e593b07;p=emacs.git

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

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index c8118deb14e..1f9cfdbd72a 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1512,6 +1512,14 @@ buffer's local map (and the map specified by the @code{local-map}
 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