diff options
author | dkf <donal.k.fellows@manchester.ac.uk> | 2012-04-16 06:15:09 (GMT) |
---|---|---|
committer | dkf <donal.k.fellows@manchester.ac.uk> | 2012-04-16 06:15:09 (GMT) |
commit | b7dd7d632e0f89b75985d796d4d806c22ee47bff (patch) | |
tree | bc271d77fbd11a554314f35a3faba2c42c7137ff /doc/FileSystem.3 | |
parent | e6a3425b9b813cef4639e7b89a2aea39c23813b9 (diff) | |
parent | c27db5cf156a3663a619a6a7e031a1a3c12064ac (diff) | |
download | tcl-b7dd7d632e0f89b75985d796d4d806c22ee47bff.zip tcl-b7dd7d632e0f89b75985d796d4d806c22ee47bff.tar.gz tcl-b7dd7d632e0f89b75985d796d4d806c22ee47bff.tar.bz2 |
* doc/FileSystem.3 (Tcl_FSOpenFileChannelProc): [Bug 3518244]: Fixed
documentation of this filesystem callback function; it must not
register its created channel - that's the responsibility of the caller
of Tcl_FSOpenFileChannel - as that leads to reference leaks.
Diffstat (limited to 'doc/FileSystem.3')
-rw-r--r-- | doc/FileSystem.3 | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/FileSystem.3 b/doc/FileSystem.3 index cf785ae..52eeb23 100644 --- a/doc/FileSystem.3 +++ b/doc/FileSystem.3 @@ -582,7 +582,7 @@ In addition, if \fIinterp\fR is non-NULL, \fBTcl_FSOpenFileChannel\fR leaves an error message in \fIinterp\fR's result after any error. .PP The newly created channel is not registered in the supplied interpreter; to -register it, use \fBTcl_RegisterChannel\fR, described below. +register it, use \fBTcl_RegisterChannel\fR. If one of the standard channels, \fBstdin\fR, \fBstdout\fR or \fBstderr\fR was previously closed, the act of creating the new channel also assigns it as a replacement for the standard channel. @@ -1218,8 +1218,9 @@ In addition, if \fIinterp\fR is non-NULL, the \fBTcl_FSOpenFileChannelProc\fR leaves an error message in \fIinterp\fR's result after any error. .PP -The newly created channel is not registered in the supplied -interpreter; to register it, use \fBTcl_RegisterChannel\fR. If one of +The newly created channel must not registered in the supplied +interpreter; that task is up to the caller of +\fBTcl_FSOpenFileChannel\fR (if necessary). If one of the standard channels, \fBstdin\fR, \fBstdout\fR or \fBstderr\fR was previously closed, the act of creating the new channel also assigns it as a replacement for the standard channel. |