summaryrefslogtreecommitdiffstats
path: root/doc/transchan.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2024-01-21 17:48:32 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2024-01-21 17:48:32 (GMT)
commitc0820abc21f24df06915c420f63efab64af79dac (patch)
tree619dd4a0a33861ce42065d751e86a9ba4dbf929b /doc/transchan.n
parentd8760322be4e1bfb0091bac0a799aef13dc77b87 (diff)
downloadtcl-c0820abc21f24df06915c420f63efab64af79dac.zip
tcl-c0820abc21f24df06915c420f63efab64af79dac.tar.gz
tcl-c0820abc21f24df06915c420f63efab64af79dac.tar.bz2
Clean up of docs
Diffstat (limited to 'doc/transchan.n')
-rw-r--r--doc/transchan.n8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/transchan.n b/doc/transchan.n
index b9a0f21..a424981 100644
--- a/doc/transchan.n
+++ b/doc/transchan.n
@@ -44,6 +44,7 @@ create the transformation.
.SS "GENERIC SUBCOMMANDS"
.PP
The following subcommands are relevant to all types of channel.
+.\" METHOD: clear
.TP
\fIcmdPrefix \fBclear \fIhandle\fR
.
@@ -51,6 +52,7 @@ This optional subcommand is called to signify to the transformation that any
data stored in internal buffers (either incoming or outgoing) must be
cleared. It is called when a \fBchan seek\fR is performed on the channel being
transformed.
+.\" METHOD: finalize
.TP
\fIcmdPrefix \fBfinalize \fIhandle\fR
.
@@ -59,6 +61,7 @@ never again, and it exists to allow for cleaning up any Tcl-level data
structures associated with the transformation. \fIWarning!\fR Any errors
thrown by this subcommand will be ignored. It is not guaranteed to be called
if the interpreter is deleted.
+.\" METHOD: initialize
.TP
\fIcmdPrefix \fBinitialize \fIhandle mode\fR
.
@@ -86,6 +89,7 @@ as error thrown by \fBchan push\fR.
These subcommands are used for handling transformations applied to readable
channels; though strictly \fBread \fRis optional, it must be supported if any
of the others is or the channel will be made non-readable.
+.\" METHOD: drain
.TP
\fIcmdPrefix \fBdrain \fIhandle\fR
.
@@ -100,6 +104,7 @@ In other words, when this method is called the transformation cannot defer the
actual transformation operation anymore and has to transform all data waiting
in its internal read buffers and return the result of that action.
.RE
+.\" METHOD: limit?
.TP
\fIcmdPrefix \fBlimit? \fIhandle\fR
.
@@ -108,6 +113,7 @@ how far ahead it should read. If present, it should return an integer number
greater than zero which indicates how many bytes ahead should be read, or an
integer less than zero to indicate that the I/O engine may read as far ahead
as it likes.
+.\" METHOD: read
.TP
\fIcmdPrefix \fBread \fIhandle buffer\fR
.
@@ -131,6 +137,7 @@ defer the actual transformation until it has more data.
These subcommands are used for handling transformations applied to writable
channels; though strictly \fBwrite\fR is optional, it must be supported if any
of the others is or the channel will be made non-writable.
+.\" METHOD: flush
.TP
\fIcmdPrefix \fBflush \fIhandle\fR
.
@@ -145,6 +152,7 @@ In other words, when this subcommand is called the transformation cannot defer
the actual transformation operation anymore and has to transform all data
waiting in its internal write buffers and return the result of that action.
.RE
+.\" METHOD: write
.TP
\fIcmdPrefix \fBwrite \fIhandle buffer\fR
.