summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorvincentdarley <vincentdarley>2005-11-16 09:48:42 (GMT)
committervincentdarley <vincentdarley>2005-11-16 09:48:42 (GMT)
commit3857560b944b318c14b18b5105c6e25d169bb9a6 (patch)
tree16a725f2f99310225104d8662f6437108218a5e6
parentaeb57ff7bb8d60eb73d3eecba5254033782780bf (diff)
downloadtk-3857560b944b318c14b18b5105c6e25d169bb9a6.zip
tk-3857560b944b318c14b18b5105c6e25d169bb9a6.tar.gz
tk-3857560b944b318c14b18b5105c6e25d169bb9a6.tar.bz2
clarify text index documentation
-rw-r--r--ChangeLog6
-rw-r--r--doc/text.n8
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