unprotbas: handle corner case where 129 vars are in the table.

1 files changed, 26 insertions, 9 deletions

diff --git a/unprotbas.1 b/unprotbas.1
index 992bd28..b2e44f5 100644
--- a/unprotbas.1
+++ b/unprotbas.1
@@ -234,21 +234,38 @@ Load the unprotected program on the Atari and LIST it (or use \fBchkbas\fP to ge
 listing), and edit \fBvarnames.txt\fP in a text editor.
 .sp
 As you figure out what each variable\(aqs purpose is, change its name
-in the text file. Don\(aqt delete any lines from the file, and don\(aqt
-add any. Don\(aqt get rid of the \fI$\fP or \fI(\fP at the end of any line. You
-may enter the names in lowercase (\fBunprotbas\fP will convert them to
-uppercase). Remember to follow the rules for BASIC variable names:
-only letters and numbers allowed, and the first character must be
-a letter. No duplicates of the same type are allowed (you can have
-\fIFOO\fP and \fIFOO$\fP, but not two numerics called \fIFOO\fP).
+in the text file. When editing the file:
+.INDENT 0.0
+.IP \(bu 2
+Don\(aqt add or delete any lines.
+.IP \(bu 2
+Don\(aqt get rid of the \fI$\fP or \fI(\fP at the end of any line.
+.IP \(bu 2
+You may enter the names in lowercase (\fBunprotbas\fP will convert them to uppercase).
+.IP \(bu 2
+Remember to follow the rules for BASIC variable names:
+The first character must be a letter, other characters must be a letter
+or a number, and only the last character can be \fI$\fP or \fI(\fP\&.
+.IP \(bu 2
+No duplicates of the same type are allowed (you can have \fIFOO\fP and \fIFOO$\fP,
+but not two numerics called \fIFOO\fP).
+.UNINDENT
 .sp
 When you\(aqre finished, re\-run \fBunprotbas\fP, this time with the \fB\-r\fP
-option. The unprotected program will use your variable names, rather
-than generating new ones.
+option. If all is well, the unprotected program will use your variable
+names, rather than generating new ones. If you broke the rules, you
+should get an informative error message explaining what and where the
+problem is.
 .sp
 This process can also be used for regular unprotected programs. Use
 \fB\-n \-w\fP the first time, to save the existing variable names to
 \fBvarnames.txt\fP rather than generating new ones.
+.SH NOTES
+.sp
+Atari BASIC has a limit of 128 variables in a program. It\(aqs actually
+possible for the variable name table (and the variable value table)
+to contain 129 variables, though the last one won\(aqt be usable in the
+program.
 .SH COPYRIGHT
 .sp
 WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.