the extent. This takes precedence over the @code{text-pointer-glyph}
and @code{nontext-pointer-glyph} variables. If for any reason this
glyph is an invalid pointer, the standard glyphs will be used as
-fallbacks. @xref{Mouse Pointer}.
+fallbacks. @xref{External Glyphs}.
@item detachable
(Boolean) Whether this extent becomes detached when all of the text it
@item invisible
(Boolean) If @code{t}, text under this extent will not be displayed --
-it will look as if the text is not there at all.
+it will look as if the text and the begin-glyph is not there at all.
+The end-glyph will still be displayed.
@item keymap
(keymap or @code{nil}) This keymap is consulted for mouse clicks on this
When a string is created using @code{buffer-substring} or
@code{buffer-string}, any duplicable extents in the region corresponding
to the string will be copied into the string (@pxref{Buffer
-Contents}). When the string in inserted into a buffer using
+Contents}). When the string is inserted into a buffer using
@code{insert}, @code{insert-before-markers}, @code{insert-buffer} or
@code{insert-buffer-substring}, the extents in the string will be copied
back into the buffer (@pxref{Insertion}). The extents in a string can,
@section Interaction of Extents with Keyboard and Mouse Events
If an extent has the @code{mouse-face} property set, it will be
-highlighted when the mouse passes over it. Highlighting is accomplished
-by merging the extent's face with the face or faces specified by the
+highlighted when the mouse passes over it. This includes the
+begin-glyph, but not the end-glyph. Highlighting is accomplished by
+merging the extent's face with the face or faces specified by the
@code{mouse-face} property. The effect is as if a pseudo-extent with
the @code{mouse-face} face were inserted after the extent in the display
order (@pxref{Extent Endpoints}, display order).