summaryrefslogtreecommitdiffstats
path: root/doc/binary.n
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2020-03-31 16:04:05 (GMT)
committerdgp <dgp@users.sourceforge.net>2020-03-31 16:04:05 (GMT)
commit5214ebc44f583a4abc01dc1a1af1838307774fbc (patch)
treea92bb2a3290371fe92885d4c57b17f79c2ee3347 /doc/binary.n
parentca8e5cafd0c038655ea1c483c45d87bdd41cd5ab (diff)
parentdfcc6b3a0ed4b8f7f5c9022957b039e10dbc98b4 (diff)
downloadtcl-5214ebc44f583a4abc01dc1a1af1838307774fbc.zip
tcl-5214ebc44f583a4abc01dc1a1af1838307774fbc.tar.gz
tcl-5214ebc44f583a4abc01dc1a1af1838307774fbc.tar.bz2
merge 8.6
Diffstat (limited to 'doc/binary.n')
-rw-r--r--doc/binary.n22
1 files changed, 13 insertions, 9 deletions
diff --git a/doc/binary.n b/doc/binary.n
index 00919f3..0e8b28e 100644
--- a/doc/binary.n
+++ b/doc/binary.n
@@ -105,23 +105,27 @@ produce files that other implementations of decoders cannot process):
.TP
\fB\-maxlen \fIlength\fR
.
-Indicates that the output should be split into lines of no more than
-\fIlength\fR characters. By default, lines are split every 61 characters, and
-this must be in the range 3 to 85 due to limitations in the encoding.
+Indicates the maximum number of characters to produce for each encoded line.
+The valid range is 5 to 85. Line lengths outside that range cannot be
+accommodated by the encoding format. The default value is 61.
.TP
\fB\-wrapchar \fIcharacter\fR
.
-Indicates that, when lines are split because of the \fB\-maxlen\fR option,
-\fIcharacter\fR should be used to separate lines. By default, this is a
-newline character,
-.QW \en .
+Indicates the character(s) to use to mark the end of each encoded line.
+Acceptable values are a sequence of zero or more characters from the
+set { \\x09 (TAB), \\x0B (VT), \\x0C (FF), \\x0D (CR) } followed
+by zero or one newline \\x0A (LF). Any other values are rejected because
+they would generate encoded text that could not be decoded. The default value
+is a single newline.
.PP
During decoding, the following options are supported:
.TP
\fB\-strict\fR
.
-Instructs the decoder to throw an error if it encounters unexpected
-whitespace characters. Otherwise it ignores them.
+Instructs the decoder to throw an error if it encounters anything
+outside of the standard encoding format. Without this option, the
+decoder tolerates some deviations, mostly to forgive reflows of lines
+between the encoder and decoder.
.PP
Note that neither the encoder nor the decoder handle the header and footer of
the uuencode format.