summaryrefslogtreecommitdiffstats
path: root/doc/read.n
diff options
context:
space:
mode:
authoroehhar <harald.oehlmann@elmicron.de>2023-11-06 15:10:18 (GMT)
committeroehhar <harald.oehlmann@elmicron.de>2023-11-06 15:10:18 (GMT)
commitb0bcd99f0853484343dec35867a3db0aeafd1bba (patch)
tree1b25f392134fa103132bc9a5c6e96360372cd6e7 /doc/read.n
parentc6d4c4edeb9215994e40f1037aae1635e0887c70 (diff)
downloadtcl-b0bcd99f0853484343dec35867a3db0aeafd1bba.zip
tcl-b0bcd99f0853484343dec35867a3db0aeafd1bba.tar.gz
tcl-b0bcd99f0853484343dec35867a3db0aeafd1bba.tar.bz2
Refine read and gets documentation for encoding error case
Diffstat (limited to 'doc/read.n')
-rw-r--r--doc/read.n10
1 files changed, 5 insertions, 5 deletions
diff --git a/doc/read.n b/doc/read.n
index c1291bf..2add683 100644
--- a/doc/read.n
+++ b/doc/read.n
@@ -54,7 +54,8 @@ which \fBfconfigure\fR will alter input.
.PP
Encoding errors may exist, if the encoding profile \fBstrict\fR is used.
Encoding errors are special, as an eventual introspection or recovery is
-possible by changing to an encoding which accepts the data.
+possible by changing to an encoding (or encoding profile), which accepts
+the data.
An encoding error is reported by the POSIX error code \fBEILSEQ\fR.
.PP
In blocking mode, the error is directly thrown, even, if there is a
@@ -75,7 +76,7 @@ continued multi-byte sequence at position 1 (\fBA \\xC3 B\fR):
File creation for examples
.
.CS
-% set f [open test_A_195_B.txt wb]; puts -nonewline $f A\xC3B; close $f
+% set f [open test_A_195_B.txt wb]; puts -nonewline $f A\\xC3B; close $f
.CE
Blocking example
.
@@ -86,7 +87,7 @@ file35a65a0
% catch {read $f} e d
1
% set d
--data A -code 1 -level 0
+-code 1 -level 0
-errorstack {INNER {invokeStk1 read file35a65a0}}
-errorcode {POSIX EILSEQ {invalid or incomplete multibyte or wide character}}
-errorinfo {...} -errorline 1
@@ -110,12 +111,11 @@ A
% catch {read $f} e d
1
% set d
--data {} -code 1 -level 0
+-code 1 -level 0
-errorstack {INNER {invokeStk1 read file384b228}}
-errorcode {POSIX EILSEQ {invalid or incomplete multibyte or wide character}}
-errorinfo {...} -errorline 1
.CE
-ToDo: -data is TIP 653 and may be removed here or explained.
.SH "USE WITH SERIAL PORTS"
'\" Note: this advice actually applies to many versions of Tcl
.PP