diff options
author | B. Watson <urchlay@slackware.uk> | 2024-06-18 15:55:48 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-06-18 15:55:48 -0400 |
commit | 8c9f3575182678480bec6e04db0f323299e29530 (patch) | |
tree | 335d32d1b37c4c8585adb49fbdbab2846611978b /renumbas.1 | |
parent | 5830070ac1442ed17fd51418926f3cb566d94de8 (diff) | |
download | bw-atari8-tools-8c9f3575182678480bec6e04db0f323299e29530.tar.gz |
update doc.
Diffstat (limited to 'renumbas.1')
-rw-r--r-- | renumbas.1 | 40 |
1 files changed, 33 insertions, 7 deletions
@@ -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. |