"","     THIS PROGRAM ENABLES THE USER TO 'TRACE' THE LOGICAL FLOW OF","HIS PROGRAM. THIS CAPABILITY IS OFTEN  FOUND  IN  MICROCOMPUTERS,","SUCH  AS  THE APPLE II OR THE TRS-80. AFTER YOUR PROGRAM HAS BEEN","COMPILED, A 'RUN' OF IT WILL DISPLAY THE NUMBER OF EACH  LINE  OF","CODE AS THE MACHINE EXECUTES IT.  FOR EXAMPLE, THE SUBROUTINE:","","  100 PRINT \34THIS IS A TEST.\34","  110 IF X=0 THEN 200","  120 RETURN","","ASSUMING THIS SUBROUTINE WAS CALLED FROM LINE 50, THE 'RUN' WOULD","PRODUCE THE FOLLOWING:",""
"  <50> <100> THIS IS A TEST.","  <110> <120> <60> ...","","     IN THIS EXAMPLE, LINE 50 CALLS THE SUBROUTINE, AND  SO  IT'S","'GOSUB'  IS  INDICATED BY THE '<50>'. THE FLOW THEN JUMPS TO LINE","100, INDICATED BY '<100>'. IN LINE 200, A TEST  IS  PERFORMED  ON","THE  NUMERICAL VARIABLE 'X'. IN THIS CASE, X DOES NOT EQUAL 0, SO","THE TEST FAILS AND THE FLOW PROCEEDS TO THE NEXT  LINE,  DEPICTED","BY  '<110>  <120>'.  WHEN LINE 120 IS EXECUTED, THE MACHINE JUMPS"
"BACK TO WHERE THE PREVIOUS 'GOSUB' OCCURED AND EXECUTES THE  LINE","FOLLOWING  THAT.   THIS IS SHOWN AS '<120> <60>', WHICH INDICATES","THAT   A   JUMP   TO   LINE   60   OCCURED   AT     LINE     120.","     AS  YOU  CAN SEE, THIS TRACING OF THE FLOW CAN BE QUITE VAL-","UABLE TO DEBUGGING. USERS CAN DETERMINE EXACTLY  WHEN  AND  WHERE","EACH  LINE  OF  THEIR  PROGRAM  IS  EXECUTED AND CAN MONITOR CON-","DITIONAL BRANCHES ('IF' STATEMENTS).  TO  USE  THE  PROGRAM,  THE","FOLLOWING MUST BE DONE:",""
"1) CREATE  A  DISC-RESIDENT  ASCII  FILE  LARGE  ENOUGH  TO  HOLD","   THE  PROGRAM  YOU  WANT  TRACED  TIMES  TWO.  IN  OTHER WORDS,","   IF YOU ARE GOING  TO  TRACE  A  3  RECORD  PROGRAM,  THE  FILE","   MUST   BE  AT  LEAST  6  RECORDS  LONG  (3*2=6)  TO  HOLD  THE","   FINAL  CODE.  THE  FORMAT   FOR   CREATING   A   DISC-RESIDENT","   ASCII FILE IS 'FILE-NAME,DS,FILE LENGTH,RECORD LENGTH'  WHERE","'NAME' IS THE NAME WHICH YOU WISH TO CREATE THE ACCOUNT UNDER,"
"'DS' IS JUST THAT.  'DS' MEANS THAT THIS WILL BE A DISC FILE AND","NOT MAG TAPE OR PAPER TAPE.  YOU ARE ONLY PERMITTED TO CREATE","DISC-RESIDENT ASCII FILES.  'FILE LENGTH' SHOULD BE AN INTEGER","BETWEEN 1 AND 32767 WHICH SPECIFIES HOW LONG THIS FILE WILL BE. ","'RECORD LENGTH' SHOULD BE OMITTED FOR THIS PURPOSE.  FOR EXAMPLE,","IF ONE WANTED TO CREATE A FILE TO HOLD A 100 LINE PROGRAM UNDER","THE NAME","OF 'ASCFIL', THEN TYPE:  FIL-ASCFIL,DS,200",""
"2)  AFTER  THE  FILE  HAS  BEEN  CREATED,  YOU  MUST  PLACE  YOUR","   PROGRAM   TO  BE  TRACED  IN  IT.  THIS  CAN  BE  ACCOMPLISHED","   BY 'GET'TING THE PROGRAM INTO  YOUR  WORK  SPACE  AND  TYPING:","   'LIST*OUT=FILENAME*',    WHERE    'FILENAME'   IS   THE   NAME","   OF  THE  PREVIOUSLY  CREATED  ASCII  DISC  FILE.  THE  PROGRAM","   IS NOW IN THE ASCII FILE AND STILL IN YOUR WORKSPACE.","","3)  TYPE  'EXE-$TRACE'  TO  EXECUTE  THIS  PROGRAM.  THE  PROGRAM"
"   WILL   THEN   PROMT   'FILE   (ASCII):'.   TYPE  IN  THE  NAME","   OF THE ASCII FILE WHICH HOLDS YOUR PROGRAM TO BE TRACED.","","4)  THE  PROGRAM  WILL  BEGIN  COMPILING  YOUR  PROGRAM  AS  SOON","   AS   YOU   PRESS   'RETURN'.   PLEASE   BE  PATIENT,  AS  THIS","   COULD TAKE UP  TO  ONE  MINUTE  TO  COMPILE.  THE  COMPILATION","   TIME   IS   DETERMINED   BY   THE   LENGTH  OF  YOUR  PROGRAM.","   APPROPRIATE  ERRORS  WILL  BE   GENERATED   WHEN   NECCESSARY."
"   IF  ALL  GOES  WELL,  YOU  WILL  BE  TOLD  HOW  MANY  LINES OF","   CODE ARE IN YOUR PROGRAM AND THE PROGRAM WILL END NORMALLY.","","5)  AFTER  COMPILATION  IS  COMPLETE,  YOU  MUST  RETRIEVE   YOUR","   PROGRAM  BACK  FROM  THE  ASCII FILE. THIS CAN BE ACCOMPLISHED","   BY   TYPING   'SCR'   FOLLOWED   BY   'LOAD-FILENAME',   WHERE","   'FILENAME'  IS  THE  NAME  OF  THE  ASCII FILE CONTAINING YOUR","   COMPILED  PROGRAM.  IT  IS  VERY  IMPORTANT  THAT  YOU   'SCR'"
"   BEFORE   YOU   LOAD,   AS  LOADING  AN  ASCII  FILE  DOES  NOT","   CLEAR  YOUR  WORK  SPACE.  IF  YOU  HAVE  A  PROGRAM  IN  YOUR","   WORK  SPACE  WHEN  LOADING,  THE  FILE  WILL  BE MIXED IN WITH","   YOUR WORK SPACE IN A VERY UNPLEASANT WAY.","","6) YOU  NOW  HAVE  THE  COMPILED  PROGRAM  IN  YOUR  WORK  SPACE.","   AT  THIS  TIME  YOU  MAY  RUN IT, LIST IT, NAME IT OR SAVE IT.","   NOTE:  AFTER  THE  PROGRAM  HAS  BEEN  COMPILED,  IT  IS  VERY"
"   IMPORTANT   THAT   YOU   DO   NOT  RENUMBER  IT  IN  ANY  WAY,","   SHAPE  OR  FORM.  THIS  WILL  CANCEL  OUT  THE   TRACING   AND","   AN  ATTEMPT  TO  'RUN'  IT  WILL  RESULT IN TOTALLY INACCURATE","   TRACING.","","IMPORTANT!","     BEFORE YOU COMPILE YOUR PROGRAM, BE SURE THAT THERE  ARE  NO","CONSECUTIVE LINES. NO TWO LINES MUST BE RIGHT NEXT TO EACH OTHER,","NUMERICALLY. FOR EXAMPLE, THE FOLLOWING IS DISALLOWED:","","   10 REM BILL PEAVEY IS FAT!","   11 REM BILL PEAVEY IS VERY FAT!","   20 END",""
"THIS WILL NOT COMPILE PROPERLY BECAUSE LINE 10 IS RIGHT  NEXT  TO","LINE 11 NUMERICALLY. IN ANY PROGRAM, THERE MUST NOT  BE  ANY  IN-","STANCE  OF  NUMBERING BY ONE. EVEN JUST ONE LINE IN A  1000  LINE","PROGRAM WILL  THROW THE  TRACING  OFF.  IT  IS  A  GOOD  IDEA  TO","'REN'UMBER  YOUR  PROGRAM  BEFORE  COMPILING  IT.THIS  WILL AUTO-","MATICALLY REARRANGE THE NUMERICS OF YOUR PROGRAM TO MEET THE  RE-","QUIREMENTS  OF  THIS  PROGRAM.",""
