Mercurial > emacs
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 |