-*-TAGS-*-



File: Reseq,		NODE: Top,		Up: (BASIC)Top


     RESEQ is a BASIC-Plus program to resequence  the  line  numbers  of
BASIC-Plus source programs.
     RESEQ  recognizes  line  numbers  between 1 and 32767, and lines of
length up to 511 characters.  There may be up to 511 line numbers in the
source program.

* Menu:

* How To Run RESEQ::
* Answers To RESEQ's Questions::
* Errors and what they mean::

RESEQ recognizes line reference from:
 
            GOTO                  ELSE                LINE=
            GOSUB                 ERL=                LINE<
            ON - GOTO             ERL<                LINE>
            ON - GOSUB            ERL>                LINE<=
            ON ERROR GOTO         ERL<=               LINE>=
            RESUME                ERL>=               LINE<>
            THEN                  ERL<>

     All imbedded spaces, data  statements,  remarks,  and  quoted  text
strings  are handled correctly.  The actual line number preceding a line
must not have any imbedded spaces.

File: RESEQ,		Node: How to run RESEQ,		Up: Top,
	Next: Answers to RESEQ'S Questions


	RESEQ is a library program, and there is one important rule to
follow before running any LIBRARY program. "You must replace any BASIC
program that you have been working on before running any LIBRARY program.

So the first thing to do is to use the REPLACE command. (unless you have
a reason to throw away the  current version of your program).

Once you have typed REPLACE, all you need do is type:

LIB RESEQ

and RESEQ will start asking you some questions.  Now use the INFO command
'N' to get  "Answers to RESEQ's questions"

File: RESEQ,	Node: Answers to RESEQ's questions,	Up: top
	Prev: How to run RESEQ,		Next: Errors and What They Mean


** QUESTION ONE:

File:

[type  in the file name and extension of the BASIC program that you want
to resequence.  If extension is not specified .BAS is assumed.]


** QUESTION TWO:

Does this program use the EXTEND mode ?

   NOTE:   Typing NO for a program which does use the EXTEND mode can
   destroy your program.  REM statements in programs  which  use  the
   EXTEND mode must have at least 1 space after the word 'REM'.

   If you don't know what EXTEND mode is, then you should probably type
   "NO", but ask someone who knows, to be sure!

** QUESTION THREE

Do you wish to do multi-resequencing on this program ?

[Multi-resequencing is resequencing  several  different  parts  of  your
program.   For example, you may wish to resequence lines 1 to 1000, 5000
to 5999 and 7000 to 7999. In  this  case  you  would  type  YES  to  the
question.   A maximum of 20 resequencing parameters may be entered.   If
on  the  other  hand  you  wish to resequence your whole program or just
one part of your program then you would answer NO to the question.]

** QUESTION FOUR:
The  program  will  now  ask  you  for starting line number, ending line
number, new starting line number and increment  value.   Default  values
for each is given in angle brackets ('< >').

For each question you may: 1) type in a number or
                           2) press RETURN for the default value.

         NOTE:   If you answered YES to multi-resequencing then the
         program will re-ask you  for  another  set  of  parameters
         (starting  line,  ending  line,  etc.)  until  you  type a
         CONTROL-Z (hold down the CONTROL key and press  Z).  RESEQ
         will then start resequencing your program.
************
         If you answered NO to the multi-resequencing question then
         RESEQ will ask you for parameters only once.

************
For those who wan't to know what's going on inside:

RESEQ will tell the user when it enters each of its two passes.

   PASS 1 - Pass 1 makes a table of line numbers

   PASS 2 - Pass 2 does the actual linking, and resequencing

File: RESEQ,	Node: Errors and What They Mean,	 Up: top,
	Prev: Answers to RESEQ's Questions

     If a line number is referenced, and does not exist, then  '???'  is
put  as  the  reference  line number, and the following error message is
printed out:

*** Line number ##### not found at line %%%%% ( @@@@@ )

Where  ##### is the original line  reference,  %%%%%  is  the  old  line
number  where the error occurred, and @@@@@ is the new line number where
the error occurred.

     If RESEQ should resequence a  line  greater  than  32767  then  the
following error message is printed out:

*** Line number overflow

The  original  program  will not be resequenced and the program will ask
for another file.  This error message may  be  avoided  by  setting  the
increment value lower.



     If RESEQ should come across a line with more than 511 characters in
it, then the following error message is printed out:

*** Character overflow at line #####

Where ##### is the line with more than 511 characters.

     The original file is replaced by the resequenced file at the end of
the  run.   Any  abort  during  a run will leave the original BASIC file
intact.

     Any other error will cause the BASIC-Plus error to be printed  out,
and execution resumed, if possible.

     When  the  'File:'  question  appears  again,  the user may specify
another file, or type a CONTROL-Z (^Z) to exit the program.




 

TAGS: :SGAT
Top:19
How to run RESEQ:1076
Answers to RESEQ's questions:1711
Errors and What They Mean:3977