diff options
-rw-r--r-- | whichbas.1 | 21 | ||||
-rw-r--r-- | whichbas.rst | 20 |
2 files changed, 28 insertions, 13 deletions
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "WHICHBAS" 1 "2025-03-24" "0.2.2" "Urchlay's Atari 8-bit Tools" +.TH "WHICHBAS" 1 "2025-03-26" "0.2.2" "Urchlay's Atari 8-bit Tools" .SH NAME whichbas \- Determine BASIC variant of a tokenized Atari 8-bit program .SH SYNOPSIS @@ -35,9 +35,10 @@ whichbas \- Determine BASIC variant of a tokenized Atari 8-bit program whichbas [\-v] \fIinput\-file\fP [\fIinput\-file\fP ...] .SH DESCRIPTION .sp -\fBwhichbas\fP reads tokenized Atari 8\-bit BASIC, Turbo BASIC, -BASIC XL, BASIC XE, BASIC/A+, or Atari Microsoft BASIC programs and attempts to -discover which BASIC is required to run each one. +\fBwhichbas\fP reads tokenized Atari 8\-bit BASIC, Turbo BASIC, BASIC +XL, BASIC XE, BASIC/A+, OSS Integer BASIC, or Atari Microsoft BASIC +programs and attempts to discover which BASIC is required to run each +one. .sp \fIinput\-file\fPs must be actual files. \fBwhichbas\fP can\(aqt read from standard input, because it seeks in the input file. @@ -133,8 +134,11 @@ thoroughly tested. OSS Integer BASIC is a product that was developed by OSS, but never released until recently. It\(aqs similar to BASIC XL and XE, but uses 16\-bit integers for all numeric operations, rather than 6\-byte BCD -floating point. Integer BASIC\(aqs SAVEd programs are recognized by -the first two bytes, which are always \fB$77\fP \fB$00\fP\&. +floating point. Integer BASIC\(aqs SAVEd programs are recognized by the +first two bytes, which are always \fB$77\fP \fB$00\fP\&. There are two known +versions of Integer BASIC (disk and cartridge), which use different +command tokens; \fBwhichbas\fP detects which version by looking at the +token SAVE or CSAVE command at the end of the file. .sp Various non\-BASIC files are detected (including Mac/65 source, ELF binaries, etc) as a convenience, but I wouldn\(aqt rely on @@ -232,7 +236,10 @@ Compiled Turbo BASIC detected. OSS BASIC/A+ detected. .TP .B \fB15\fP -OSS Integer BASIC detected. +OSS Integer BASIC (cartridge version) detected. +.TP +.B \fB16\fP +OSS Integer BASIC (disk version) detected. .TP .B \fB64\fP None of the above; not BASIC. diff --git a/whichbas.rst b/whichbas.rst index 17e992e..10669e7 100644 --- a/whichbas.rst +++ b/whichbas.rst @@ -14,9 +14,11 @@ whichbas [-v] *input-file* [*input-file* ...] DESCRIPTION =========== -**whichbas** reads tokenized Atari 8-bit BASIC, Turbo BASIC, -BASIC XL, BASIC XE, BASIC/A+, or Atari Microsoft BASIC programs and attempts to -discover which BASIC is required to run each one. + +**whichbas** reads tokenized Atari 8-bit BASIC, Turbo BASIC, BASIC +XL, BASIC XE, BASIC/A+, OSS Integer BASIC, or Atari Microsoft BASIC +programs and attempts to discover which BASIC is required to run each +one. *input-file*\s must be actual files. **whichbas** can't read from standard input, because it seeks in the input file. @@ -98,8 +100,11 @@ thoroughly tested. OSS Integer BASIC is a product that was developed by OSS, but never released until recently. It's similar to BASIC XL and XE, but uses 16-bit integers for all numeric operations, rather than 6-byte BCD -floating point. Integer BASIC's SAVEd programs are recognized by -the first two bytes, which are always **$77** **$00**. +floating point. Integer BASIC's SAVEd programs are recognized by the +first two bytes, which are always **$77** **$00**. There are two known +versions of Integer BASIC (disk and cartridge), which use different +command tokens; **whichbas** detects which version by looking at the +token SAVE or CSAVE command at the end of the file. Various non-BASIC files are detected (including Mac/65 source, ELF binaries, etc) as a convenience, but I wouldn't rely on @@ -194,7 +199,10 @@ With the **-s** option, the exit status is: OSS BASIC/A+ detected. **15** - OSS Integer BASIC detected. + OSS Integer BASIC (cartridge version) detected. + +**16** + OSS Integer BASIC (disk version) detected. **64** None of the above; not BASIC. |