clarify text index documentation

2 files changed, 12 insertions, 2 deletions

diff --git a/ChangeLog b/ChangeLog
index c6e7f15..a550c50 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-06  Pat Thoyts  <patthoyts@users.sourceforge.net>
 
 	* unix/tcl.m4: Add missing LIBS for OpenBSD shared libary
diff --git a/doc/text.n b/doc/text.n
index a79b129..dcc1e47 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.15.2.3 2005/05/12 22:50:59 dgp Exp $
+'\" RCS: @(#) $Id: text.n,v 1.15.2.4 2005/11/16 09:51:18 vincentdarley Exp $
 '\" 
 .so man.macros
 .TH text n 8.4 Tk "Tk Built-In Commands"
@@ -291,7 +291,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''.
 .SH TAGS
 .PP
 The first form of annotation in text widgets is a tag.