touched all tk files to ease next import

[pf3gnuchains/pf3gnuchains4x.git] / tk / doc / selection.n

diff --git a/tk/doc/selection.n b/tk/doc/selection.n
index e25af00..72feff0 100644 (file)
--- a/tk/doc/selection.n
+++ b/tk/doc/selection.n
@@ -8,7 +8,7 @@
 '\" RCS: @(#) $Id$
 '\" 
 .so man.macros
-.TH selection n 4.0 Tk "Tk Built-In Commands"
+.TH selection n 8.1 Tk "Tk Built-In Commands"
 .BS
 '\" Note:  do not modify the .SH NAME line immediately below!
 .SH NAME
@@ -70,19 +70,21 @@ and \fItype\fR is the requested type, \fIcommand\fR will be executed
 as a Tcl command with two additional numbers appended to it
 (with space separators).  
 The two additional numbers
-are \fIoffset\fR and \fImaxBytes\fR:  \fIoffset\fR specifies a starting
-character position in the selection and \fImaxBytes\fR gives the maximum
-number of bytes to retrieve.  The command should return a value consisting
-of at most \fImaxBytes\fR of the selection, starting at position
-\fIoffset\fR.  For very large selections (larger than \fImaxBytes\fR)
+.VS
+are \fIoffset\fR and \fImaxChars\fR:  \fIoffset\fR specifies a starting
+character position in the selection and \fImaxChars\fR gives the maximum
+number of characters to retrieve.  The command should return a value consisting
+of at most \fImaxChars\fR of the selection, starting at position
+\fIoffset\fR.  For very large selections (larger than \fImaxChars\fR)
 the selection will be retrieved using several invocations of \fIcommand\fR
 with increasing \fIoffset\fR values.  If \fIcommand\fR returns a string
-whose length is less than \fImaxBytes\fR, the return value is assumed to
+whose length is less than \fImaxChars\fR, the return value is assumed to
 include all of the remainder of the selection;  if the length of
-\fIcommand\fR's result is equal to \fImaxBytes\fR then
+\fIcommand\fR's result is equal to \fImaxChars\fR then
 \fIcommand\fR will be invoked again, until it eventually
-returns a result shorter than \fImaxBytes\fR.  The value of \fImaxBytes\fR
-will always be relatively large (thousands of bytes).
+returns a result shorter than \fImaxChars\fR.  The value of \fImaxChars\fR
+will always be relatively large (thousands of characters).
+.VE
 .PP
 If \fIcommand\fR returns an error then the selection retrieval is rejected
 just as if the selection didn't exist at all.
@@ -126,3 +128,4 @@ some other window claims ownership of the selection away from
 
 .SH KEYWORDS
 clear, format, handler, ICCCM, own, selection, target, type
+