diff options
author | B. Watson <urchlay@slackware.uk> | 2022-08-29 16:11:13 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2022-08-29 16:11:13 -0400 |
commit | e2ba8458a5cfdfacfaf103e7ba97d610afa6c970 (patch) | |
tree | cd665e602e6e2b636578a7d3d7894380605dafcc /a8utf8.rst | |
download | bw-atari8-tools-e2ba8458a5cfdfacfaf103e7ba97d610afa6c970.tar.gz |
initial commit
Diffstat (limited to 'a8utf8.rst')
-rw-r--r-- | a8utf8.rst | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/a8utf8.rst b/a8utf8.rst new file mode 100644 index 0000000..2d36193 --- /dev/null +++ b/a8utf8.rst @@ -0,0 +1,52 @@ +.. RST source for a8utf8(1) man page. Convert with: +.. rst2man.py a8utf8.rst > a8utf8.1 +.. rst2man.py comes from the SBo development/docutils package. + +====== +a8utf8 +====== + +-------------------------------------------------- +Convert Atari 8-bit text to UTF-8 encoded Unicode. +-------------------------------------------------- + +.. include:: manhdr.rst + +SYNOPSIS +======== + +*a8utf8* [**-i**] [*infile*] [*infile ...*] + +*a8utf8* [**-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). + +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:: + + a8utf8 atari.txt > converted.txt + +The output is plain UTF-8 Unicode, without BOM. + +Inverse video (characters codes above **$80**) are translated to +their non-inverse equivalents, except **$9B** (Atari EOL), which is +translated to **\\n** (newline). + +OPTIONS +======= + +-i + Input uses Atari XL/XE International Character Set encoding, rather than + ATASCII graphics. + +-t + Print table of Atari to Unicode equivalents, in CSV format. Can + be used with or without **-i** (two different tables). + +.. include:: manftr.rst |