From 40732792ab1f8a0ccd6ead9871a72d598cdd2646 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sat, 13 Jul 2024 16:18:37 -0400 Subject: listbas: tweak doc. --- listbas.1 | 9 ++++----- listbas.rst | 13 +++++++++++++ 2 files changed, 17 insertions(+), 5 deletions(-) diff --git a/listbas.1 b/listbas.1 index a7751e5..baf8847 100644 --- a/listbas.1 +++ b/listbas.1 @@ -155,11 +155,6 @@ Comments (\fBREM\fP text). Variable names. .UNINDENT .sp -Quotes around strings and commas between \fBDATA\fP items are -never colorized, so they\(aqll appear in the default foreground color -(usually white if the terminal has a black background, or black if the -background is white). -.sp Black and white are not used by default because presumably, one or the other is the background color of the terminal. .SS Customization @@ -243,6 +238,8 @@ scrambled variable names. For code\-protected programs, it will stop at the line with the invalid offset. Use \fBunprotbas\fP(1) to remove the protection. .sp +\-\- +.sp \fBlistbas\fP is similar to Jindroush\(aqs \fBchkbas\fP(1). The main differences are: .INDENT 0.0 .IP \(bu 2 @@ -270,6 +267,8 @@ specifically asked to do so. on variable\-protected programs. .UNINDENT .sp +\-\- +.sp I thought about adding an HTML output option, but there\(aqs no need: if you want a colorful listing of an Atari BASIC program, install \fBaha\fP(1) from \fI\%https://github.com/theZiz/aha\fP (or your distro\(aqs package repo) and run 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 -- cgit v1.2.3