summaryrefslogtreecommitdiffstats
path: root/doc/fcopy.n
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2007-10-26 20:11:50 (GMT)
committerdgp <dgp@users.sourceforge.net>2007-10-26 20:11:50 (GMT)
commit6b9dd216db20bac6c76552a6193d67a01e1d34ee (patch)
treeb86166558de62f70eef1a7524fac75f7b47a4f44 /doc/fcopy.n
parent236c395276f8f1cf4d5b745ea490b4966e6eb148 (diff)
downloadtcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.zip
tcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.tar.gz
tcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.tar.bz2
* changes: Updated for 8.5b2 release.core_8_5_b2
* doc/*.1: Revert doc changes that broke * doc/*.3: `make html` so we can get the release * doc/*.n: out the door.
Diffstat (limited to 'doc/fcopy.n')
-rw-r--r--doc/fcopy.n28
1 files changed, 14 insertions, 14 deletions
diff --git a/doc/fcopy.n b/doc/fcopy.n
index d59ddf8..766cca2 100644
--- a/doc/fcopy.n
+++ b/doc/fcopy.n
@@ -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: fcopy.n,v 1.13 2007/10/25 14:07:32 dkf Exp $
+'\" RCS: @(#) $Id: fcopy.n,v 1.14 2007/10/26 20:11:52 dgp Exp $
'\"
.so man.macros
.TH fcopy n 8.0 Tcl "Tcl Built-In Commands"
@@ -59,9 +59,7 @@ then all data already queued for \fIoutchan\fR is written out.
Note that \fIinchan\fR can become readable during a background copy.
You should turn off any \fBfileevent\fR handlers during a background
copy so those handlers do not interfere with the copy.
-Any I/O attempted by a \fBfileevent\fR handler will get a
-.QW "channel busy"
-error.
+Any I/O attempted by a \fBfileevent\fR handler will get a "channel busy" error.
.PP
\fBFcopy\fR translates end-of-line sequences in \fIinchan\fR and \fIoutchan\fR
according to the \fB\-translation\fR option
@@ -80,16 +78,16 @@ means that the incoming characters are converted internally first
UTF-8 and then into the encoding of the channel \fBfcopy\fR writes
to. See the manual entry for \fBfconfigure\fR for details on the
\fB\-encoding\fR and \fB\-translation\fR options. No conversion is
-done if both channels are set to encoding
-.QW "binary"
-and have matching translations. If only the output channel is set to encoding
-.QW "binary"
-the system will write the internal UTF-8 representation of the incoming
-characters. If only the input channel is set to encoding
-.QW "binary"
-the system will assume that the incoming bytes are valid UTF-8 characters and
-convert them according to the output encoding. The behaviour of the system for
-bytes which are not valid UTF-8 characters is undefined in this case.
+done if both channels are
+set to encoding "binary" and have matching translations. If only the
+output channel is set to
+encoding "binary" the system will write the internal UTF-8
+representation of the incoming characters. If only the input channel
+is set to encoding "binary" the system will assume that the incoming
+bytes are valid UTF-8 characters and convert them according to the
+output encoding. The behaviour of the system for bytes which are not
+valid UTF-8 characters is undefined in this case.
+
.SH EXAMPLES
.PP
The first example transfers the contents of one channel exactly to
@@ -146,7 +144,9 @@ set total 0
-command [list CopyMore $in $out $chunk]
vwait done
.CE
+
.SH "SEE ALSO"
eof(n), fblocked(n), fconfigure(n), file(n)
+
.SH KEYWORDS
blocking, channel, end of line, end of file, nonblocking, read, translation