diff options
Diffstat (limited to 'tk/doc/selection.n')
| -rw-r--r-- | tk/doc/selection.n | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/tk/doc/selection.n b/tk/doc/selection.n index e25af000fac..72feff07328 100644 --- 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 + |