diff options
Diffstat (limited to 'a8cat.rst')
-rw-r--r-- | a8cat.rst | 34 |
1 files changed, 30 insertions, 4 deletions
@@ -26,7 +26,13 @@ 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. +The output is plain UTF-8 Unicode, without BOM. It will display correctly +in modern terminals that support Unicode and UTF-8. If you get lots of +"empty rectangle" characters, it means your font lacks the glyphs for +the codepoints; try using the Deja Vu Sans and/or Symbola fonts. + +It's even possible to edit the converted text and turn it back into +ATASCII, if you're very careful. Inverse video (characters codes above **$80**) are translated using the ANSI/VT-100 reverse video escape sequences. Exception: **$9B** @@ -48,11 +54,31 @@ OPTIONS -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. + and bells are translated to the ASCII versions. Output created with this + option cannot be converted back to ATASCII with the **-r** option. -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. + 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. + +-m + Magazine listing mode. Rather than Unicode graphics characters, + ATASCII characters are printed in symbolic form, e.g. *{clear}* or + *{ctrl-A}*. The result is similar to type-in listings in magazines + like Antic, Analog, or Compute! Output created with this option + cannot be converted back to ATASCII with the **-r** option. + +-s + Strip the inverse video bit (bit 7) from all characters except the + EOL (**$9B**). Output created with this option can be converted + back to ATASCII with the **-r** option, but of course there won't + be any inverse-video characters in the result. + +**-h**, **--help** + Show built-in help and exit. .. include:: manftr.rst |