From 012edc2ecfb3c77707adf1c26a192fd724a66594 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Sun, 30 Jun 2024 02:01:44 -0400
Subject: a8xd: add -g (GRAPHICS 1) option.

---
 a8xd.1 | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

(limited to 'a8xd.1')

diff --git a/a8xd.1 b/a8xd.1
index 6e2f322..a02fc9e 100644
--- a/a8xd.1
+++ b/a8xd.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "A8XD" 1 "2024-06-29" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "A8XD" 1 "2024-06-30" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 a8xd \- Atari 8-bit ATASCII-aware hex dump
 .SH SYNOPSIS
@@ -65,8 +65,16 @@ Without \fIinfile\fP, or if \fIinfile\fP is \fB\-\fP, \fBa8xd\fP reads from stan
 .SH OPTIONS
 .INDENT 0.0
 .TP
+.B  \-a
+ANTIC mode: treat the input as screen bytes. Can usefully be combined
+with \fB\-g\fP\&.
+.TP
 .B  \-i
 Print XL/XE International Character Set conversions instead of ATASCII.
+.TP
+.B  \-g
+Graphics mode. Changes the colorization so it looks like \fIGRAPHICS 1\fP (or 2)
+on the Atari.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -117,6 +125,23 @@ Show version number and exit.
 .UNINDENT
 .SH NOTES
 .sp
+\fBa8xd\fP requires the terminal emulator to support UTF\-8 and use a
+font with the necessary glyphs. The author has tested extensively
+with \fBurxvt\fP(1) (aka \fBrxvt\-unicode\fP) and \fBxterm\fP(1), using
+the \fIDeja Vu Sans Mono\fP, \fIJetBrains Mono\fP, \fILiberation Mono\fP,
+and \fISymbola\fP fonts. Also \fBkitty\fP(1), \fBxfce4\-terminal\fP(1),
+KDE/Plasma 5\(aqs \fBkonsole\fP(1), \fBgnome\-terminal\fP(1) 3.43.90, and
+\fBst\fP(1) from suckless.org have been lightly tested and seem to work
+fine. Even the Linux console works, except that you won\(aqt be able to
+find a console font with all the necessary glyphs (I may create one
+someday).
+.sp
+\fBa8xd\fP only supports terminals that use ANSI\-style escape sequences
+for color and inverse video. This isn\(aqt much of a limitation, since
+all modern X, Wayland, Mac, etc terminal emulators have support for
+this... but it might annoy you if you\(aqre trying to use an Atari ST
+with a VT52 emulator as a serial terminal. Sorry.
+.sp
 \fBa8xd\fP supports a useful subset of \fBxxd\fP(1) options. The main things
 missing are:
 .INDENT 0.0
-- 
cgit v1.2.3