[Emacs-diffs] emacs/doc/lispref text.texi

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    09/11/28 10:45:47

Modified files:
        doc/lispref    : text.texi 

Log message:
        (Special Properties): More accurate description of what the `cursor'
        property does.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/text.texi?cvsroot=emacs&r1=1.18&r2=1.19

Patches:
Index: text.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/text.texi,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -b -r1.18 -r1.19
--- text.texi   6 Oct 2009 18:31:49 -0000       1.18
+++ text.texi   28 Nov 2009 10:45:46 -0000      1.19
@@ -3166,13 +3166,20 @@
 @item cursor
 @kindex cursor @r{(text property)}
 Normally, the cursor is displayed at the end of any overlay and text
-property strings present at the current window position.  You can
+property strings present at the current buffer position.  You can
 place the cursor on any desired character of these strings by giving
-that character a address@hidden @code{cursor} text property.  If the
-value of the @code{cursor} property is an integer number, it specifies
-the number of buffer's character positions associated with the overlay
-or text property string; this helps Emacs display the cursor correctly
-when point moves across these character positions.
+that character a address@hidden @code{cursor} text property.  In
+addition, if the value of the @code{cursor} property of an overlay
+string is an integer number, it specifies the number of buffer's
+character positions associated with the overlay string; this way,
+Emacs will display the cursor on the character with that property
+regardless of whether the current buffer position is actually covered
+by the overlay.  Specifically, if the value of the @code{cursor}
+property of a character is the number @var{n}, the cursor will be
+displayed on this character for any buffer position in the range
address@hidden@address@hidden@var{n}]}, where @var{ovpos} is the
+starting buffer position covered by the overlay (@pxref{Managing
+Overlays}).
 
 @item pointer
 @kindex pointer @r{(text property)}