From 8c9f3575182678480bec6e04db0f323299e29530 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Tue, 18 Jun 2024 15:55:48 -0400 Subject: update doc. --- renumbas.1 | 40 +++++++++++++++++++++++++++++++++------- 1 file changed, 33 insertions(+), 7 deletions(-) (limited to 'renumbas.1') 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. -- cgit v1.2.3