aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--listbas.173
-rw-r--r--listbas.rst71
2 files changed, 77 insertions, 67 deletions
diff --git a/listbas.1 b/listbas.1
index f8e4219..009bdb2 100644
--- a/listbas.1
+++ b/listbas.1
@@ -41,7 +41,44 @@ format.
.sp
By default, output is Unicode in UTF\-8 encoding, with ANSI/VT220
escape sequences for inverse video and color syntax highlighting.
+.sp
+\fBlistbas\fP supports several BASIC dialects used on the Atari; see
+the \fB\-b\fP option for details.
.SH OPTIONS
+.SS BASIC options
+.INDENT 0.0
+.TP
+.B \fB\-b\fP
+Set the BASIC dialect the program was written in. Choices are:
+.INDENT 7.0
+.TP
+.B \fB\-ba\fP
+Program is Atari BASIC; this is the default.
+.TP
+.B \fB\-ba+\fP
+Program is OSS BASIC/A+.
+.TP
+.B \fB\-bt\fP
+Program is Turbo BASIC XL.
+.TP
+.B \fB\-bxl\fP
+Program is OSS BASIC XL.
+.TP
+.B \fB\-bxe\fP
+Program is OSS BASIC XE.
+.UNINDENT
+.sp
+If you see lots of "bad token XX" messages, or if the code just doesn\(aqt
+make any sense, you\(aqre using the wrong BASIC option. \fBwhichbas\fP(1)
+can (usually) detect the BASIC a program was written in.
+.TP
+.B \fB\-i\fP
+Include the immediate mode command (line 32768) in the output.
+.TP
+.B \fB\-l\fP
+Do not print line numbers at the start of each line. \fBGOTO\fP, \fBGOSUB\fP,
+\fBTRAP\fP, and \fBTHEN\fP target line numbers are still printed.
+.UNINDENT
.SS Output modes
.sp
The default output mode is Unicode/UTF\-8 representations of ATASCII
@@ -74,40 +111,9 @@ are printed. Use this only if your terminal \fIreally\fP doesn\(aqt support
Unicode (e.g. \fBrxvt\fP(1))... but even then, \fB\-m\fP is preferred,
because you can\(aqt tell what the dots are supposed to represent.
.UNINDENT
-.SS Other options
+.SS Other display options
.INDENT 0.0
.TP
-.B \fB\-b\fP
-Set the BASIC the program was written in. Choices are:
-.INDENT 7.0
-.TP
-.B \fB\-ba\fP
-Program is Atari BASIC; this is the default.
-.TP
-.B \fB\-ba+\fP
-Program is OSS BASIC/A+.
-.TP
-.B \fB\-bt\fP
-Program is Turbo BASIC XL.
-.TP
-.B \fB\-bxl\fP
-Program is OSS BASIC XL.
-.TP
-.B \fB\-bxe\fP
-Program is OSS BASIC XE.
-.UNINDENT
-.sp
-If you see lots of "bad token XX" messages, or if the code just doesn\(aqt
-make any sense, you\(aqre using the wrong BASIC option. \fBwhichbas\fP(1)
-can (usually) detect the BASIC a program was written in.
-.TP
-.B \fB\-i\fP
-Include the immediate mode command (line 32768) in the output.
-.TP
-.B \fB\-l\fP
-Do not print line numbers at the start of each line. \fBGOTO\fP, \fBGOSUB\fP,
-\fBTRAP\fP, and \fBTHEN\fP target line numbers are still printed.
-.TP
.B \fB\-C\fP
Enable color syntax highlighting. This option is enabled by default;
the \fB\-C\fP option is provided so you can override \fB\-n\fP in
@@ -243,8 +249,7 @@ looks very similar to how it would appear on the Atari.
.IP \(bu 2
\fBlistbas\fP does color syntax highlighting.
.IP \(bu 2
-\fBlistbas\fP only supports Atari BASIC, not Turbo BASIC or BASIC XL/XE.
-This is a bug, not a feature...
+\fBlistbas\fP supports OSS BASIC/A+ in addition to Turbo and BXL/BXE.
.IP \(bu 2
\fBlistbas\fP doesn\(aqt show information about the variables. Use \fBvxrefbas\fP(1)
for that.
diff --git a/listbas.rst b/listbas.rst
index 518dd5f..0d13a06 100644
--- a/listbas.rst
+++ b/listbas.rst
@@ -23,9 +23,44 @@ format.
By default, output is Unicode in UTF-8 encoding, with ANSI/VT220
escape sequences for inverse video and color syntax highlighting.
+**listbas** supports several BASIC dialects used on the Atari; see
+the **-b** option for details.
+
OPTIONS
=======
+BASIC options
+-------------
+
+**-b**
+ Set the BASIC dialect the program was written in. Choices are:
+
+ **-ba**
+ Program is Atari BASIC; this is the default.
+
+ **-ba+**
+ Program is OSS BASIC/A+.
+
+ **-bt**
+ Program is Turbo BASIC XL.
+
+ **-bxl**
+ Program is OSS BASIC XL.
+
+ **-bxe**
+ Program is OSS BASIC XE.
+
+ If you see lots of "bad token XX" messages, or if the code just doesn't
+ make any sense, you're using the wrong BASIC option. **whichbas**\(1)
+ can (usually) detect the BASIC a program was written in.
+
+**-i**
+ Include the immediate mode command (line 32768) in the output.
+
+**-l**
+ Do not print line numbers at the start of each line. **GOTO**, **GOSUB**,
+ **TRAP**, and **THEN** target line numbers are still printed.
+
Output modes
------------
@@ -58,37 +93,8 @@ characters.
Unicode (e.g. **rxvt**\(1))... but even then, **-m** is preferred,
because you can't tell what the dots are supposed to represent.
-Other options
--------------
-
-**-b**
- Set the BASIC the program was written in. Choices are:
-
- **-ba**
- Program is Atari BASIC; this is the default.
-
- **-ba+**
- Program is OSS BASIC/A+.
-
- **-bt**
- Program is Turbo BASIC XL.
-
- **-bxl**
- Program is OSS BASIC XL.
-
- **-bxe**
- Program is OSS BASIC XE.
-
- If you see lots of "bad token XX" messages, or if the code just doesn't
- make any sense, you're using the wrong BASIC option. **whichbas**\(1)
- can (usually) detect the BASIC a program was written in.
-
-**-i**
- Include the immediate mode command (line 32768) in the output.
-
-**-l**
- Do not print line numbers at the start of each line. **GOTO**, **GOSUB**,
- **TRAP**, and **THEN** target line numbers are still printed.
+Other display options
+---------------------
**-C**
Enable color syntax highlighting. This option is enabled by default;
@@ -209,8 +215,7 @@ protection.
- **listbas** does color syntax highlighting.
-- **listbas** only supports Atari BASIC, not Turbo BASIC or BASIC XL/XE.
- This is a bug, not a feature...
+- **listbas** supports OSS BASIC/A+ in addition to Turbo and BXL/BXE.
- **listbas** doesn't show information about the variables. Use **vxrefbas**\(1)
for that.