summaryrefslogtreecommitdiffstats
path: root/doc/CrtChannel.3
diff options
context:
space:
mode:
authorandreas_kupries <akupries@shaw.ca>2001-09-10 21:49:37 (GMT)
committerandreas_kupries <akupries@shaw.ca>2001-09-10 21:49:37 (GMT)
commitb0368c3a289b08dbecaeb808c094815e55bf17de (patch)
tree44e5908fe9a1ff52b5f50e9ce6ffb12bfdf3fb53 /doc/CrtChannel.3
parent82ef0abf09a1133e86d414254b30dd7d574b93da (diff)
downloadtcl-b0368c3a289b08dbecaeb808c094815e55bf17de.zip
tcl-b0368c3a289b08dbecaeb808c094815e55bf17de.tar.gz
tcl-b0368c3a289b08dbecaeb808c094815e55bf17de.tar.bz2
* doc/tclsh.1:
* doc/Tcl_Main.3: * doc/CrtChannel.3: * doc/OpenFileChnl.3: * doc/GetStdChan.3: Enhanced the manpages with cross-references to the new manpage and more explanations how these functions deal with the standard channels in various situations. * doc/StdChannels.3: New manpage describing handling of the standard channels by the Tcl library [402725].
Diffstat (limited to 'doc/CrtChannel.3')
-rw-r--r--doc/CrtChannel.313
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/CrtChannel.3 b/doc/CrtChannel.3
index 9cab385..f9e79be 100644
--- a/doc/CrtChannel.3
+++ b/doc/CrtChannel.3
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: CrtChannel.3,v 1.9 2001/03/30 23:06:39 andreas_kupries Exp $
+'\" RCS: @(#) $Id: CrtChannel.3,v 1.10 2001/09/10 21:49:37 andreas_kupries Exp $
.so man.macros
.TH Tcl_CreateChannel 3 8.3 Tcl "Tcl Library Procedures"
.BS
@@ -200,6 +200,15 @@ mode indicated by \fImask\fR.
For a discussion of channel drivers, their operations and the
\fBTcl_ChannelType\fR structure, see the section TCL_CHANNELTYPE, below.
.PP
+\fBTcl_CreateChannel\fR interacts with the code managing the standard
+channels. Once a standard channel was initialized either through a
+call to \fBTcl_GetStdChannel\fR or a call to \fBTcl_SetStdChannel\fR
+closing this standard channel will cause the next call to
+\fBTcl_CreateChannel\fR to make the new channel the new standard
+channel too. See \fBTcl_StandardChannel\fR for a general treatise
+about standard channels and the behaviour of the Tcl library with
+regard to them.
+.PP
\fBTcl_GetChannelInstanceData\fR returns the instance data associated with
the channel in \fIchannel\fR. This is the same as the \fIinstanceData\fR
argument in the call to \fBTcl_CreateChannel\fR that created this channel.
@@ -813,7 +822,7 @@ channel driver, due to problems with the earlier stacked channel
implementation (in 8.2.0 to 8.3.1).
.SH "SEE ALSO"
-Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3), Tcl_QueueEvent(3), Tcl_StackChannel(3)
+Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3), Tcl_QueueEvent(3), Tcl_StackChannel(3), Tcl_GetStdChannel(3)
.SH KEYWORDS
blocking, channel driver, channel registration, channel type, nonblocking