Fix [Bug 974421]

2 files changed, 21 insertions, 12 deletions

diff --git a/ChangeLog b/ChangeLog
index 5563dc3..98cff67 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,9 +1,16 @@
+2009-04-03  Donal K. Fellows  <dkf@users.sf.net>
+
+	* doc/TextLayout.3: [Bug 974421]: Clarified description of how result
+	of lookup of a point after end of layout relates to the underlying
+	string's length.
+
 2009-04-02  Pat Thoyts  <patthoyts@users.sourceforge.net>
 
-	* tests/textTag.test: Ensure the pointer begins outside the window
-	for all the tests checking Enter/Leave motion events.
-	* library/demos/pendulum.tcl: use unicode labels
-	* library/demos/knightstour.tcl: use polygon knight on x11.
+	* tests/textTag.test: Ensure the pointer begins outside the window for
+	all the tests checking Enter/Leave motion events.
+
+	* library/demos/pendulum.tcl: Use unicode labels
+	* library/demos/knightstour.tcl: Use polygon knight on x11.
 
 2009-03-31  Donal K. Fellows  <dkf@users.sf.net>
 
@@ -13,15 +20,15 @@
 
 2009-03-25  Jan Nijtmans  <nijtmans@users.sf.net>
 
-	* doc/wish.1            bring doc and demos in line with http://wiki.tcl.tk/812
-	* library/demos/hello
+	* doc/wish.1:		Bring doc and demos in line with
+	* library/demos/hello:	http://wiki.tcl.tk/812
 	* library/demos/rmt
 	* library/demos/square
 	* library/demos/tcolor
 	* library/demos/timer
 	* library/demos/widget
-	* win/tkWinMenu.c       Eliminate a few compiler warnings on mingw
-	* win/ttkWinXPTheme.c   spacing
+	* win/tkWinMenu.c:	Eliminate a few compiler warnings on mingw
+	* win/ttkWinXPTheme.c:	Spacing
 
 2009-03-25  Donal K. Fellows  <dkf@users.sf.net>
 
diff --git a/doc/TextLayout.3 b/doc/TextLayout.3
index 3356737..e8e006d 100644
--- a/doc/TextLayout.3
+++ b/doc/TextLayout.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: TextLayout.3,v 1.11 2008/06/30 22:57:02 dkf Exp $
+'\" RCS: @(#) $Id: TextLayout.3,v 1.12 2009/04/03 09:41:35 dkf Exp $
 '\" 
 .so man.macros
 .TH Tk_ComputeTextLayout 3 8.1 Tk "Tk Library Procedures"
@@ -184,9 +184,11 @@ whose \fIx\fR-value is less than 0 will be considered closest to the first
 character on that line; any point whose \fIx\fR-value is greater than the
 width of the text layout will be considered closest to the last character on
 that line.  The return value is the index of the character that was closest
-to the point.  Given a \fIlayout\fR with no characters, the value 0 will
-always be returned, referring to a hypothetical zero-width placeholder
-character.  
+to the point, or one more than the index of any character (to indicate that
+the point was after the end of the string and that the corresponding caret
+would be at the end of the string).  Given a \fIlayout\fR with no characters,
+the value 0 will always be returned, referring to a hypothetical zero-width
+placeholder character.
 .PP
 \fBTk_CharBbox\fR uses the information in \fIlayout\fR to return the
 bounding box for the character specified by \fIindex\fR.  The width of the