aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-06-26 04:47:08 -0400
committerB. Watson <urchlay@slackware.uk>2024-06-26 04:47:08 -0400
commit35f4a061cc467b750e00894e4bea42e43599e26c (patch)
tree9ce9e8eb16d0ffafaf24e6b5a76fb738be5cbe75
parent7a597bb19e8d6a60aff83366ee19c6192066431c (diff)
downloadbw-atari8-tools-35f4a061cc467b750e00894e4bea42e43599e26c.tar.gz
listbas: tweak doc.
-rw-r--r--listbas.112
-rw-r--r--listbas.rst12
2 files changed, 20 insertions, 4 deletions
diff --git a/listbas.1 b/listbas.1
index 8f45458..a22e490 100644
--- a/listbas.1
+++ b/listbas.1
@@ -42,6 +42,10 @@ format.
By default, output is piped through \fBa8eol\fP(1), to convert ATASCII
characters to human\-readable sequences. Raw ATASCII and Unicode output
are also available.
+.sp
+\fBa8eol\fP(1) and \fBa8utf8\fP(1) (for \fB\-u\fP) are run as external
+processes. The executables are searched for first in the current
+directory, and then in \fIPATH\fP\&.
.SH OPTIONS
.SS List options
.INDENT 0.0
@@ -54,8 +58,7 @@ Output raw ATASCII; no translation to the host character set. Must be
used with redirection; \fBlistbas\fP will not write ATASCII to the terminal.
.TP
.B \fB\-u\fP
-Use \fBa8utf8\fP(1) to translate ATASCII to ASCII. Requires \fBa8utf8\fP
-somewhere in \fIPATH\fP\&.
+Use \fBa8utf8\fP(1) to translate ATASCII to ASCII.
.UNINDENT
.SS General Options
.INDENT 0.0
@@ -72,6 +75,11 @@ be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.
.UNINDENT
.SH NOTES
.sp
+\fBlistbas\fP will refuse to operate on a LIST\-protected program with
+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
\fBlistbas\fP is similar to Jindroush\(aqs \fBchkbas\fP(1). The main differences are:
.INDENT 0.0
.IP \(bu 2
diff --git a/listbas.rst b/listbas.rst
index 3a8e746..c4a937a 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -24,6 +24,10 @@ By default, output is piped through **a8eol**\(1), to convert ATASCII
characters to human-readable sequences. Raw ATASCII and Unicode output
are also available.
+**a8eol**\(1) and **a8utf8**\(1) (for **-u**) are run as external
+processes. The executables are searched for first in the current
+directory, and then in *PATH*.
+
OPTIONS
=======
@@ -38,14 +42,18 @@ List options
used with redirection; **listbas** will not write ATASCII to the terminal.
**-u**
- Use **a8utf8**\(1) to translate ATASCII to ASCII. Requires **a8utf8**
- somewhere in *PATH*.
+ Use **a8utf8**\(1) to translate ATASCII to ASCII.
.. include:: genopts.rst
NOTES
=====
+**listbas** will refuse to operate on a LIST-protected program with
+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** only supports Atari BASIC, not Turbo BASIC or BASIC XL/XE.