aboutsummaryrefslogtreecommitdiff
path: root/listbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-13 16:18:37 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-13 16:18:37 -0400
commit40732792ab1f8a0ccd6ead9871a72d598cdd2646 (patch)
treee7eca186c7d1aba70f41275355dc5ec21f69160e /listbas.rst
parent040863078e5d8c138fd11072ddf3cba061c57dcd (diff)
downloadbw-atari8-tools-40732792ab1f8a0ccd6ead9871a72d598cdd2646.tar.gz
listbas: tweak doc.
Diffstat (limited to 'listbas.rst')
-rw-r--r--listbas.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/listbas.rst b/listbas.rst
index 2743d45..bef304e 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -206,6 +206,8 @@ scrambled variable names. For code-protected programs, it will stop at
the line with the invalid offset. Use **unprotbas**\(1) to remove the
protection.
+--
+
**listbas** is similar to Jindroush's **chkbas**\(1). The main differences are:
- **listbas** prints ATASCII graphics as Unicode equivalents, so the listing
@@ -231,6 +233,17 @@ protection.
- **listbas** tells you if the program is protected, and refuses to operate
on variable-protected programs.
+--
+
+The color and inverse/bold/underline support assumes your terminal supports
+ANSI/VT220 escape codes... but it does *not* use **curses**\(3X) or
+**terminfo**\(5), or even look at **TERM** in the environment. It just
+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.
+
+--
+
I thought about adding an HTML output option, but there's no need: if you want
a colorful listing of an Atari BASIC program, install **aha**\(1) from
https://github.com/theZiz/aha (or your distro's package repo) and run