summaryrefslogtreecommitdiffstats
path: root/doc/fconfigure.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2005-04-13 10:53:44 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2005-04-13 10:53:44 (GMT)
commitcf3e789aeb16fe121d45176952685f191bc462d9 (patch)
treee3f5dd5d53fb04dd137055c5815a1bcd4ca5b0f9 /doc/fconfigure.n
parent1ecb433c37e275de5c25ded47dff83781103a095 (diff)
downloadtcl-cf3e789aeb16fe121d45176952685f191bc462d9.zip
tcl-cf3e789aeb16fe121d45176952685f191bc462d9.tar.gz
tcl-cf3e789aeb16fe121d45176952685f191bc462d9.tar.bz2
Improve documentation of -encoding binary option to [fconfigure].
Diffstat (limited to 'doc/fconfigure.n')
-rw-r--r--doc/fconfigure.n9
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/fconfigure.n b/doc/fconfigure.n
index 807ce90..a550c0e 100644
--- a/doc/fconfigure.n
+++ b/doc/fconfigure.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: fconfigure.n,v 1.11 2004/10/27 12:53:22 dkf Exp $
+'\" RCS: @(#) $Id: fconfigure.n,v 1.12 2005/04/13 10:53:44 dkf Exp $
'\"
.so man.macros
.TH fconfigure n 8.3 Tcl "Tcl Built-In Commands"
@@ -91,11 +91,14 @@ If a file contains pure binary data (for instance, a JPEG image), the
encoding for the channel should be configured to be \fBbinary\fR. Tcl
will then assign no interpretation to the data in the file and simply read or
write raw bytes. The Tcl \fBbinary\fR command can be used to manipulate this
-byte-oriented data.
+byte-oriented data. It is usually better to set the
+\fB\-translation\fR option to \fBbinary\fR when you want to transfer
+binary data, as this turns off the other automatic interpretations of
+the bytes in the stream as well.
.PP
The default encoding for newly opened channels is the same platform- and
locale-dependent system encoding used for interfacing with the operating
-system.
+system, as returned by \fBencoding system\fR.
.RE
.TP
\fB\-eofchar\fR \fIchar\fR