From 140ced429cba74084d65942840b1f97fc77d8d9b Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 23 Apr 2024 22:28:28 -0400 Subject: a8utf8: add -r (reverse) option. --- a8utf8.rst | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) (limited to 'a8utf8.rst') diff --git a/a8utf8.rst b/a8utf8.rst index 2d36193..ec9fbba 100644 --- a/a8utf8.rst +++ b/a8utf8.rst @@ -15,17 +15,17 @@ Convert Atari 8-bit text to UTF-8 encoded Unicode. SYNOPSIS ======== -*a8utf8* [**-i**] [*infile*] [*infile ...*] +*a8utf8* [**-r**] [**-i**] [*infile*] [*infile ...*] -*a8utf8* [**-i**] **-t** +*a8utf8* [**-r**] [**-i**] **-t** DESCRIPTION =========== -Convert Atari 8-bit ATASCII or International Character Set text to -UTF-8 encoded Unicode. Control graphics characters are replaced with -their nearest Unicode equivalents (mostly from the Box Drawing block, -or from the Basic Latin block with **-i** option). +Convert Atari 8-bit ATASCII or XL ICS (International Character +Set) text to UTF-8 encoded Unicode. Control graphics characters are +replaced with their nearest Unicode equivalents (mostly from the Box +Drawing block, or from the Basic Latin block with **-i** option). If no *infile* is given, input is read from standard input. Output always goes to standard output; to write to a file, use a command like:: @@ -47,6 +47,11 @@ OPTIONS -t Print table of Atari to Unicode equivalents, in CSV format. Can - be used with or without **-i** (two different tables). + be used with or without **-i** and/or **-r** (four different tables). + +-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. .. include:: manftr.rst -- cgit v1.2.3