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

1 files changed, 38 insertions, 33 deletions

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.