comparison doc/lispref/text.texi @ 106295:689189807867

(Special Properties): More accurate description of what the `cursor' property does.
author Eli Zaretskii <eliz@gnu.org>
date Sat, 28 Nov 2009 10:45:46 +0000
parents cb0d4db13985
children 79fa2d910b72
comparison
equal deleted inserted replaced
106294:215036197352 106295:689189807867
3164 @xref{Fields}. 3164 @xref{Fields}.
3165 3165
3166 @item cursor 3166 @item cursor
3167 @kindex cursor @r{(text property)} 3167 @kindex cursor @r{(text property)}
3168 Normally, the cursor is displayed at the end of any overlay and text 3168 Normally, the cursor is displayed at the end of any overlay and text
3169 property strings present at the current window position. You can 3169 property strings present at the current buffer position. You can
3170 place the cursor on any desired character of these strings by giving 3170 place the cursor on any desired character of these strings by giving
3171 that character a non-@code{nil} @code{cursor} text property. If the 3171 that character a non-@code{nil} @code{cursor} text property. In
3172 value of the @code{cursor} property is an integer number, it specifies 3172 addition, if the value of the @code{cursor} property of an overlay
3173 the number of buffer's character positions associated with the overlay 3173 string is an integer number, it specifies the number of buffer's
3174 or text property string; this helps Emacs display the cursor correctly 3174 character positions associated with the overlay string; this way,
3175 when point moves across these character positions. 3175 Emacs will display the cursor on the character with that property
3176 regardless of whether the current buffer position is actually covered
3177 by the overlay. Specifically, if the value of the @code{cursor}
3178 property of a character is the number @var{n}, the cursor will be
3179 displayed on this character for any buffer position in the range
3180 @code{[@var{ovpos}..@var{ovpos}+@var{n}]}, where @var{ovpos} is the
3181 starting buffer position covered by the overlay (@pxref{Managing
3182 Overlays}).
3176 3183
3177 @item pointer 3184 @item pointer
3178 @kindex pointer @r{(text property)} 3185 @kindex pointer @r{(text property)}
3179 This specifies a specific pointer shape when the mouse pointer is over 3186 This specifies a specific pointer shape when the mouse pointer is over
3180 this text or image. @xref{Pointer Shape}, for possible pointer 3187 this text or image. @xref{Pointer Shape}, for possible pointer