diff options
Diffstat (limited to 'a8cat.1')
| -rw-r--r-- | a8cat.1 | 36 |
1 files changed, 32 insertions, 4 deletions
@@ -53,7 +53,13 @@ a8cat atari.txt > converted.txt .UNINDENT .UNINDENT .sp -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. +.sp +It\(aqs even possible to edit the converted text and turn it back into +ATASCII, if you\(aqre very careful. .sp Inverse video (characters codes above \fB$80\fP) are translated using the ANSI/VT\-100 reverse video escape sequences. Exception: \fB$9B\fP @@ -74,12 +80,34 @@ option cannot be converted back to ATASCII with the \fB\-r\fP option. .B \-t Text mode. Normally, everything but EOL (\fB$9B\fP) 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 \fB\-r\fP option. .TP .B \-r Reverse conversion: Input is UTF\-8, output is ATASCII (or XL ICS, with \fB\-i\fP). -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 \fB\-i\fP option was used to +create the input, it must be used with \fB\-r\fP also. +.TP +.B \-m +Magazine listing mode. Rather than Unicode graphics characters, +ATASCII characters are printed in symbolic form, e.g. \fI{clear}\fP or +\fI{ctrl\-A}\fP\&. 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 \fB\-r\fP option. +.TP +.B \-s +Strip the inverse video bit (bit 7) from all characters except the +EOL (\fB$9B\fP). Output created with this option can be converted +back to ATASCII with the \fB\-r\fP option, but of course there won\(aqt +be any inverse\-video characters in the result. +.UNINDENT +.INDENT 0.0 +.TP +.B \fB\-h\fP, \fB\-\-help\fP +Show built\-in help and exit. .UNINDENT .SH COPYRIGHT .sp |