a8cat: refuse to write ATASCII to a terminal; swallow \r in -r mode.

1 files changed, 12 insertions, 7 deletions

diff --git a/a8cat.1 b/a8cat.1
index 30f96d0..8c47e9c 100644
--- a/a8cat.1
+++ b/a8cat.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "A8CAT" 1 "2024-06-29" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "A8CAT" 1 "2024-07-01" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 a8cat \- Convert Atari 8-bit text to UTF-8 encoded Unicode (and back).
 .SH SYNOPSIS
@@ -87,12 +87,17 @@ Unicode graphics character. In text mode, ATASCII tabs, backspace,
 and bells are translated to the ASCII versions.
 .TP
 .B  \-r
-Reverse conversion: Input is UTF\-8, output is ATASCII (or XL ICS, with \fB\-i\fP).
-Beware that printing ATASCII to a terminal may look funny, and may
-even confuse the terminal. Redirecting to a file is safe; piping
-to a pager usually is. Only the UTF\-8 codepoints that correspond to
-ATASCII characters will be converted. If the \fB\-i\fP option was used to
-create the input, it must be used with \fB\-r\fP also.
+Reverse conversion: Input is plain text, or UTF\-8 created by a previous
+run of \fBa8cat\fP; output is ATASCII (or XL ICS, with \fB\-i\fP). ASCII
+tabs, backspaces, and newlines will be coverted to the ATASCII
+equivalent. ASCII carriage returns will be silently ignored.
+.sp
+Only the UTF\-8 codepoints that correspond to ATASCII characters will
+be converted. If the \fB\-i\fP option was used to create the input, it
+must be used with \fB\-r\fP also.
+.sp
+\fBa8cat\fP will refuse to print ATASCII to a terminal. You must
+redirect or pipe the output.
 .TP
 .B  \-m
 Magazine listing mode. Rather than Unicode graphics characters,