master 654ef06: Mention rear-advance in relation to the keymap overlay property

[Lars Ingebrigtsen]

branch: master
commit 654ef0607075467dc3335324b127b5b9f932fa9f
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Mention rear-advance in relation to the keymap overlay property
    
    * doc/lispref/display.texi (Overlay Properties): Mention the
    effect of REAR-ADVANCE (bug#459).
---
 doc/lispref/display.texi | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 3336338..c2ebf81 100644
--- 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)}