From edaf4f8b1a844fa4e953e693b8d60c4be89647ca Mon Sep 17 00:00:00 2001 From: vincentdarley Date: Wed, 16 Nov 2005 09:51:18 +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 c6e7f15..a550c50 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-06 Pat Thoyts * 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. -- cgit v0.12