Change "channelId" to "channel" in documentation, error-handling and testcases

28 files changed, 159 insertions, 159 deletions

diff --git a/doc/chan.n b/doc/chan.n
index 8bb564b..7191121 100644
--- a/doc/chan.n
+++ b/doc/chan.n
@@ -23,19 +23,19 @@ the process's standard input, output and error streams respectively).
 abbreviation for \fIoption\fR is acceptable. Valid options are:
 .\" METHOD: blocked
 .TP
-\fBchan blocked \fIchannelId\fR
+\fBchan blocked \fIchannel\fR
 .
 This tests whether the last input operation on the channel called
-\fIchannelId\fR failed because it would have otherwise caused the
+\fIchannel\fR failed because it would have otherwise caused the
 process to block, and returns 1 if that was the case. It returns 0
 otherwise. Note that this only ever returns 1 when the channel has
 been configured to be non-blocking; all Tcl channels have blocking
 turned on by default.
 .\" METHOD: close
 .TP
-\fBchan close \fIchannelId\fR ?\fIdirection\fR?
+\fBchan close \fIchannel\fR ?\fIdirection\fR?
 .
-Close and destroy the channel called \fIchannelId\fR. Note that this
+Close and destroy the channel called \fIchannel\fR. Note that this
 deletes all existing file-events registered on the channel.
 If the \fIdirection\fR argument (which must be \fBread\fR or \fBwrite\fR or
 any unique abbreviation of them) is present, the channel will only be
@@ -51,7 +51,7 @@ write-only channel for reading.
 As part of closing the channel, all buffered output is flushed to the
 channel's output device (only if the channel is ceasing to be writable), any
 buffered input is discarded (only if the channel is ceasing to be readable),
-the underlying operating system resource is closed and \fIchannelId\fR becomes
+the underlying operating system resource is closed and \fIchannel\fR becomes
 unavailable for future use (both only if the channel is being completely
 closed).
 .PP
@@ -61,11 +61,11 @@ non-blocking and there is unflushed output, the channel remains open and the
 command returns immediately; output will be flushed in the background and the
 channel will be closed when all the flushing is complete.
 .PP
-If \fIchannelId\fR is a blocking channel for a command pipeline then
+If \fIchannel\fR is a blocking channel for a command pipeline then
 \fBchan close\fR waits for the child processes to complete.
 .PP
 If the channel is shared between interpreters, then \fBchan close\fR
-makes \fIchannelId\fR unavailable in the invoking interpreter but has
+makes \fIchannel\fR unavailable in the invoking interpreter but has
 no other effect until all of the sharing interpreters have closed the
 channel. When the last interpreter in which the channel is registered
 invokes \fBchan close\fR (or \fBclose\fR), the cleanup actions
@@ -101,10 +101,10 @@ restores the previous behavior.
 .RE
 .\" METHOD: configure
 .TP
-\fBchan configure \fIchannelId\fR ?\fIoptionName\fR? ?\fIvalue\fR? ?\fIoptionName value\fR?...
+\fBchan configure \fIchannel\fR ?\fIoptionName\fR? ?\fIvalue\fR? ?\fIoptionName value\fR?...
 .
 Query or set the configuration options of the channel named
-\fIchannelId\fR.
+\fIchannel\fR.
 .RS
 .PP
 If no \fIoptionName\fR or \fIvalue\fR arguments are supplied, the
@@ -391,18 +391,18 @@ within the safe interpreter.
 .RE
 .\" METHOD: eof
 .TP
-\fBchan eof \fIchannelId\fR
+\fBchan eof \fIchannel\fR
 .
 Test whether the last input operation on the channel called
-\fIchannelId\fR failed because the end of the data stream was reached,
+\fIchannel\fR failed because the end of the data stream was reached,
 returning 1 if end-of-file was reached, and 0 otherwise.
 .\" METHOD: event
 .TP
-\fBchan event \fIchannelId event\fR ?\fIscript\fR?
+\fBchan event \fIchannel event\fR ?\fIscript\fR?
 .
 Arrange for the Tcl script \fIscript\fR to be installed as a \fIfile
 event handler\fR to be called whenever the channel called
-\fIchannelId\fR enters the state described by \fIevent\fR (which must
+\fIchannel\fR enters the state described by \fIevent\fR (which must
 be either \fBreadable\fR or \fBwritable\fR); only one such handler may
 be installed per event per channel at a time.  If \fIscript\fR is the
 empty string, the current handler is deleted (this also happens if the
@@ -468,9 +468,9 @@ loops due to buggy handlers.
 .RE
 .\" METHOD: flush
 .TP
-\fBchan flush \fIchannelId\fR
+\fBchan flush \fIchannel\fR
 .
-Ensures that all pending output for the channel called \fIchannelId\fR
+Ensures that all pending output for the channel called \fIchannel\fR
 is written.
 .RS
 .PP
@@ -483,7 +483,7 @@ it.
 .RE
 .\" METHOD: gets
 .TP
-\fBchan gets \fIchannelId\fR ?\fIvarName\fR?
+\fBchan gets \fIchannel\fR ?\fIvarName\fR?
 .
 Reads a line from the channel consisting of all characters up to the next
 end-of-line sequence or until end of file is seen. The line feed character
@@ -536,12 +536,12 @@ only those channel names that match it (according to the rules of
 \fBstring match\fR) will be returned.
 .\" METHOD: pending
 .TP
-\fBchan pending \fImode channelId\fR
+\fBchan pending \fImode channel\fR
 .
 Depending on whether \fImode\fR is \fBinput\fR or \fBoutput\fR,
 returns the number of
 bytes of input or output (respectively) currently buffered
-internally for \fIchannelId\fR (especially useful in a readable event
+internally for \fIchannel\fR (especially useful in a readable event
 callback to impose application-specific limits on input line lengths to avoid
 a potential denial-of-service attack where a hostile user crafts
 an extremely long line that exceeds the available memory to buffer it).
@@ -572,20 +572,20 @@ allowed for.
 .RE
 .\" METHOD: pop
 .TP
-\fBchan pop \fIchannelId\fR
+\fBchan pop \fIchannel\fR
 .
-Removes the topmost transformation from the channel \fIchannelId\fR, if there
-is any. If there are no transformations added to \fIchannelId\fR, this is
+Removes the topmost transformation from the channel \fIchannel\fR, if there
+is any. If there are no transformations added to \fIchannel\fR, this is
 equivalent to \fBchan close\fR of that channel. The result is normally the
 empty string, but can be an error in some situations (i.e. where the
 underlying system stream is closed and that results in an error).
 .\" METHOD: postevent
 .TP
-\fBchan postevent \fIchannelId eventSpec\fR
+\fBchan postevent \fIchannel eventSpec\fR
 .
 This subcommand is used by command handlers specified with \fBchan
 create\fR. It notifies the channel represented by the handle
-\fIchannelId\fR that the event(s) listed in the \fIeventSpec\fR have
+\fIchannel\fR that the event(s) listed in the \fIeventSpec\fR have
 occurred. The argument has to be a list containing any of the strings
 \fBread\fR and \fBwrite\fR. The list must contain at least one
 element as it does not make sense to invoke the command if there are
@@ -618,9 +618,9 @@ executed in the interpreter that set them up.
 .RE
 .\" METHOD: push
 .TP
-\fBchan push \fIchannelId cmdPrefix\fR
+\fBchan push \fIchannel cmdPrefix\fR
 .
-Adds a new transformation on top of the channel \fIchannelId\fR. The
+Adds a new transformation on top of the channel \fIchannel\fR. The
 \fIcmdPrefix\fR argument describes a list of one or more words which represent
 a handler that will be used to implement the transformation. The command
 prefix must provide the API described in the \fBtranschan\fR manual page.
@@ -630,11 +630,11 @@ channel mode that it is used with or this can make the channel neither
 readable nor writable.
 .\" METHOD: puts
 .TP
-\fBchan puts\fR ?\fB\-nonewline\fR? ?\fIchannelId\fR? \fIstring\fR
+\fBchan puts\fR ?\fB\-nonewline\fR? ?\fIchannel\fR? \fIstring\fR
 .
-Writes \fIstring\fR to the channel named \fIchannelId\fR followed by a
+Writes \fIstring\fR to the channel named \fIchannel\fR followed by a
 newline character. A trailing newline character is written unless the
-optional flag \fB\-nonewline\fR is given. If \fIchannelId\fR is
+optional flag \fB\-nonewline\fR is given. If \fIchannel\fR is
 omitted, the string is written to the standard output channel,
 \fBstdout\fR.
 .RS
@@ -654,7 +654,7 @@ flush\fR command.
 .PP
 When the output buffer fills up, the \fBchan puts\fR command will
 normally block until all the buffered data has been accepted for
-output by the operating system.  If \fIchannelId\fR is in non-blocking
+output by the operating system.  If \fIchannel\fR is in non-blocking
 mode then the \fBchan puts\fR command will not block even if the
 operating system cannot accept the data.  Instead, Tcl continues to
 buffer the data and writes it in the background as fast as the
@@ -675,12 +675,12 @@ may be partially written to the channel in this case.
 .RE
 .\" METHOD: read
 .TP
-\fBchan read \fIchannelId\fR ?\fInumChars\fR?
+\fBchan read \fIchannel\fR ?\fInumChars\fR?
 .TP
-\fBchan read \fR?\fB\-nonewline\fR? \fIchannelId\fR
+\fBchan read \fR?\fB\-nonewline\fR? \fIchannel\fR
 .
 In the first form, the result will be the next \fInumChars\fR
-characters read from the channel named \fIchannelId\fR; if
+characters read from the channel named \fIchannel\fR; if
 \fInumChars\fR is omitted, all characters up to the point when the
 channel would signal a failure (whether an end-of-file, blocked or
 other error condition) are read. In the second form (i.e. when
@@ -689,7 +689,7 @@ given to indicate that any trailing newline in the string that has
 been read should be trimmed.
 .RS
 .PP
-If \fIchannelId\fR is in non-blocking mode, \fBchan read\fR may not
+If \fIchannel\fR is in non-blocking mode, \fBchan read\fR may not
 read as many characters as requested: once all available input has
 been read, the command will return the data that is available rather
 than blocking for more input.  If the channel is configured to use a
@@ -708,7 +708,7 @@ When reading from a serial port, most applications should configure
 the serial port channel to be non-blocking, like this:
 .PP
 .CS
-\fBchan configure \fIchannelId \fB\-blocking \fI0\fR.
+\fBchan configure \fIchannel \fB\-blocking \fI0\fR.
 .CE
 .PP
 Then \fBchan read\fR behaves much like described above.  Note that
@@ -716,12 +716,12 @@ most serial ports are comparatively slow; it is entirely possible to
 get a \fBreadable\fR event for each character read from them. Care
 must be taken when using \fBchan read\fR on blocking serial ports:
 .TP
-\fBchan read \fIchannelId numChars\fR
+\fBchan read \fIchannel numChars\fR
 .
 In this form \fBchan read\fR blocks until \fInumChars\fR have been
 received from the serial port.
 .TP
-\fBchan read \fIchannelId\fR
+\fBchan read \fIchannel\fR
 .
 In this form \fBchan read\fR blocks until the reception of the
 end-of-file character, see \fBchan configure -eofchar\fR. If there no
@@ -745,10 +745,10 @@ changing the encoding in use. See \fBENCODING ERROR EXAMPLES\fR later.
 .RE
 .\" METHOD: seek
 .TP
-\fBchan seek \fIchannelId offset\fR ?\fIorigin\fR?
+\fBchan seek \fIchannel offset\fR ?\fIorigin\fR?
 .
 Sets the current access position within the underlying data stream for
-the channel named \fIchannelId\fR to be \fIoffset\fR bytes relative to
+the channel named \fIchannel\fR to be \fIoffset\fR bytes relative to
 \fIorigin\fR. \fIOffset\fR must be an integer (which may be negative)
 and \fIorigin\fR must be one of the following:
 .RS
@@ -779,20 +779,20 @@ not characters, unlike \fBchan read\fR.
 .RE
 .\" METHOD: tell
 .TP
-\fBchan tell \fIchannelId\fR
+\fBchan tell \fIchannel\fR
 .
 Returns a number giving the current access position within the
-underlying data stream for the channel named \fIchannelId\fR. This
+underlying data stream for the channel named \fIchannel\fR. This
 value returned is a byte offset that can be passed to \fBchan seek\fR
 in order to set the channel to a particular position.  Note that this
 value is in terms of bytes, not characters like \fBchan read\fR.  The
 value returned is -1 for channels that do not support seeking.
 .\" METHOD: truncate
 .TP
-\fBchan truncate \fIchannelId\fR ?\fIlength\fR?
+\fBchan truncate \fIchannel\fR ?\fIlength\fR?
 .
 Sets the byte length of the underlying data stream for the channel
-named \fIchannelId\fR to be \fIlength\fR (or to the current byte
+named \fIchannel\fR to be \fIlength\fR (or to the current byte
 offset within the underlying data stream if \fIlength\fR is
 omitted). The channel is flushed before truncation.
 .
diff --git a/doc/close.n b/doc/close.n
index f3a61be..eecc48f 100644
--- a/doc/close.n
+++ b/doc/close.n
@@ -12,7 +12,7 @@
 .SH NAME
 close \- Close an open channel
 .SH SYNOPSIS
-\fBclose \fIchannelId\fR ?\fBr\fR(\fBead\fR)|\fBw\fR(\fBrite\fR)?
+\fBclose \fIchannel\fR ?\fBr\fR(\fBead\fR)|\fBw\fR(\fBrite\fR)?
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/eof.n b/doc/eof.n
index 7eea515..36f4920 100644
--- a/doc/eof.n
+++ b/doc/eof.n
@@ -12,7 +12,7 @@
 .SH NAME
 eof \- Check for end of file condition on channel
 .SH SYNOPSIS
-\fBeof \fIchannelId\fR
+\fBeof \fIchannel\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/fblocked.n b/doc/fblocked.n
index 239c465..00fe7a7 100644
--- a/doc/fblocked.n
+++ b/doc/fblocked.n
@@ -10,7 +10,7 @@
 .SH NAME
 fblocked \- Test whether the last input operation exhausted all available input
 .SH SYNOPSIS
-\fBfblocked \fIchannelId\fR
+\fBfblocked \fIchannel\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/fconfigure.n b/doc/fconfigure.n
index 2870d54..e185122 100644
--- a/doc/fconfigure.n
+++ b/doc/fconfigure.n
@@ -12,9 +12,9 @@
 fconfigure \- Set and get options on a channel
 .SH SYNOPSIS
 .nf
-\fBfconfigure \fIchannelId\fR
-\fBfconfigure \fIchannelId name\fR
-\fBfconfigure \fIchannelId name value \fR?\fIname value ...\fR?
+\fBfconfigure \fIchannel\fR
+\fBfconfigure \fIchannel name\fR
+\fBfconfigure \fIchannel name value \fR?\fIname value ...\fR?
 .fi
 .BE
 .SH DESCRIPTION
diff --git a/doc/fileevent.n b/doc/fileevent.n
index 4ba534a..d90e376 100644
--- a/doc/fileevent.n
+++ b/doc/fileevent.n
@@ -13,9 +13,9 @@
 .SH NAME
 fileevent \- Execute a script when a channel becomes readable or writable
 .SH SYNOPSIS
-\fBfileevent \fIchannelId \fBreadable \fR?\fIscript\fR?
+\fBfileevent \fIchannel \fBreadable \fR?\fIscript\fR?
 .sp
-\fBfileevent \fIchannelId \fBwritable \fR?\fIscript\fR?
+\fBfileevent \fIchannel \fBwritable \fR?\fIscript\fR?
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/flush.n b/doc/flush.n
index 259f4cb..956750e 100644
--- a/doc/flush.n
+++ b/doc/flush.n
@@ -12,7 +12,7 @@
 .SH NAME
 flush \- Flush buffered output for a channel
 .SH SYNOPSIS
-\fBflush \fIchannelId\fR
+\fBflush \fIchannel\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/gets.n b/doc/gets.n
index 8ee0db1..59951e3 100644
--- a/doc/gets.n
+++ b/doc/gets.n
@@ -12,7 +12,7 @@
 .SH NAME
 gets \- Read a line from a channel
 .SH SYNOPSIS
-\fBgets \fIchannelId\fR ?\fIvarName\fR?
+\fBgets \fIchannel\fR ?\fIvarName\fR?
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/interp.n b/doc/interp.n
index 2c08533..74745be 100644
--- a/doc/interp.n
+++ b/doc/interp.n
@@ -392,9 +392,9 @@ the maximum size of the C stack.
 .RE
 .\" METHOD: share
 .TP
-\fBinterp share\fI srcPath channelId destPath\fR
+\fBinterp share\fI srcPath channel destPath\fR
 .
-Causes the IO channel identified by \fIchannelId\fR to become shared
+Causes the IO channel identified by \fIchannel\fR to become shared
 between the interpreter identified by \fIsrcPath\fR and the interpreter
 identified by \fIdestPath\fR. Both interpreters have the same permissions
 on the IO channel.
@@ -415,9 +415,9 @@ invoking interpreter or one of its descendants then an error is generated.
 The target command does not have to be defined at the time of this invocation.
 .\" METHOD: transfer
 .TP
-\fBinterp transfer\fI srcPath channelId destPath\fR
+\fBinterp transfer\fI srcPath channel destPath\fR
 .
-Causes the IO channel identified by \fIchannelId\fR to become available in
+Causes the IO channel identified by \fIchannel\fR to become available in
 the interpreter identified by \fIdestPath\fR and unavailable in the
 interpreter identified by \fIsrcPath\fR.
 .SH "CHILD COMMAND"
diff --git a/doc/puts.n b/doc/puts.n
index e818273..100bec8 100644
--- a/doc/puts.n
+++ b/doc/puts.n
@@ -12,7 +12,7 @@
 .SH NAME
 puts \- Write to a channel
 .SH SYNOPSIS
-\fBputs \fR?\fB\-nonewline\fR? ?\fIchannelId\fR? \fIstring\fR
+\fBputs \fR?\fB\-nonewline\fR? ?\fIchannel\fR? \fIstring\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/read.n b/doc/read.n
index d298138..8ba482e 100644
--- a/doc/read.n
+++ b/doc/read.n
@@ -12,9 +12,9 @@
 .SH NAME
 read \- Read from a channel
 .SH SYNOPSIS
-\fBread \fR?\fB\-nonewline\fR? \fIchannelId\fR
+\fBread \fR?\fB\-nonewline\fR? \fIchannel\fR
 .sp
-\fBread \fIchannelId numChars\fR
+\fBread \fIchannel numChars\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/refchan.n b/doc/refchan.n
index b997ddb..4f78a7b 100644
--- a/doc/refchan.n
+++ b/doc/refchan.n
@@ -14,16 +14,16 @@ refchan \- command handler API of reflected channels
 .nf
 \fBchan create \fImode cmdPrefix\fR
 
-\fIcmdPrefix \fBblocking\fI channelId mode\fR
-\fIcmdPrefix \fBcget\fI channelId option\fR
-\fIcmdPrefix \fBcgetall\fI channelId\fR
-\fIcmdPrefix \fBconfigure\fI channelId option value\fR
-\fIcmdPrefix \fBfinalize\fI channelId\fR
-\fIcmdPrefix \fBinitialize\fI channelId mode\fR
-\fIcmdPrefix \fBread\fI channelId count\fR
-\fIcmdPrefix \fBseek\fI channelId offset base\fR
-\fIcmdPrefix \fBwatch\fI channelId eventspec\fR
-\fIcmdPrefix \fBwrite\fI channelId data\fR
+\fIcmdPrefix \fBblocking\fI channel mode\fR
+\fIcmdPrefix \fBcget\fI channel option\fR
+\fIcmdPrefix \fBcgetall\fI channel\fR
+\fIcmdPrefix \fBconfigure\fI channel option value\fR
+\fIcmdPrefix \fBfinalize\fI channel\fR
+\fIcmdPrefix \fBinitialize\fI channel mode\fR
+\fIcmdPrefix \fBread\fI channel count\fR
+\fIcmdPrefix \fBseek\fI channel offset base\fR
+\fIcmdPrefix \fBwatch\fI channel eventspec\fR
+\fIcmdPrefix \fBwrite\fI channel data\fR
 .fi
 .BE
 .SH DESCRIPTION
@@ -44,10 +44,10 @@ other subcommands is optional.
 .SS "MANDATORY SUBCOMMANDS"
 .\" METHOD: initialize
 .TP
-\fIcmdPrefix \fBinitialize \fIchannelId mode\fR
+\fIcmdPrefix \fBinitialize \fIchannel mode\fR
 .
 An invocation of this subcommand will be the first call the
-\fIcmdPrefix\fR will receive for the specified new \fIchannelId\fR. It
+\fIcmdPrefix\fR will receive for the specified new \fIchannel\fR. It
 is the responsibility of this subcommand to set up any internal data
 structures required to keep track of the channel and its state.
 .RS
@@ -75,13 +75,13 @@ supported by the \fIcmdPrefix\fR.
 .RE
 .\" METHOD: finalize
 .TP
-\fIcmdPrefix \fBfinalize \fIchannelId\fR
+\fIcmdPrefix \fBfinalize \fIchannel\fR
 .
 An invocation of this subcommand will be the last call the
-\fIcmdPrefix\fR will receive for the specified \fIchannelId\fR. It will
+\fIcmdPrefix\fR will receive for the specified \fIchannel\fR. It will
 be generated just before the destruction of the data structures of the
 channel held by the Tcl core. The command handler \fImust not\fR
-access the \fIchannelId\fR anymore in no way. Upon this subcommand being
+access the \fIchannel\fR anymore in no way. Upon this subcommand being
 called, any internal resources allocated to this channel must be
 cleaned up.
 .RS
@@ -98,10 +98,10 @@ aborted during \fBinitialize\fR (See above).
 .RE
 .\" METHOD: watch
 .TP
-\fIcmdPrefix \fBwatch \fIchannelId eventspec\fR
+\fIcmdPrefix \fBwatch \fIchannel eventspec\fR
 .
 This subcommand notifies the \fIcmdPrefix\fR that the specified
-\fIchannelId\fR is interested in the events listed in the
+\fIchannel\fR is interested in the events listed in the
 \fIeventspec\fR. This argument is a list containing any of \fBread\fR
 and \fBwrite\fR. The list may be empty, which signals that the
 channel does not wish to be notified of any events. In that situation,
@@ -119,10 +119,10 @@ event which was not listed in the last call to \fBwatch\fR will cause
 .SS "OPTIONAL SUBCOMMANDS"
 .\" METHOD: read
 .TP
-\fIcmdPrefix \fBread \fIchannelId count\fR
+\fIcmdPrefix \fBread \fIchannel count\fR
 .
 This \fIoptional\fR subcommand is called when the user requests data from the
-channel \fIchannelId\fR. \fIcount\fR specifies how many \fIbytes\fR have been
+channel \fIchannel\fR. \fIcount\fR specifies how many \fIbytes\fR have been
 requested. If the subcommand is not supported then it is not possible to read
 from the channel handled by the command.
 .RS
@@ -176,10 +176,10 @@ etc.) is treated as and converted to an error.
 .RE
 .\" METHOD: write
 .TP
-\fIcmdPrefix \fBwrite \fIchannelId data\fR
+\fIcmdPrefix \fBwrite \fIchannel data\fR
 .
 This \fIoptional\fR subcommand is called when the user writes data to
-the channel \fIchannelId\fR. The \fIdata\fR argument contains \fIbytes\fR, not
+the channel \fIchannel\fR. The \fIdata\fR argument contains \fIbytes\fR, not
 characters. Any type of transformation (EOL, encoding) configured for
 the channel has already been applied at this point. If this subcommand
 is not supported then it is not possible to write to the channel
@@ -234,11 +234,11 @@ as and converted to an error.
 .RE
 .\" METHOD: seek
 .TP
-\fIcmdPrefix \fBseek \fIchannelId offset base\fR
+\fIcmdPrefix \fBseek \fIchannel offset base\fR
 .
 This \fIoptional\fR subcommand is responsible for the handling of
 \fBchan seek\fR and \fBchan tell\fR requests on the channel
-\fIchannelId\fR. If it is not supported then seeking will not be possible for
+\fIchannel\fR. If it is not supported then seeking will not be possible for
 the channel.
 .RS
 .PP
@@ -271,10 +271,10 @@ the new location identical to the current one, which is then returned.
 .RE
 .\" METHOD: configure
 .TP
-\fIcmdPrefix \fBconfigure \fIchannelId option value\fR
+\fIcmdPrefix \fBconfigure \fIchannel option value\fR
 .
 This \fIoptional\fR subcommand is for setting the type-specific options of
-channel \fIchannelId\fR. The \fIoption\fR argument indicates the option to be
+channel \fIchannel\fR. The \fIoption\fR argument indicates the option to be
 written, and the \fIvalue\fR argument indicates the value to set the option to.
 .RS
 .PP
@@ -291,10 +291,10 @@ converted to an error.
 .RE
 .\" METHOD: cget
 .TP
-\fIcmdPrefix \fBcget \fIchannelId option\fR
+\fIcmdPrefix \fBcget \fIchannel option\fR
 .
 This \fIoptional\fR subcommand is used when reading a single type-specific
-option of channel \fIchannelId\fR. If this subcommand is supported then the
+option of channel \fIchannel\fR. If this subcommand is supported then the
 subcommand \fBcgetall\fR must be supported as well.
 .RS
 .PP
@@ -307,10 +307,10 @@ will appear to have thrown this error. Any exception beyond \fIerror\fR
 .RE
 .\" METHOD: cgetall
 .TP
-\fIcmdPrefix \fBcgetall \fIchannelId\fR
+\fIcmdPrefix \fBcgetall \fIchannel\fR
 .
 This \fIoptional\fR subcommand is used for reading all type-specific options
-of channel \fIchannelId\fR. If this subcommand is supported then the
+of channel \fIchannel\fR. If this subcommand is supported then the
 subcommand \fBcget\fR has to be supported as well.
 .RS
 .PP
@@ -324,10 +324,10 @@ will appear to have thrown this error. Any exception beyond \fBerror\fR
 .RE
 .\" METHOD: blocking
 .TP
-\fIcmdPrefix \fBblocking \fIchannelId mode\fR
+\fIcmdPrefix \fBblocking \fIchannel mode\fR
 .
 This \fIoptional\fR subcommand handles changes to the blocking mode of the
-channel \fIchannelId\fR. The \fImode\fR is a boolean flag. A true value means
+channel \fIchannel\fR. The \fImode\fR is a boolean flag. A true value means
 that the channel has to be set to blocking, and a false value means that the
 channel should be non-blocking.
 .RS
@@ -341,10 +341,10 @@ etc.) is treated as and converted to an error.
 .RE
 .\" METHOD: truncate
 .TP
-\fIcmdPrefix \fBtruncate\fI channelId length\fR
+\fIcmdPrefix \fBtruncate\fI channel length\fR
 .
 This \fIoptional\fR subcommand handles changing the length of the
-underlying data stream for the channel \fIchannelId\fR. Its length
+underlying data stream for the channel \fIchannel\fR. Its length
 gets set to \fIlength\fR.
 .RS
 .PP
diff --git a/doc/seek.n b/doc/seek.n
index 8f0e707..5aa3439 100644
--- a/doc/seek.n
+++ b/doc/seek.n
@@ -12,7 +12,7 @@
 .SH NAME
 seek \- Change the access position for an open channel
 .SH SYNOPSIS
-\fBseek \fIchannelId offset \fR?\fIorigin\fR?
+\fBseek \fIchannel offset \fR?\fIorigin\fR?
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/tell.n b/doc/tell.n
index 4948a19..49c097c 100644
--- a/doc/tell.n
+++ b/doc/tell.n
@@ -12,7 +12,7 @@
 .SH NAME
 tell \- Return current access position for an open channel
 .SH SYNOPSIS
-\fBtell \fIchannelId\fR
+\fBtell \fIchannel\fR
 .BE
 .SH DESCRIPTION
 .PP
diff --git a/doc/transchan.n b/doc/transchan.n
index abae7b9..d174d23 100644
--- a/doc/transchan.n
+++ b/doc/transchan.n
@@ -12,7 +12,7 @@
 transchan \- command handler API of channel transforms
 .SH SYNOPSIS
 .nf
-\fBchan push \fIchannelId cmdPrefix\fR
+\fBchan push \fIchannel cmdPrefix\fR
 
 \fIcmdPrefix \fBclear \fIhandle\fR
 \fIcmdPrefix \fBdrain \fIhandle\fR
diff --git a/generic/tclIO.c b/generic/tclIO.c
index 4859bc1..4018e1a 100644
--- a/generic/tclIO.c
+++ b/generic/tclIO.c
@@ -9195,7 +9195,7 @@ Tcl_FileEventObjCmd(
     static const int maskArray[] = {TCL_READABLE, TCL_WRITABLE};
 
     if ((objc != 3) && (objc != 4)) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId event ?script?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel event ?script?");
 	return TCL_ERROR;
     }
     if (Tcl_GetIndexFromObj(interp, objv[2], modeOptions, "event name", 0,
diff --git a/generic/tclIOCmd.c b/generic/tclIOCmd.c
index c7ecb76..0357471 100644
--- a/generic/tclIOCmd.c
+++ b/generic/tclIOCmd.c
@@ -138,7 +138,7 @@ Tcl_PutsObjCmd(
 	/* Fall through */
     default:			/* [puts] or
 				 * [puts some bad number of arguments...] */
-	Tcl_WrongNumArgs(interp, 1, objv, "?-nonewline? ?channelId? string");
+	Tcl_WrongNumArgs(interp, 1, objv, "?-nonewline? ?channel? string");
 	return TCL_ERROR;
     }
 
@@ -222,7 +222,7 @@ Tcl_FlushObjCmd(
     int mode;
 
     if (objc != 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel");
 	return TCL_ERROR;
     }
     chanObjPtr = objv[1];
@@ -288,7 +288,7 @@ Tcl_GetsObjCmd(
     int code = TCL_OK;
 
     if ((objc != 2) && (objc != 3)) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId ?varName?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel ?varName?");
 	return TCL_ERROR;
     }
     chanObjPtr = objv[1];
@@ -379,7 +379,7 @@ Tcl_ReadObjCmd(
 
     argerror:
 	iPtr = (Interp *) interp;
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId ?numChars?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel ?numChars?");
 
 	/*
 	 * Do not append directly; that makes ensembles using this command as
@@ -387,7 +387,7 @@ Tcl_ReadObjCmd(
 	 */
 
 	iPtr->flags |= INTERP_ALTERNATE_WRONG_ARGS;
-	Tcl_WrongNumArgs(interp, 1, objv, "?-nonewline? channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "?-nonewline? channel");
 	return TCL_ERROR;
     }
 
@@ -515,7 +515,7 @@ Tcl_SeekObjCmd(
     static const int modeArray[] = {SEEK_SET, SEEK_CUR, SEEK_END};
 
     if ((objc != 3) && (objc != 4)) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId offset ?origin?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel offset ?origin?");
 	return TCL_ERROR;
     }
     if (TclGetChannelFromObj(interp, objv[1], &chan, NULL, 0) != TCL_OK) {
@@ -584,7 +584,7 @@ Tcl_TellObjCmd(
     int code;
 
     if (objc != 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel");
 	return TCL_ERROR;
     }
 
@@ -647,7 +647,7 @@ Tcl_CloseObjCmd(
     static const int dirArray[] = {TCL_CLOSE_READ, TCL_CLOSE_WRITE};
 
     if ((objc != 2) && (objc != 3)) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId ?direction?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel ?direction?");
 	return TCL_ERROR;
     }
 
@@ -753,7 +753,7 @@ Tcl_FconfigureObjCmd(
     int i;			/* Iterate over arg-value pairs. */
 
     if ((objc < 2) || (((objc % 2) == 1) && (objc != 3))) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId ?-option value ...?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel ?-option value ...?");
 	return TCL_ERROR;
     }
 
@@ -826,7 +826,7 @@ Tcl_EofObjCmd(
     Tcl_Channel chan;
 
     if (objc != 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel");
 	return TCL_ERROR;
     }
 
@@ -1038,7 +1038,7 @@ Tcl_FblockedObjCmd(
     int mode;
 
     if (objc != 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel");
 	return TCL_ERROR;
     }
 
@@ -1808,7 +1808,7 @@ ChanPendingObjCmd(
     int mode;
 
     if (objc != 3) {
-	Tcl_WrongNumArgs(interp, 1, objv, "mode channelId");
+	Tcl_WrongNumArgs(interp, 1, objv, "mode channel");
 	return TCL_ERROR;
     }
 
@@ -1868,7 +1868,7 @@ ChanTruncateObjCmd(
     Tcl_WideInt length;
 
     if ((objc < 2) || (objc > 3)) {
-	Tcl_WrongNumArgs(interp, 1, objv, "channelId ?length?");
+	Tcl_WrongNumArgs(interp, 1, objv, "channel ?length?");
 	return TCL_ERROR;
     }
     if (TclGetChannelFromObj(interp, objv[1], &chan, NULL, 0) != TCL_OK) {
diff --git a/generic/tclInterp.c b/generic/tclInterp.c
index 70e1246..985190f 100644
--- a/generic/tclInterp.c
+++ b/generic/tclInterp.c
@@ -1064,7 +1064,7 @@ NRInterpCmd(
 	Tcl_Channel chan;
 
 	if (objc != 5) {
-	    Tcl_WrongNumArgs(interp, 2, objv, "srcPath channelId destPath");
+	    Tcl_WrongNumArgs(interp, 2, objv, "srcPath channel destPath");
 	    return TCL_ERROR;
 	}
 	parentInterp = GetInterp(interp, objv[2]);
diff --git a/generic/tclTest.c b/generic/tclTest.c
index 0bb09f6..3b08cd6 100644
--- a/generic/tclTest.c
+++ b/generic/tclTest.c
@@ -6444,7 +6444,7 @@ TestChannelCmd(
 
 	if (argc != 5) {
 	    Tcl_AppendResult(interp, "wrong # args: should be \"", argv[0],
-		    " transform channelId -command cmd\"", (char *)NULL);
+		    " transform channel -command cmd\"", (char *)NULL);
 	    return TCL_ERROR;
 	}
 	if (strcmp(argv[3], "-command") != 0) {
diff --git a/library/tcltest/tcltest.tcl b/library/tcltest/tcltest.tcl
index 79492f6..25304404 100644
--- a/library/tcltest/tcltest.tcl
+++ b/library/tcltest/tcltest.tcl
@@ -1639,7 +1639,7 @@ proc tcltest::Replace::puts {args} {
 	    # return [Puts [lindex $args 0]]
 	}
 	2 {
-	    # Either -nonewline or channelId has been specified
+	    # Either -nonewline or channel has been specified
 	    if {[lindex $args 0] eq "-nonewline"} {
 		append outData [lindex $args end]
 		return
@@ -1651,7 +1651,7 @@ proc tcltest::Replace::puts {args} {
 	}
 	3 {
 	    if {[lindex $args 0] eq "-nonewline"} {
-		# Both -nonewline and channelId are specified, unless
+		# Both -nonewline and channel are specified, unless
 		# it's an error.  -nonewline is supposed to be argv[0].
 		set channel [lindex $args 1]
 		set newline ""
diff --git a/tests/chan.test b/tests/chan.test
index 87d642c..04fd17e 100644
--- a/tests/chan.test
+++ b/tests/chan.test
@@ -29,10 +29,10 @@ test chan-1.2 {chan command general syntax} -body {
 
 test chan-2.1 {chan command: blocked subcommand} -body {
     chan blocked foo bar
-} -returnCodes error -result "wrong # args: should be \"chan blocked channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan blocked channel\""
 test chan-3.1 {chan command: close subcommand} -body {
     chan close foo bar zet
-} -returnCodes error -result "wrong # args: should be \"chan close channelId ?direction?\""
+} -returnCodes error -result "wrong # args: should be \"chan close channel ?direction?\""
 test chan-3.2 {chan command: close subcommand} -setup {
     set chan [open [info script] r]
 } -body {
@@ -49,7 +49,7 @@ test chan-3.3 {chan command: close subcommand} -setup {
 } -returnCodes error -result "Half-close of write-side not possible, side not opened or already closed"
 test chan-4.1 {chan command: configure subcommand} -body {
     chan configure
-} -returnCodes error -result "wrong # args: should be \"chan configure channelId ?-option value ...?\""
+} -returnCodes error -result "wrong # args: should be \"chan configure channel ?-option value ...?\""
 test chan-4.2 {chan command: [Bug 800753]} -body {
     chan configure stdout -eofchar Ā
 } -returnCodes error -result {bad value for -eofchar: must be non-NUL ASCII character}
@@ -72,19 +72,19 @@ test chan-5.1 {chan command: copy subcommand} -body {
 
 test chan-6.1 {chan command: eof subcommand} -body {
     chan eof foo bar
-} -returnCodes error -result "wrong # args: should be \"chan eof channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan eof channel\""
 
 test chan-7.1 {chan command: event subcommand} -body {
     chan event foo
-} -returnCodes error -result "wrong # args: should be \"chan event channelId event ?script?\""
+} -returnCodes error -result "wrong # args: should be \"chan event channel event ?script?\""
 
 test chan-8.1 {chan command: flush subcommand} -body {
     chan flush foo bar
-} -returnCodes error -result "wrong # args: should be \"chan flush channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan flush channel\""
 
 test chan-9.1 {chan command: gets subcommand} -body {
     chan gets
-} -returnCodes error -result "wrong # args: should be \"chan gets channelId ?varName?\""
+} -returnCodes error -result "wrong # args: should be \"chan gets channel ?varName?\""
 
 test chan-10.1 {chan command: names subcommand} -body {
     chan names foo bar
@@ -92,23 +92,23 @@ test chan-10.1 {chan command: names subcommand} -body {
 
 test chan-11.1 {chan command: puts subcommand} -body {
     chan puts foo bar foo bar
-} -returnCodes error -result "wrong # args: should be \"chan puts ?-nonewline? ?channelId? string\""
+} -returnCodes error -result "wrong # args: should be \"chan puts ?-nonewline? ?channel? string\""
 
 test chan-12.1 {chan command: read subcommand} -body {
     chan read
-} -returnCodes error -result "wrong # args: should be \"chan read channelId ?numChars?\" or \"chan read ?-nonewline? channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan read channel ?numChars?\" or \"chan read ?-nonewline? channel\""
 
 test chan-13.1 {chan command: seek subcommand} -body {
     chan seek foo bar foo bar
-} -returnCodes error -result "wrong # args: should be \"chan seek channelId offset ?origin?\""
+} -returnCodes error -result "wrong # args: should be \"chan seek channel offset ?origin?\""
 
 test chan-14.1 {chan command: tell subcommand} -body {
     chan tell foo bar
-} -returnCodes error -result "wrong # args: should be \"chan tell channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan tell channel\""
 
 test chan-15.1 {chan command: truncate subcommand} -body {
     chan truncate foo bar foo bar
-} -returnCodes error -result "wrong \# args: should be \"chan truncate channelId ?length?\""
+} -returnCodes error -result "wrong \# args: should be \"chan truncate channel ?length?\""
 test chan-15.2 {chan command: truncate subcommand} -setup {
     set file [makeFile {} testTruncate]
     set f [open $file w+]
@@ -127,13 +127,13 @@ test chan-15.2 {chan command: truncate subcommand} -setup {
 # TIP 287: chan pending
 test chan-16.1 {chan command: pending subcommand} -body {
     chan pending
-} -returnCodes error -result "wrong # args: should be \"chan pending mode channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan pending mode channel\""
 test chan-16.2 {chan command: pending subcommand} -body {
     chan pending stdin
-} -returnCodes error -result "wrong # args: should be \"chan pending mode channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan pending mode channel\""
 test chan-16.3 {chan command: pending subcommand} -body {
     chan pending stdin stdout stderr
-} -returnCodes error -result "wrong # args: should be \"chan pending mode channelId\""
+} -returnCodes error -result "wrong # args: should be \"chan pending mode channel\""
 test chan-16.4 {chan command: pending subcommand} -body {
     chan pending {input output} stdout
 } -returnCodes error -result "bad mode \"input output\": must be input or output"
diff --git a/tests/chanio.test b/tests/chanio.test
index 6173d0d..e95a0ca 100644
--- a/tests/chanio.test
+++ b/tests/chanio.test
@@ -5505,10 +5505,10 @@ test chan-io-40.16 {verify no tilde substitution in open} -setup {
 
 test chan-io-41.1 {Tcl_FileeventCmd: errors} -constraints fileevent -body {
     chan event foo
-} -returnCodes error -result {wrong # args: should be "chan event channelId event ?script?"}
+} -returnCodes error -result {wrong # args: should be "chan event channel event ?script?"}
 test chan-io-41.2 {Tcl_FileeventCmd: errors} -constraints fileevent -body {
     chan event foo bar baz q
-} -returnCodes error -result {wrong # args: should be "chan event channelId event ?script?"}
+} -returnCodes error -result {wrong # args: should be "chan event channel event ?script?"}
 test chan-io-41.3 {Tcl_FileeventCmd: errors} -constraints fileevent -body {
     chan event gorp readable
 } -returnCodes error -result {can not find channel named "gorp"}
diff --git a/tests/io.test b/tests/io.test
index ad8d6b7..d550352 100644
--- a/tests/io.test
+++ b/tests/io.test
@@ -6074,10 +6074,10 @@ test io-40.17 {tilde substitution in open} {
 
 test io-41.1 {Tcl_FileeventCmd: errors} {fileevent} {
     list [catch {fileevent foo} msg] $msg
-} {1 {wrong # args: should be "fileevent channelId event ?script?"}}
+} {1 {wrong # args: should be "fileevent channel event ?script?"}}
 test io-41.2 {Tcl_FileeventCmd: errors} {fileevent} {
     list [catch {fileevent foo bar baz q} msg] $msg
-} {1 {wrong # args: should be "fileevent channelId event ?script?"}}
+} {1 {wrong # args: should be "fileevent channel event ?script?"}}
 test io-41.3 {Tcl_FileeventCmd: errors} {fileevent} {
     list [catch {fileevent gorp readable} msg] $msg
 } {1 {can not find channel named "gorp"}}
diff --git a/tests/ioCmd.test b/tests/ioCmd.test
index e8a9c57..07cf3cd 100644
--- a/tests/ioCmd.test
+++ b/tests/ioCmd.test
@@ -30,13 +30,13 @@ testConstraint testchannel	[llength [info commands testchannel]]
 
 test iocmd-1.1 {puts command} {
    list [catch {puts} msg] $msg
-} {1 {wrong # args: should be "puts ?-nonewline? ?channelId? string"}}
+} {1 {wrong # args: should be "puts ?-nonewline? ?channel? string"}}
 test iocmd-1.2 {puts command} {
    list [catch {puts a b c d e f g} msg] $msg
-} {1 {wrong # args: should be "puts ?-nonewline? ?channelId? string"}}
+} {1 {wrong # args: should be "puts ?-nonewline? ?channel? string"}}
 test iocmd-1.3 {puts command} {
    list [catch {puts froboz -nonewline kablooie} msg] $msg
-} {1 {wrong # args: should be "puts ?-nonewline? ?channelId? string"}}
+} {1 {wrong # args: should be "puts ?-nonewline? ?channel? string"}}
 test iocmd-1.4 {puts command} {
    list [catch {puts froboz hello} msg] $msg
 } {1 {can not find channel named "froboz"}}
@@ -70,10 +70,10 @@ test iocmd-1.8 {puts command} {
 
 test iocmd-2.1 {flush command} {
    list [catch {flush} msg] $msg
-} {1 {wrong # args: should be "flush channelId"}}
+} {1 {wrong # args: should be "flush channel"}}
 test iocmd-2.2 {flush command} {
    list [catch {flush a b c d e} msg] $msg
-} {1 {wrong # args: should be "flush channelId"}}
+} {1 {wrong # args: should be "flush channel"}}
 test iocmd-2.3 {flush command} {
    list [catch {flush foo} msg] $msg
 } {1 {can not find channel named "foo"}}
@@ -83,10 +83,10 @@ test iocmd-2.4 {flush command} {
 
 test iocmd-3.1 {gets command} {
    list [catch {gets} msg] $msg
-} {1 {wrong # args: should be "gets channelId ?varName?"}}
+} {1 {wrong # args: should be "gets channel ?varName?"}}
 test iocmd-3.2 {gets command} {
    list [catch {gets a b c d e f g} msg] $msg
-} {1 {wrong # args: should be "gets channelId ?varName?"}}
+} {1 {wrong # args: should be "gets channel ?varName?"}}
 test iocmd-3.3 {gets command} {
    list [catch {gets aaa} msg] $msg
 } {1 {can not find channel named "aaa"}}
@@ -107,16 +107,16 @@ test iocmd-3.5 {gets command} {
 
 test iocmd-4.1 {read command} {
    list [catch {read} msg] $msg
-} {1 {wrong # args: should be "read channelId ?numChars?" or "read ?-nonewline? channelId"}}
+} {1 {wrong # args: should be "read channel ?numChars?" or "read ?-nonewline? channel"}}
 test iocmd-4.2 {read command} {
    list [catch {read a b c d e f g h} msg] $msg
-} {1 {wrong # args: should be "read channelId ?numChars?" or "read ?-nonewline? channelId"}}
+} {1 {wrong # args: should be "read channel ?numChars?" or "read ?-nonewline? channel"}}
 test iocmd-4.3 {read command} {
    list [catch {read aaa} msg] $msg
 } {1 {can not find channel named "aaa"}}
 test iocmd-4.4 {read command} {
    list [catch {read -nonewline} msg] $msg
-} {1 {wrong # args: should be "read channelId ?numChars?" or "read ?-nonewline? channelId"}}
+} {1 {wrong # args: should be "read channel ?numChars?" or "read ?-nonewline? channel"}}
 test iocmd-4.5 {read command} {
    list [catch {read -nonew file4} msg] $msg $::errorCode
 } {1 {can not find channel named "-nonew"} {TCL LOOKUP CHANNEL -nonew}}
@@ -136,7 +136,7 @@ test iocmd-4.8 {read command with incorrect combination of arguments} {
     set x [list [catch {read -nonewline $f 20 z} msg] $msg $::errorCode]
     close $f
     set x
-} {1 {wrong # args: should be "read channelId ?numChars?" or "read ?-nonewline? channelId"} {TCL WRONGARGS}}
+} {1 {wrong # args: should be "read channel ?numChars?" or "read ?-nonewline? channel"} {TCL WRONGARGS}}
 test iocmd-4.9 {read command} {
     list [catch {read stdin foo} msg] $msg $::errorCode
 } {1 {expected non-negative integer but got "foo"} {TCL VALUE NUMBER}}
@@ -161,10 +161,10 @@ test iocmd-4.12 {read command} -setup {
 
 test iocmd-5.1 {seek command} -returnCodes error -body {
     seek
-} -result {wrong # args: should be "seek channelId offset ?origin?"}
+} -result {wrong # args: should be "seek channel offset ?origin?"}
 test iocmd-5.2 {seek command} -returnCodes error -body {
     seek a b c d e f g
-} -result {wrong # args: should be "seek channelId offset ?origin?"}
+} -result {wrong # args: should be "seek channel offset ?origin?"}
 test iocmd-5.3 {seek command} -returnCodes error -body {
     seek stdin gugu
 } -result {expected integer but got "gugu"}
@@ -174,20 +174,20 @@ test iocmd-5.4 {seek command} -returnCodes error -body {
 
 test iocmd-6.1 {tell command} {
     list [catch {tell} msg] $msg
-} {1 {wrong # args: should be "tell channelId"}}
+} {1 {wrong # args: should be "tell channel"}}
 test iocmd-6.2 {tell command} {
     list [catch {tell a b c d e} msg] $msg
-} {1 {wrong # args: should be "tell channelId"}}
+} {1 {wrong # args: should be "tell channel"}}
 test iocmd-6.3 {tell command} {
     list [catch {tell aaa} msg] $msg
 } {1 {can not find channel named "aaa"}}
 
 test iocmd-7.1 {close command} {
     list [catch {close} msg] $msg
-} {1 {wrong # args: should be "close channelId ?direction?"}}
+} {1 {wrong # args: should be "close channel ?direction?"}}
 test iocmd-7.2 {close command} {
     list [catch {close a b c d e} msg] $msg
-} {1 {wrong # args: should be "close channelId ?direction?"}}
+} {1 {wrong # args: should be "close channel ?direction?"}}
 test iocmd-7.3 {close command} {
     list [catch {close aaa} msg] $msg
 } {1 {can not find channel named "aaa"}}
@@ -216,10 +216,10 @@ proc expectedOpts {got extra} {
 }
 test iocmd-8.1 {fconfigure command} -returnCodes error -body {
     fconfigure
-} -result {wrong # args: should be "fconfigure channelId ?-option value ...?"}
+} -result {wrong # args: should be "fconfigure channel ?-option value ...?"}
 test iocmd-8.2 {fconfigure command} -returnCodes error -body {
     fconfigure a b c d e f
-} -result {wrong # args: should be "fconfigure channelId ?-option value ...?"}
+} -result {wrong # args: should be "fconfigure channel ?-option value ...?"}
 test iocmd-8.3 {fconfigure command} -returnCodes error -body {
     fconfigure a b
 } -result {can not find channel named "a"}
@@ -376,10 +376,10 @@ test iocmd-8.23 {fconfigure -profile badprofile} -body {
 
 test iocmd-9.1 {eof command} {
     list [catch {eof} msg] $msg $::errorCode
-} {1 {wrong # args: should be "eof channelId"} {TCL WRONGARGS}}
+} {1 {wrong # args: should be "eof channel"} {TCL WRONGARGS}}
 test iocmd-9.2 {eof command} {
     list [catch {eof a b} msg] $msg $::errorCode
-} {1 {wrong # args: should be "eof channelId"} {TCL WRONGARGS}}
+} {1 {wrong # args: should be "eof channel"} {TCL WRONGARGS}}
 test iocmd-9.3 {eof command} {
     catch {close file100}
     list [catch {eof file100} msg] $msg $::errorCode
@@ -389,10 +389,10 @@ test iocmd-9.3 {eof command} {
 
 test iocmd-10.1 {fblocked command} {
     list [catch {fblocked} msg] $msg
-} {1 {wrong # args: should be "fblocked channelId"}}
+} {1 {wrong # args: should be "fblocked channel"}}
 test iocmd-10.2 {fblocked command} {
     list [catch {fblocked a b c d e f g} msg] $msg
-} {1 {wrong # args: should be "fblocked channelId"}}
+} {1 {wrong # args: should be "fblocked channel"}}
 test iocmd-10.3 {fblocked command} {
     list [catch {fblocked file1000} msg] $msg
 } {1 {can not find channel named "file1000"}}
diff --git a/tests/pid.test b/tests/pid.test
index 3f62457..5abbe1f 100644
--- a/tests/pid.test
+++ b/tests/pid.test
@@ -47,7 +47,7 @@ test pid-1.3 {pid command} -constraints pidDefined -setup {
 } -result {}
 test pid-1.4 {pid command} pidDefined {
     list [catch {pid a b} msg] $msg
-} {1 {wrong # args: should be "pid ?channelId?"}}
+} {1 {wrong # args: should be "pid ?channel?"}}
 test pid-1.5 {pid command} pidDefined {
     list [catch {pid gorp} msg] $msg
 } {1 {can not find channel named "gorp"}}
diff --git a/tests/trace.test b/tests/trace.test
index 64c9111..16c858c 100644
--- a/tests/trace.test
+++ b/tests/trace.test
@@ -1695,7 +1695,7 @@ test trace-21.12 {bug 2438181} -setup {
     trace add execution set2 leave {puts one two three #;}
 } -body {
     set2 a hello
-} -returnCodes 1 -result {wrong # args: should be "puts ?-nonewline? ?channelId? string"}
+} -returnCodes 1 -result {wrong # args: should be "puts ?-nonewline? ?channel? string"}
 
 proc factorial {n} {
     if {$n != 1} { return [expr {$n * [factorial [expr {$n -1 }]]}] }
diff --git a/unix/tclUnixPipe.c b/unix/tclUnixPipe.c
index a61c083..046ec90 100644
--- a/unix/tclUnixPipe.c
+++ b/unix/tclUnixPipe.c
@@ -1380,7 +1380,7 @@ Tcl_PidObjCmd(
     Tcl_Obj *resultPtr;
 
     if (objc > 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "?channelId?");
+	Tcl_WrongNumArgs(interp, 1, objv, "?channel?");
 	return TCL_ERROR;
     }
 
diff --git a/win/tclWinPipe.c b/win/tclWinPipe.c
index eeb06f8..7b083a5 100644
--- a/win/tclWinPipe.c
+++ b/win/tclWinPipe.c
@@ -2762,7 +2762,7 @@ Tcl_PidObjCmd(
     Tcl_Obj *resultPtr;
 
     if (objc > 2) {
-	Tcl_WrongNumArgs(interp, 1, objv, "?channelId?");
+	Tcl_WrongNumArgs(interp, 1, objv, "?channel?");
 	return TCL_ERROR;
     }
     if (objc == 1) {