From 3857560b944b318c14b18b5105c6e25d169bb9a6 Mon Sep 17 00:00:00 2001 From: vincentdarley Date: Wed, 16 Nov 2005 09:48:42 +0000 Subject: clarify text index documentation --- ChangeLog | 6 ++++++ doc/text.n | 8 ++++++-- 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 + + * 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 * 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 -- cgit v0.12