aboutsummaryrefslogtreecommitdiff
path: root/renumbas.1
diff options
context:
space:
mode:
Diffstat (limited to 'renumbas.1')
-rw-r--r--renumbas.140
1 files changed, 33 insertions, 7 deletions
diff --git a/renumbas.1 b/renumbas.1
index f4b57a4..3252fab 100644
--- a/renumbas.1
+++ b/renumbas.1
@@ -100,6 +100,39 @@ Print version number and exit.
Verbose operation. When displaying a number in verbose mode, it will
be prefixed with \fI$\fP if it\(aqs in hex, or no prefix for decimal.
.UNINDENT
+.SH DIAGNOSTICS
+.INDENT 0.0
+.TP
+.B Fatal: Program is code\-protected; unprotect it first.
+Use \fBunprotbas\fP to remove the protection, if you get this error.
+.TP
+.B Fatal: New line number \fInum\fP would be >32767.
+32767 is the highest line number BASIC allows.
+Use a lower starting line (\fB\-s\fP) and/or increment (\fB\-i\fP).
+.TP
+.B Warning: Computed \fIcmd\fP at line \fInum\fP\&.
+The line number for a \fIGOTO\fP, \fIGOSUB\fP, etc is normally adjusted to
+whatever the line got renumbered to. This warning means that \fBrenumbas\fP
+couldn\(aqt adjust the line number, because it\(aqs a computed value such as
+\fIGOTO A+100\fP\&. You\(aqll have to fix this manually. \fInum\fP is the original
+line number, not the renumbered one.
+.TP
+.B Warning: Line \fInum1\fP references nonexistent line \fInum2\fP\&.
+Usually indicates a bug in the BASIC program. Example: \fIGOTO 100\fP,
+but there is no line 100. \fInum1\fP is the original line number, not the
+renumbered one.
+.TP
+.B Renumbering line \fInum1\fP as \fInum2\fP (\fInum3\fP refs).
+Only seen when the \fB\-v\fP (verbose) option is used. Just an informational
+message.
+.UNINDENT
+.SS Warning line numbers
+.sp
+Any warning that includes a line number (such as "Computed line number") will
+have the original line number, \fInot\fP the renumbered one. This is because
+the warnings are generated while scanning the program to find line number
+references, which happens before the actual renumbering (so the new number
+isn\(aqt known yet).
.SH LIMITATIONS
.sp
A pathological case:
@@ -120,13 +153,6 @@ the computation are constant. This is because neither Atari BASIC nor
.sp
This shouldn\(aqt be a real\-world problem; did \fIyou\fP ever write code like
that in Atari BASIC?
-.SS Warning line numbers
-.sp
-Any warning that includes a line number (such as "Computed line number") will
-have the original line number, \fInot\fP the renumbered one. This is because
-the warnings are generated while scanning the program to find line number
-references, which happens before the actual renumbering (so the new number
-isn\(aqt known yet).
.SH EXIT STATUS
.sp
0 for success, 1 for failure.