diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-07-13 16:18:37 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-07-13 16:18:37 -0400 |
| commit | 40732792ab1f8a0ccd6ead9871a72d598cdd2646 (patch) | |
| tree | e7eca186c7d1aba70f41275355dc5ec21f69160e | |
| parent | 040863078e5d8c138fd11072ddf3cba061c57dcd (diff) | |
| download | bw-atari8-tools-40732792ab1f8a0ccd6ead9871a72d598cdd2646.tar.gz | |
listbas: tweak doc.
| -rw-r--r-- | listbas.1 | 9 | ||||
| -rw-r--r-- | listbas.rst | 13 |
2 files changed, 17 insertions, 5 deletions
@@ -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 |