diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-05-29 03:31:23 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-05-29 03:31:47 -0400 |
| commit | 921cf9c521b64641f6364ef04b370979ce99fd64 (patch) | |
| tree | 31ebcce57f62b4372afdcce516480dd68d7be8f3 /unprotbas.1 | |
| parent | bcb4f66286476d6697c1f363a41eb167c958b40a (diff) | |
| download | bw-atari8-tools-921cf9c521b64641f6364ef04b370979ce99fd64.tar.gz | |
unprotbas: code readability (constants), mention rev B BASIC in doc.
Diffstat (limited to 'unprotbas.1')
| -rw-r--r-- | unprotbas.1 | 22 |
1 files changed, 16 insertions, 6 deletions
diff --git a/unprotbas.1 b/unprotbas.1 index b8123f1..98e17c4 100644 --- a/unprotbas.1 +++ b/unprotbas.1 @@ -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 "UNPROTBAS" 1 "2024-05-28" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "UNPROTBAS" 1 "2024-05-29" "0.2.1" "Urchlay's Atari 8-bit Tools" .SH NAME unprotbas \- Unprotect or create LIST-protected Atari 8-bit BASIC programs .SH SYNOPSIS @@ -235,11 +235,21 @@ This will fail if there\(aqs already a line 32767. .sp One more thing \fBunprotbas\fP can do is remove extra data from the end of the file. It\(aqs possible for BASIC files to contain extra data that -occurs after the end of the program. Some programs use this as a way -to load arbitrary binary data into memory along with the program; for -other programs, the extra data is truly garbage (e.g. an EOF character -if the file came from a CP/M system, or padding to a block size if a -dumb implementation of XMODEM was used to transfer the file). +occurs after the end of the program. Such data might be: +.INDENT 0.0 +.IP \(bu 2 +Arbitrary binary data used by the program at runtime, such as +machine language routines, or fonts. +.IP \(bu 2 +Zero bytes, caused by SAVEing the program with revision B BASIC. Every +time a program is LOADed, edited (or not) and then SAVEd again, 16 +bytes of extra (garbage) data gets added to the program. To avoid +this, don\(aqt use revision B (use rev C if possible, A otherwise). +.IP \(bu 2 +Garbage added by some system previously used to store or transmit +the file. CP/M systems might add an EOF (^Z) character. Dumb +file transfer software might pad the file up to its block size. +.UNINDENT .sp Normally, such "garbage" doesn\(aqt hurt anything. BASIC ignores it. Or it normally does... if you suspect it\(aqs causing a problem, you can |