From 6768e4315973c67f7466c19a0e1e314c550d0039 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Sat, 29 Jun 2024 05:29:07 -0400
Subject: a8cat: add -m and -s options, fix tabs in -t mode.

---
 a8cat.1 | 36 ++++++++++++++++++++++++++++++++----
 1 file changed, 32 insertions(+), 4 deletions(-)

(limited to 'a8cat.1')

diff --git a/a8cat.1 b/a8cat.1
index d815a9c..b6d85a4 100644
--- a/a8cat.1
+++ b/a8cat.1
@@ -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
-- 
cgit v1.2.3