clarify text index documentation

1 files changed, 6 insertions, 2 deletions

diff --git a/doc/text.n b/doc/text.n
index dd6b5b3..eaa7a21 100644
--- a/doc/text.n
+++ b/doc/text.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: text.n,v 1.39 2005/10/10 10:36:34 vincentdarley Exp $
+'\" RCS: @(#) $Id: text.n,v 1.40 2005/11/16 09:48:44 vincentdarley Exp $
 '\" 
 .so man.macros
 .TH text n 8.5 Tk "Tk Built-In Commands"
@@ -413,7 +413,11 @@ If more than one modifier is present then they are applied in
 left-to-right order.  For example, the index ``\fBend \- 1 chars\fR''
 refers to the next-to-last character in the text and
 ``\fBinsert wordstart \- 1 c\fR'' refers to the character just before
-the first one in the word containing the insertion cursor.
+the first one in the word containing the insertion cursor.  Modifiers
+are applied one by one in this left to right order, and after each step
+the resulting index is constrained to be a valid index in the text 
+widget.  So, for example, the index ''\fB1.0 -1c +1c\fR'' refers to the 
+index ''\fB2.0\fR''.
 .PP
 Where modifiers result in index changes by display lines, display chars
 or display indices, and the \fIbase\fP refers to an index inside an