diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-06-26 04:47:08 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-06-26 04:47:08 -0400 |
| commit | 35f4a061cc467b750e00894e4bea42e43599e26c (patch) | |
| tree | 9ce9e8eb16d0ffafaf24e6b5a76fb738be5cbe75 | |
| parent | 7a597bb19e8d6a60aff83366ee19c6192066431c (diff) | |
| download | bw-atari8-tools-35f4a061cc467b750e00894e4bea42e43599e26c.tar.gz | |
listbas: tweak doc.
| -rw-r--r-- | listbas.1 | 12 | ||||
| -rw-r--r-- | listbas.rst | 12 |
2 files changed, 20 insertions, 4 deletions
@@ -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. |