aboutsummaryrefslogtreecommitdiff
path: root/a8xd.1
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-06-30 02:01:44 -0400
committerB. Watson <urchlay@slackware.uk>2024-06-30 02:01:44 -0400
commit012edc2ecfb3c77707adf1c26a192fd724a66594 (patch)
tree4c9e6772b684a8ad6ada024084583fb45ae0620d /a8xd.1
parent674f19a6a9b44f74724a6c26f655be02dd8d39b8 (diff)
downloadbw-atari8-tools-012edc2ecfb3c77707adf1c26a192fd724a66594.tar.gz
a8xd: add -g (GRAPHICS 1) option.
Diffstat (limited to 'a8xd.1')
-rw-r--r--a8xd.127
1 files changed, 26 insertions, 1 deletions
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