From 0ce647158b93421659e0aebdb531fe32a96d2a5c Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 16 Jul 2024 03:12:53 -0400 Subject: listbas: document Turbo and A+, plus (not yet existing) BXL/BXE. --- listbas.1 | 73 +++++++++++++++++++++++++++++++++---------------------------- listbas.rst | 71 +++++++++++++++++++++++++++++++---------------------------- 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. -- cgit v1.2.3