diff options
author | B. Watson <urchlay@slackware.uk> | 2024-06-29 04:49:12 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-06-29 04:49:12 -0400 |
commit | 017a503f34a0f8ce2245f1b5dd78894f65326a90 (patch) | |
tree | 62ac02471db0a6e9b97b619b7b63f05110fad61b /a8cat.rst | |
parent | d1563c6d7db5e2c8484b80b870e7fb753400f6db (diff) | |
download | bw-atari8-tools-017a503f34a0f8ce2245f1b5dd78894f65326a90.tar.gz |
a8cat: added (will eventually replace both a8utf8 and a8eol).
Diffstat (limited to 'a8cat.rst')
-rw-r--r-- | a8cat.rst | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/a8cat.rst b/a8cat.rst new file mode 100644 index 0000000..7557c01 --- /dev/null +++ b/a8cat.rst @@ -0,0 +1,58 @@ +===== +a8cat +===== + +-------------------------------------------------- +Convert Atari 8-bit text to UTF-8 encoded Unicode. +-------------------------------------------------- + +.. include:: manhdr.rst + +SYNOPSIS +======== + +*a8cat* [**-r**] [**-i**] [**-u**] [**-t**] [*infile*] [*infile ...*] + +DESCRIPTION +=========== + +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*\s are given, input is read from standard input. Output always +goes to standard output; to write to a file, use a command like:: + + a8cat atari.txt > converted.txt + +The output is plain UTF-8 Unicode, without BOM. + +Inverse video (characters codes above **$80**) are translated using +the ANSI/VT-100 reverse video escape sequences. Exception: **$9B** +(Atari EOL) is translated to **\\n** (newline). + +OPTIONS +======= + +-i + Input uses Atari XL/XE International Character Set encoding, rather than + ATASCII graphics. + +-u + Use "underlining" for inverse video. Each inverse character is followed by + a backspace, then a *_* character. When viewed in a pager such as **less**\(1), + this causes the characters to appear underlined. Output created with this + option cannot be converted back to ATASCII with the **-r** option. + +-t + Text mode. Normally, everything but EOL (**$9B**) is converted to a + Unicode graphics character. In text mode, ATASCII tabs, backspace, + 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. + +.. include:: manftr.rst |