aboutsummaryrefslogtreecommitdiff
path: root/a8xd.rst
diff options
context:
space:
mode:
Diffstat (limited to 'a8xd.rst')
-rw-r--r--a8xd.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/a8xd.rst b/a8xd.rst
index ec8868d..057ffbe 100644
--- a/a8xd.rst
+++ b/a8xd.rst
@@ -41,9 +41,17 @@ Without *infile*, or if *infile* is **-**, **a8xd** reads from standard input.
OPTIONS
=======
+-a
+ ANTIC mode: treat the input as screen bytes. Can usefully be combined
+ with **-g**.
+
-i
Print XL/XE International Character Set conversions instead of ATASCII.
+-g
+ Graphics mode. Changes the colorization so it looks like *GRAPHICS 1* (or 2)
+ on the Atari.
+
-l *len*
Stop after dumping *len* bytes. *len* may be given in decimal or hex (with
leading *0x* or *$*).
@@ -84,6 +92,23 @@ OPTIONS
NOTES
=====
+**a8xd** requires the terminal emulator to support UTF-8 and use a
+font with the necessary glyphs. The author has tested extensively
+with **urxvt**\(1) (aka **rxvt-unicode**) and **xterm**\(1), using
+the *Deja Vu Sans Mono*, *JetBrains Mono*, *Liberation Mono*,
+and *Symbola* fonts. Also **kitty**\(1), **xfce4-terminal**\(1),
+KDE/Plasma 5's **konsole**\(1), **gnome-terminal**\(1) 3.43.90, and
+**st**\(1) from suckless.org have been lightly tested and seem to work
+fine. Even the Linux console works, except that you won't be able to
+find a console font with all the necessary glyphs (I may create one
+someday).
+
+**a8xd** only supports terminals that use ANSI-style escape sequences
+for color and inverse video. This isn't much of a limitation, since
+all modern X, Wayland, Mac, etc terminal emulators have support for
+this... but it might annoy you if you're trying to use an Atari ST
+with a VT52 emulator as a serial terminal. Sorry.
+
**a8xd** supports a useful subset of **xxd**\(1) options. The main things
missing are: