listbas: tweak doc.

2 files changed, 70 insertions, 1 deletions

diff --git a/listbas.1 b/listbas.1
index 4a3c1fa..9b27d5b 100644
--- a/listbas.1
+++ b/listbas.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 "LISTBAS" 1 "2024-07-13" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "LISTBAS" 1 "2024-07-14" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 listbas \- List the source of a tokenized Atari 8-bit BASIC program
 .SH SYNOPSIS
@@ -280,6 +280,42 @@ blindly emits the escape codes. Likewise, Unicode characters are printed
 in UTF\-8 encoding, without actually checking whether the terminal or the
 current locale supports UTF\-8.
 .sp
+\fBlistbas\fP has been tested and is known to work in at least these
+terminals:
+.INDENT 0.0
+.INDENT 3.5
+\fBrxvt\-unicode\fP, aka \fBurxvt\fP\&. This is the terminal the author uses.
+.sp
+\fBxterm\fP \- tested frequently. Requires the XTerm.locale resource
+to be set to \fBUTF\-8\fP (e.g. in \fB~/.Xdefaults\fP), or the \fB\-lc\fP
+and/or \fB\-en UTF\-8\fP command line options.
+.sp
+\fBLinux console\fP \- works fine, but good luck finding a font with
+all the Unicode graphics characters. Better use \fB\-m\fP\&.
+.sp
+\fBkitty\fP \- very fancy terminal emulator that supports both X11 and
+Wayland. \fBlistbas\fP was only tested on X11.
+.sp
+\fBxfce4\-terminal\fP \- version 0.8.10, with XFCE4 4.16.0.
+.sp
+\fBkonsole\fP \- the KDE terminal, from KDE 5.90.
+.sp
+\fBgnome\-terminal\fP \- version 3.43.90.
+.sp
+\fBst\fP \- minimal terminal from suckless.org, version 0.9.2.
+.sp
+\fBmlterm\fP \- version 3.9.3.
+.sp
+\fBkmscon\fP \- version 9.0.0. \fI\%https://github.com/Aetf/kmscon\fP
+.sp
+\fBfbterm\fP \- version 1.8. \fI\%https://github.com/sfzhi/fbterm\fP
+.UNINDENT
+.UNINDENT
+.sp
+Also, \fBrxvt\fP and \fBaterm\fP don\(aqt support Unicode, but they will
+otherwise work (display color and inverse) with the \fB\-m\fP or \fB\-d\fP
+options to \fBlistbas\fP\&.
+.sp
 \-\-
 .sp
 I thought about adding an HTML output option, but there\(aqs no need: if you want
diff --git a/listbas.rst b/listbas.rst
index ced8ccc..855238a 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -246,6 +246,39 @@ blindly emits the escape codes. Likewise, Unicode characters are printed
 in UTF-8 encoding, without actually checking whether the terminal or the
 current locale supports UTF-8.
 
+**listbas** has been tested and is known to work in at least these
+terminals:
+
+  **rxvt-unicode**, aka **urxvt**. This is the terminal the author uses.
+
+  **xterm** - tested frequently. Requires the XTerm.locale resource
+  to be set to **UTF-8** (e.g. in **~/.Xdefaults**\), or the **-lc**
+  and/or **-en UTF-8** command line options.
+
+  **Linux console** - works fine, but good luck finding a font with
+  all the Unicode graphics characters. Better use **-m**.
+
+  **kitty** - very fancy terminal emulator that supports both X11 and
+  Wayland. **listbas** was only tested on X11.
+
+  **xfce4-terminal** - version 0.8.10, with XFCE4 4.16.0.
+
+  **konsole** - the KDE terminal, from KDE 5.90.
+
+  **gnome-terminal** - version 3.43.90.
+
+  **st** - minimal terminal from suckless.org, version 0.9.2.
+
+  **mlterm** - version 3.9.3.
+
+  **kmscon** - version 9.0.0. https://github.com/Aetf/kmscon
+
+  **fbterm** - version 1.8. https://github.com/sfzhi/fbterm
+
+Also, **rxvt** and **aterm** don't support Unicode, but they will
+otherwise work (display color and inverse) with the **-m** or **-d**
+options to **listbas**.
+
 --
 
 I thought about adding an HTML output option, but there's no need: if you want