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

1 files changed, 11 insertions, 6 deletions

diff --git a/a8cat.rst b/a8cat.rst
index 8367e35..3909391 100644
--- a/a8cat.rst
+++ b/a8cat.rst
@@ -61,12 +61,17 @@ OPTIONS
   and bells are translated to the ASCII versions.
 
 -r
-  Reverse conversion: Input is UTF-8, output is ATASCII (or XL ICS, with **-i**).
-  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 **-i** option was used to
-  create the input, it must be used with **-r** also.
+  Reverse conversion: Input is plain text, or UTF-8 created by a previous
+  run of **a8cat**; output is ATASCII (or XL ICS, with **-i**). ASCII
+  tabs, backspaces, and newlines will be coverted to the ATASCII
+  equivalent. ASCII carriage returns will be silently ignored.
+
+  Only the UTF-8 codepoints that correspond to ATASCII characters will
+  be converted. If the **-i** option was used to create the input, it
+  must be used with **-r** also.
+
+  **a8cat** will refuse to print ATASCII to a terminal. You must
+  redirect or pipe the output.
 
 -m
   Magazine listing mode. Rather than Unicode graphics characters,