aboutsummaryrefslogtreecommitdiff
path: root/listamsb.1
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2025-02-26 15:12:11 -0500
committerB. Watson <urchlay@slackware.uk>2025-02-26 15:12:27 -0500
commit2797f43e4cef6bea12e37208d3425cc72bd5778d (patch)
treed5c239f35da3384baa2b47e68793ee3c45338476 /listamsb.1
parent920ca094b9acd1e2b147cdb323a472a0da65dcc2 (diff)
downloadbw-atari8-tools-2797f43e4cef6bea12e37208d3425cc72bd5778d.tar.gz
listamsb: add -r option; listbas: fix typo in -r error message.
Diffstat (limited to 'listamsb.1')
-rw-r--r--listamsb.121
1 files changed, 16 insertions, 5 deletions
diff --git a/listamsb.1 b/listamsb.1
index a80a17d..a9f36e2 100644
--- a/listamsb.1
+++ b/listamsb.1
@@ -63,12 +63,23 @@ with this option.
Check only. No output on stdout. Diagnostics are still printed on stderr,
and the exit status is unchanged.
.TP
+.B \fB\-r\fP \fIline\-range\fP
+Show only part of the listing. \fIline\-range\fP can be a single line, or
+a comma\-separated pair of starting and ending line numbers (e.g. \fB100,200\fP).
+If the start line number is omitted (e.g. \fB,100\fP), it will be treated as
+\fB0\fP (meaning, list from the beginning of the program). If the ending line
+number is omitted (e.g. \fB100,\fP), it means "list until the end of the program".
+\fB\-r,\fP is equivalent to not using the \fB\-r\fP option at all.
+.TP
.B \fB\-v\fP
Verbose output, on stderr.
.TP
-.B \fB\-h\fP
+.B \fB\-h\fP, \fB\-\-help\fP
Print built\-in help and exit.
.TP
+.B \fB\-\-version\fP
+Print version number and exit.
+.TP
.B \fB\-i\fP, \fB\-u\fP, \fB\-t\fP, \fB\-m\fP, \fB\-s\fP
These options are passed to \fBa8cat\fP\&. See its man page for details. If
the \fB\-a\fP or \fB\-c\fP option is used, these options have no effect.
@@ -116,7 +127,7 @@ unexpected EOF, file truncated?
A tokenized AMSB file always ends with three null bytes (\fI$00\fP).
This file doesn\(aqt. Probably the rest of the file is missing.
.IP \(bu 2
-line \fIN\fP: EOL address \fIA\fP too (low|high)
+line \fIL\fP: EOL address \fIA\fP too (low|high)
.sp
Each line begins with the address of the next line. If the address
is below \fI$0700\fP, it\(aqs below the minimum value of \fIMEMLO\fP, which
@@ -124,11 +135,11 @@ is impossible. If it\(aqs above \fI$bc1f\fP, it would be in the display
list, screen memory, or OS ROM (also impossible). File is
corrupt, or not an AMSB file.
.IP \(bu 2
-line \fIN\fP: EOL address \fIA\fP <= previous \fIB\fP
+line \fIL\fP: EOL address \fIA\fP <= previous \fIB\fP
.sp
Corrupt file, or not an AMSB file.
.IP \(bu 2
-line \fIN\fP EOL address doesn\(aqt match actual line length \fIL\fP
+line \fIL\fP EOL address doesn\(aqt match actual line length \fIN\fP
.sp
Same as above: corrupt, or not AMSB.
.IP \(bu 2
@@ -141,7 +152,7 @@ line number out range
The program contains a line number that\(aqs greater than \fI63999\fP\&. How
did that happen?
.IP \(bu 2
-line \fIN\fP has character \fIC\fP outside of a string. maybe Atari BASIC?
+line \fIL\fP has character \fIC\fP outside of a string. maybe Atari BASIC?
.sp
This happens when ATASCII codes 0 to 31 (\fI$1f\fP) appear in the program.
AMSB can create files like this, but at runtime, it\(aqs a syntax error.