aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-09 21:04:58 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-09 21:04:58 -0400
commitfa5b2b4e18d25660cc0fe37b62d93fa03d88d5f0 (patch)
tree68381246f170e5008f4aca71ccacabe3e293952c
parentdbaaae8c651c5770bb9dd37fa408d0769d759ef6 (diff)
downloadbw-atari8-tools-fa5b2b4e18d25660cc0fe37b62d93fa03d88d5f0.tar.gz
whichbas: tweak doc.
-rw-r--r--whichbas.17
-rw-r--r--whichbas.rst8
2 files changed, 11 insertions, 4 deletions
diff --git a/whichbas.1 b/whichbas.1
index 1c97a73..9aba5a0 100644
--- a/whichbas.1
+++ b/whichbas.1
@@ -98,13 +98,17 @@ or OSS BASIC XL".
.sp
Atari Microsoft BASIC is detected by checking that:
.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
.IP \(bu 2
-the first byte of the file \fB$00\fP\&.
+the first byte of the file is \fB$00\fP\&.
.IP \(bu 2
the next 2 bytes (LSB/MSB) are the same as the actual file length minus 3.
.IP \(bu 2
the last 3 bytes of the file are zero.
.UNINDENT
+.UNINDENT
+.UNINDENT
.sp
This may result in false positives (files that aren\(aqt BASIC programs at
all might show up as Microsoft). Also, no distinction is made between
@@ -126,6 +130,7 @@ If you need the \fBfile\fP(1) command, use it.
\fBwhichbas\fP knows nothing about other BASICs such as Frost BASIC,
or Altirra BASIC.
.SH BUGS
+.SS Misdetection
.sp
It\(aqs possible to get a BASIC XL/XE program to misdetect as Atari BASIC
by writing a program that does these things:
diff --git a/whichbas.rst b/whichbas.rst
index b4150e1..5a09c6a 100644
--- a/whichbas.rst
+++ b/whichbas.rst
@@ -69,11 +69,11 @@ or OSS BASIC XL".
Atari Microsoft BASIC is detected by checking that:
-- the first byte of the file **$00**\.
+ - the first byte of the file is **$00**\.
-- the next 2 bytes (LSB/MSB) are the same as the actual file length minus 3.
+ - the next 2 bytes (LSB/MSB) are the same as the actual file length minus 3.
-- the last 3 bytes of the file are zero.
+ - the last 3 bytes of the file are zero.
This may result in false positives (files that aren't BASIC programs at
all might show up as Microsoft). Also, no distinction is made between
@@ -97,6 +97,8 @@ or Altirra BASIC.
BUGS
====
+Misdetection
+------------
It's possible to get a BASIC XL/XE program to misdetect as Atari BASIC
by writing a program that does these things: