clarify text index documentation

2 files changed, 12 insertions, 2 deletions

diff --git a/ChangeLog b/ChangeLog
index 6c06024..657b485 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2005-11-16  Vince Darley <vincentdarley@users.sourceforge.net>
+
+	* doc/text.n: clarify left to right interpretation of index
+	modifiers, including the fact that validation occurs after
+	each step [Bug 1357575]
+
 2005-11-15  Joe English  <jenglish@users.sourceforge.net>
 	* unix/tkUnixWm.c, tests/unixWm.test, doc/wm.n:
 	Support for [wm attributes] on X11 [TIP#231, patch#1062022].
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