Mention rear-advance in relation to the keymap overlay property

* doc/lispref/display.texi (Overlay Properties): Mention the
effect of REAR-ADVANCE (bug#459).

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 3336338087c8434ecc4fe2b643b1e881bc58652b..c2ebf81f6690d11e59f8e82b4f913e3feefe3b98 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1861,9 +1861,12 @@ from the buffer.
 @item keymap
 @cindex keymap of character (and overlays)
 @kindex keymap @r{(overlay property)}
-If this property is non-@code{nil}, it specifies a keymap for a portion of the
-text.  This keymap is used when the character after point is within the
-overlay, and takes precedence over most other keymaps.  @xref{Active Keymaps}.
+If this property is non-@code{nil}, it specifies a keymap for a
+portion of the text.  This keymap takes precedence over most other
+keymaps (@pxref{Active Keymaps}), and it is used when the character
+after point is within the overlay, or would be when taking the front-
+and rear-advance properties into consideration (@pxref{Managing
+Overlays}).
 
 @item local-map
 @kindex local-map @r{(overlay property)}