From 2926604dc6651711ab525ab5fd84762748ce51ff Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Mon, 1 Jul 2024 18:03:27 -0400 Subject: a8cat: refuse to write ATASCII to a terminal; swallow \r in -r mode. --- a8cat.rst | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) (limited to 'a8cat.rst') 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, -- cgit v1.2.3