aboutsummaryrefslogtreecommitdiff
path: root/listamsb.1
diff options
context:
space:
mode:
Diffstat (limited to 'listamsb.1')
-rw-r--r--listamsb.116
1 files changed, 15 insertions, 1 deletions
diff --git a/listamsb.1 b/listamsb.1
index 0115e36..5a75eb2 100644
--- a/listamsb.1
+++ b/listamsb.1
@@ -32,7 +32,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
listamsb \- List the source of a tokenized Atari Microsoft BASIC program
.SH SYNOPSIS
.sp
-listamsb [\fB\-l\fP] | [[\fB\-a\fP] [\fB\-c\fP] [\fB\-v\fP] [\fB\-h\fP] [\fB\-i\fP] [\fB\-u\fP] [\fB\-t\fP] [\fB\-m\fP] [\fB\-n\fP] [\fB\-s\fP] ...] [\fB\-r\fP \fIline\-range\fP] [\fBinput\-file\fP] [\fBoutput\-file\fP]
+listamsb [\fB\-l\fP] | [\fB\-C\fP] | [[\fB\-a\fP] [\fB\-c\fP] [\fB\-v\fP] [\fB\-h\fP] [\fB\-i\fP] [\fB\-u\fP] [\fB\-t\fP] [\fB\-m\fP] [\fB\-n\fP] [\fB\-s\fP] ...] [\fB\-r\fP \fIline\-range\fP] [\fBinput\-file\fP] [\fBoutput\-file\fP]
.SH DESCRIPTION
.sp
\fBlistamsb\fP acts like the \fILIST\fP command in Atari Microsoft BASIC. It reads a
@@ -68,10 +68,24 @@ Check only. No output on stdout. Diagnostics are still printed on stderr,
and the exit status is unchanged. It\(aqs an error to give an \fBoutput\-file\fP with
this option.
.TP
+.B \fB\-C\fP
+"Crunch" program: remove comments and spaces that occur outside of a
+string. The resulting program is usually 5 to 10 percent smaller, and
+will RUN correctly, but will be difficult to edit in AMSB because its
+parser requires the spaces. Also, if any comment\-only lines are the
+target of GOTO or GOSUB, the program won\(aqt run because all comment\-only
+lines are removed.
+.sp
+This option must be used with an \fBoutput\-file\fP, a pipe, or
+redirection: \fBlistamsb\fP will not write tokenized BASIC to a
+terminal. \fBa8cat\fP is not used, with this option. None of the
+other options have any effect with \fB\-C\fP\&.
+.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\- or hyphen\-separated pair of starting and ending line numbers (e.g. \fB100,200\fP, or
\fB1000\-2000\fP).
+.sp
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".