listbas: document Turbo and A+, plus (not yet existing) BXL/BXE.

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.