Home » Archimedes archive » Archimedes World » AW-1993-09.adf » AWSept93 » !AWSept93/Goodies/ThrowBack/!ThrowBack/!Help

!AWSept93/Goodies/ThrowBack/!ThrowBack/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Archimedes World » AW-1993-09.adf » AWSept93
Filename: !AWSept93/Goodies/ThrowBack/!ThrowBack/!Help
Read OK:
File size: 33A5 bytes
Load address: 0000
Exec address: 0000
File contents
--------------------------------------
Application : !Throwback  1.1
Author      : � Joe Taylor April 1993
Purpose     : BASIC Error throwback

              RISCOS 3 only

--------------------------------------

----------------
0. INTRODUCTION
----------------

   !Throwback is an application which enables error-throwback for BASIC
   programs.

   I.e. when an error occurs in BASIC a window opens on the desktop
   containing the appropriate error information. Clicking on this window
   causes an editor text window to open up with the cursor placed at
   the appropriate faulty line.

   'C' programmers will already be used to this facility which is part
   of Acorn's Desktop Development Environment (DDE).

   !Throwback has two modes of operation:

   (a) (The 'clean' method)
   
       IF your editor is capable of handling BASIC programs AND 'C'-type
       throwback then !Throwback will use this in preference. (Note that this
       requires a copy of Acorn's DDEUtils module)

   (b) ('Simulated' throwback)

       Even if you don't own such facilities never fear we can still produce
       error throwback by simulation.

       This works perfectly happily with the text editor !Edit in the built-
       in Resource filing system for example and !Throwback will use this
       editor and method as a last resort.
       

    !Throwback has been written to support the writing of BASIC programs,
    without line numbers, using a desktop text editor.Here is a summary of
    !Throwback's use with some well-known text editors

            Editor        'C'-throwback     Simulation     line-numbers
            ������        �������������     ����������     ������������
            !Edit              �                �             normal
            !DeskEdit          ��               �             normal
            !StrongEd          �                �             logical
            !Zap               �                �             logical

        � N.B.'C'-type throwback for !DeskEdit requires that the text window
          is already open on the desktop otherwise the file is not de-tokenised.

    
     Snag 1 :  In BASIC the line number reported when an error occurs
     ------    (given by the value of the BASIC keyword ERL) is the line-number
               used by the BASIC command-line and is not necessarily the same
               as the "logical" line number.For example the program

                        10 x=1
                        20 PRINT x/0
                        30 END

               has a "division-by-zero "  error at BASIC line 20 but "logical"
               line 2.

              Each editor has a different default when you save a program
              from its text window  without line-numbers.

              !Throwback assumes that lines are numbered "normally" i.e
               starting with line 10 and then in increments of 10. This
               corresponds to !Edit's default

               Technical note
               ��������������
               To switch !Throwback to assuming that lines are numbered
               'logically' set the system variable, Basic$Options to the
               value 'l' i.e

                           *Set Basic$Options "l"

               If this system varaiable contains no 'l' then !Throwback
               defaults to 'normal' line numbering.
              
                

--------------
1. SETTING UP
--------------

   Simply double-click the application !Throwback in the usual way.

   This only needs to be done once before each error-throwback session begins.

         ********************************************************************
         *                                                                  *
         *                              SUGGESTION                          *
         *                              ----------                          *
         *                                                                  *
         *                                                                  *
         *     Add a line to your !Boot file                                *
         *                                                                  *
         *            *Filer_Run <PathName>.!Throwback                      *
         *                                                                  *
         *     where <Pathname> is the directory in which you have stored   *
         *     !Throwback on your disc containing the !Boot file.           *
         *                                                                  *
         *                                                                  *
         ********************************************************************

-------------------------------------------------
2. ORGANISING THROWBACK FOR SIMPLE BASIC PROGRAMS
-------------------------------------------------

   A "simple" BASIC program is one which is non-multitasking. (E.g. those
   programs which are run by double-clicking their icon in a Filer window. For
   multi-tasking see below.)

   In BASIC the programmer has to "trap" and deal with errors by using the
   "ON ERROR" command; see the "BASIC PROGRAMMING MANUAL"

   To use the error throwback facilities of !Throwback make the first line
   of your program

               ON ERROR CHAIN "Edit:Throwback"
  
   or even better (if you understand procedures) make your program of the form

               ON ERROR PROCError
               <Your program lines here>
               END
               :
               DEF PROCError
               ON ERROR OFF
               CHAIN "Edit:Throwback"
               ENDPROC

    N.B.  When an error is comitted in BASIC the control is passed to the
    ===   statements following the most recently executed "ON ERROR" command.

          Thus in the second example above the procedure "PROCError" would
          be obeyed on the first occurrence of an error. The first command in
          this procedure turns the error handler off. THIS IS A VERY WISE
          MOVE!!!!!!!!! IF AN ERROR OCCURS IN PROCError AND THE ERROR HANDLER
          IS NOT TURNED OFF THE PROCEDURE WOULD CALL ITSELF AD INFINITUM. THE
          ONLY WAY OUT WILL BE TO REBOOT THE MACHINE SO RESULTING IN A LOSS
          OF DATA - BE WARNED!!!!!!! (Such an error occurs in the above
          example if you haven't run !Throwback and the program "Edit:Throwback"
          cannot be found, or if you mis-type its name, etc.)


------------------------
3. THE THROWBACK WINDOW
------------------------

    If "!Throwback" is used in the manner described in �2 , when an error
    occurs in a program, a window opens on the desktop of the form:
                 _______________________________________
                 | � | � |    Error in Basic Program   |
                 ���������������������������������������
                 |                                     |
                 |  ���Error at line #���������������� |
                 |  |                                | |
                 |  |       <Error message>          | |
                 |  |                                | |
                 |  ���������������������������������� |
                 |  ���line numbers����                |
                 |  |                 |                |
                 |  | �normal         |    ���������   |
                 |  |         �redo   |   |Throwback|  |
                 |  | �logical        |    ���������   |
                 |  |                 |                |
                 |  �������������������                |
                 |_____________________________________|

    (N.B. The throwback window stays open on the desktop untl you
    close it - by clicking on its "close" icon.)

    Clicking on the button marked "Throwback" will open a window on the program
    file (if none was already open) and the line containing the error will be
    highlighted and the cursor placed at the beginning of the line ready for
    editing.


    PROBLEMS
    ��������
    
    1. Throwback to WRONG program file.
    �����������������������������������
    
       (a) For "simple" BASIC programs this is unlikely to happen.

       In this case the file used for throwback is taken from the value of
       the system variable Basic$File which was set to the pathname
       of the BASIC program file when its icon was double-clicked.

       ( Note for the technically minded:   
         �������������������������������
         When !Throwback is Run the so-called "Run alias" for BASIC files
         [the system variable "Alias$@RunType_FFB"] is changed to include the
         command
                      *Set Basic$File %0

         which sets the value to the file double-clicked. This means that
         for simple programs the user can ignore the setting of this variable.)

        (b) LIBRARIES
            ���������
            Libraries of BASIC procedures are loaded by using the command

                           LIBRARY "<file>"

            from within your program. Any procedure in this library can
            be used in your program. If an error occurs in one of the
            library procedures !Throwback still works provided that the
            first line of the program contains the correct pathname of
            the library. I.e. the library has the form

                         REM > <file>
                         ...
                         ...
                         
                         library procedure definitions
                         
                         ...
                         ...

            

             The use of pseudo-filing system variables is helpful here.


         (c)�Multi-tasking Applications
             �������������������������

             The value of Basic$File is set to the pathname of the last
             BASIC program which was *Run. For multi-tasking programs this
             might not be the program in which the error occurs.

             Standard applications contain a !Run file (of type "Obey")
             which in turn call the BASIC file "!RunImage".

             Writers of multi-tasking programs will be know that when a *Obey
             file is run the system variable Obey$Dir is set to its path. It
             is quite common to store the value of this variable at run time.
             Basic$File is playing the same role for BASIC files as
             Obey$Dir does for Obey files.

             In the !Run file of an application, called !Fred, place a line
             
                        *Set Fred$BasicFile <Obey$Dir>.!RunImage

             which stores the value at run time. Have a PROCError procedure
             as above except include a line which sets the value of
             Edit$BasicFile. E.g.

                         DEF PROCError
                         ON ERROR OFF
                         *Set Basic$File <Fred$BasicFile>
                         CHAIN "Edit:Throwback"
                         ENDPROC

        (d) Programs which are CHAINED
            ��������������������������

            In this case the value of Basic$File has to be set by the
            programmer as in (c).


        (e) DRAGGING
            ��������

            IF a BASIC program or a "standard" application (i.e. with a BASIC
            !RunImage file) is dragged onto the throwback window the pathname
            of the file to throw back to changes appropriately.

            If you need to do this it is because you haven't been observing
            the "rules" in (a)-(d) above!


       2. Throwback to the wrong line (but the correct file)
       �����������������������������������������������������

          As a first resort try toggling between "normal" and "logical" line
          numbers. This will probably "cure" your problems.

          (Remember that !Throwback assumes line numbers in increments of 10.
           If, for example, your program actually has logical line numbers
           then an error on line 4 would be shown as "error at line 0.4". The
           remedy in this case is simple - choose logical line numbers.)

          If the line numbers are neither logical nor normal the program has
          to be renumbered. This can be done by clicking on the "redo" button
          on the throwback window. (Alternatively,Enter the BASIC command line,
          loading the program and giving the command RENUMBER followed by a
          SAVE.
           
       
        SUMMARY
        =======

        !Throwback is in effect controlled by two system variables:

        Basic$File  =  pathname of file containing error
        
        Basic$Options  If contains "l" then logical line numbers
                           otherwise normal.
                           If contains "+" the usual error messages will
                           be given before the throwback window is opened.

        Library path names are contained in their first line (as specified
        in BASIC programming manual)
        

             
            
         

        

       

    

   

               
   
00000000  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00000010  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000020  2d 2d 2d 2d 2d 2d 2d 0a  41 70 70 6c 69 63 61 74  |-------.Applicat|
00000030  69 6f 6e 20 3a 20 21 54  68 72 6f 77 62 61 63 6b  |ion : !Throwback|
00000040  20 20 31 2e 31 0a 41 75  74 68 6f 72 20 20 20 20  |  1.1.Author    |
00000050  20 20 3a 20 a9 20 4a 6f  65 20 54 61 79 6c 6f 72  |  : . Joe Taylor|
00000060  20 41 70 72 69 6c 20 31  39 39 33 0a 50 75 72 70  | April 1993.Purp|
00000070  6f 73 65 20 20 20 20 20  3a 20 42 41 53 49 43 20  |ose     : BASIC |
00000080  45 72 72 6f 72 20 74 68  72 6f 77 62 61 63 6b 0a  |Error throwback.|
00000090  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 52  |.              R|
000000a0  49 53 43 4f 53 20 33 20  6f 6e 6c 79 0a 0a 2d 2d  |ISCOS 3 only..--|
000000b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000000d0  2d 2d 2d 2d 0a 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----..----------|
000000e0  2d 2d 2d 2d 2d 2d 0a 30  2e 20 49 4e 54 52 4f 44  |------.0. INTROD|
000000f0  55 43 54 49 4f 4e 0a 2d  2d 2d 2d 2d 2d 2d 2d 2d  |UCTION.---------|
00000100  2d 2d 2d 2d 2d 2d 2d 0a  0a 20 20 20 21 54 68 72  |-------..   !Thr|
00000110  6f 77 62 61 63 6b 20 69  73 20 61 6e 20 61 70 70  |owback is an app|
00000120  6c 69 63 61 74 69 6f 6e  20 77 68 69 63 68 20 65  |lication which e|
00000130  6e 61 62 6c 65 73 20 65  72 72 6f 72 2d 74 68 72  |nables error-thr|
00000140  6f 77 62 61 63 6b 20 66  6f 72 20 42 41 53 49 43  |owback for BASIC|
00000150  0a 20 20 20 70 72 6f 67  72 61 6d 73 2e 0a 0a 20  |.   programs... |
00000160  20 20 49 2e 65 2e 20 77  68 65 6e 20 61 6e 20 65  |  I.e. when an e|
00000170  72 72 6f 72 20 6f 63 63  75 72 73 20 69 6e 20 42  |rror occurs in B|
00000180  41 53 49 43 20 61 20 77  69 6e 64 6f 77 20 6f 70  |ASIC a window op|
00000190  65 6e 73 20 6f 6e 20 74  68 65 20 64 65 73 6b 74  |ens on the deskt|
000001a0  6f 70 0a 20 20 20 63 6f  6e 74 61 69 6e 69 6e 67  |op.   containing|
000001b0  20 74 68 65 20 61 70 70  72 6f 70 72 69 61 74 65  | the appropriate|
000001c0  20 65 72 72 6f 72 20 69  6e 66 6f 72 6d 61 74 69  | error informati|
000001d0  6f 6e 2e 20 43 6c 69 63  6b 69 6e 67 20 6f 6e 20  |on. Clicking on |
000001e0  74 68 69 73 20 77 69 6e  64 6f 77 0a 20 20 20 63  |this window.   c|
000001f0  61 75 73 65 73 20 61 6e  20 65 64 69 74 6f 72 20  |auses an editor |
00000200  74 65 78 74 20 77 69 6e  64 6f 77 20 74 6f 20 6f  |text window to o|
00000210  70 65 6e 20 75 70 20 77  69 74 68 20 74 68 65 20  |pen up with the |
00000220  63 75 72 73 6f 72 20 70  6c 61 63 65 64 20 61 74  |cursor placed at|
00000230  0a 20 20 20 74 68 65 20  61 70 70 72 6f 70 72 69  |.   the appropri|
00000240  61 74 65 20 66 61 75 6c  74 79 20 6c 69 6e 65 2e  |ate faulty line.|
00000250  0a 0a 20 20 20 27 43 27  20 70 72 6f 67 72 61 6d  |..   'C' program|
00000260  6d 65 72 73 20 77 69 6c  6c 20 61 6c 72 65 61 64  |mers will alread|
00000270  79 20 62 65 20 75 73 65  64 20 74 6f 20 74 68 69  |y be used to thi|
00000280  73 20 66 61 63 69 6c 69  74 79 20 77 68 69 63 68  |s facility which|
00000290  20 69 73 20 70 61 72 74  0a 20 20 20 6f 66 20 41  | is part.   of A|
000002a0  63 6f 72 6e 27 73 20 44  65 73 6b 74 6f 70 20 44  |corn's Desktop D|
000002b0  65 76 65 6c 6f 70 6d 65  6e 74 20 45 6e 76 69 72  |evelopment Envir|
000002c0  6f 6e 6d 65 6e 74 20 28  44 44 45 29 2e 0a 0a 20  |onment (DDE)... |
000002d0  20 20 21 54 68 72 6f 77  62 61 63 6b 20 68 61 73  |  !Throwback has|
000002e0  20 74 77 6f 20 6d 6f 64  65 73 20 6f 66 20 6f 70  | two modes of op|
000002f0  65 72 61 74 69 6f 6e 3a  0a 0a 20 20 20 28 61 29  |eration:..   (a)|
00000300  20 28 54 68 65 20 27 63  6c 65 61 6e 27 20 6d 65  | (The 'clean' me|
00000310  74 68 6f 64 29 0a 20 20  20 0a 20 20 20 20 20 20  |thod).   .      |
00000320  20 49 46 20 79 6f 75 72  20 65 64 69 74 6f 72 20  | IF your editor |
00000330  69 73 20 63 61 70 61 62  6c 65 20 6f 66 20 68 61  |is capable of ha|
00000340  6e 64 6c 69 6e 67 20 42  41 53 49 43 20 70 72 6f  |ndling BASIC pro|
00000350  67 72 61 6d 73 20 41 4e  44 20 27 43 27 2d 74 79  |grams AND 'C'-ty|
00000360  70 65 0a 20 20 20 20 20  20 20 74 68 72 6f 77 62  |pe.       throwb|
00000370  61 63 6b 20 74 68 65 6e  20 21 54 68 72 6f 77 62  |ack then !Throwb|
00000380  61 63 6b 20 77 69 6c 6c  20 75 73 65 20 74 68 69  |ack will use thi|
00000390  73 20 69 6e 20 70 72 65  66 65 72 65 6e 63 65 2e  |s in preference.|
000003a0  20 28 4e 6f 74 65 20 74  68 61 74 20 74 68 69 73  | (Note that this|
000003b0  0a 20 20 20 20 20 20 20  72 65 71 75 69 72 65 73  |.       requires|
000003c0  20 61 20 63 6f 70 79 20  6f 66 20 41 63 6f 72 6e  | a copy of Acorn|
000003d0  27 73 20 44 44 45 55 74  69 6c 73 20 6d 6f 64 75  |'s DDEUtils modu|
000003e0  6c 65 29 0a 0a 20 20 20  28 62 29 20 28 27 53 69  |le)..   (b) ('Si|
000003f0  6d 75 6c 61 74 65 64 27  20 74 68 72 6f 77 62 61  |mulated' throwba|
00000400  63 6b 29 0a 0a 20 20 20  20 20 20 20 45 76 65 6e  |ck)..       Even|
00000410  20 69 66 20 79 6f 75 20  64 6f 6e 27 74 20 6f 77  | if you don't ow|
00000420  6e 20 73 75 63 68 20 66  61 63 69 6c 69 74 69 65  |n such facilitie|
00000430  73 20 6e 65 76 65 72 20  66 65 61 72 20 77 65 20  |s never fear we |
00000440  63 61 6e 20 73 74 69 6c  6c 20 70 72 6f 64 75 63  |can still produc|
00000450  65 0a 20 20 20 20 20 20  20 65 72 72 6f 72 20 74  |e.       error t|
00000460  68 72 6f 77 62 61 63 6b  20 62 79 20 73 69 6d 75  |hrowback by simu|
00000470  6c 61 74 69 6f 6e 2e 0a  0a 20 20 20 20 20 20 20  |lation...       |
00000480  54 68 69 73 20 77 6f 72  6b 73 20 70 65 72 66 65  |This works perfe|
00000490  63 74 6c 79 20 68 61 70  70 69 6c 79 20 77 69 74  |ctly happily wit|
000004a0  68 20 74 68 65 20 74 65  78 74 20 65 64 69 74 6f  |h the text edito|
000004b0  72 20 21 45 64 69 74 20  69 6e 20 74 68 65 20 62  |r !Edit in the b|
000004c0  75 69 6c 74 2d 0a 20 20  20 20 20 20 20 69 6e 20  |uilt-.       in |
000004d0  52 65 73 6f 75 72 63 65  20 66 69 6c 69 6e 67 20  |Resource filing |
000004e0  73 79 73 74 65 6d 20 66  6f 72 20 65 78 61 6d 70  |system for examp|
000004f0  6c 65 20 61 6e 64 20 21  54 68 72 6f 77 62 61 63  |le and !Throwbac|
00000500  6b 20 77 69 6c 6c 20 75  73 65 20 74 68 69 73 0a  |k will use this.|
00000510  20 20 20 20 20 20 20 65  64 69 74 6f 72 20 61 6e  |       editor an|
00000520  64 20 6d 65 74 68 6f 64  20 61 73 20 61 20 6c 61  |d method as a la|
00000530  73 74 20 72 65 73 6f 72  74 2e 0a 20 20 20 20 20  |st resort..     |
00000540  20 20 0a 0a 20 20 20 20  21 54 68 72 6f 77 62 61  |  ..    !Throwba|
00000550  63 6b 20 68 61 73 20 62  65 65 6e 20 77 72 69 74  |ck has been writ|
00000560  74 65 6e 20 74 6f 20 73  75 70 70 6f 72 74 20 74  |ten to support t|
00000570  68 65 20 77 72 69 74 69  6e 67 20 6f 66 20 42 41  |he writing of BA|
00000580  53 49 43 20 70 72 6f 67  72 61 6d 73 2c 0a 20 20  |SIC programs,.  |
00000590  20 20 77 69 74 68 6f 75  74 20 6c 69 6e 65 20 6e  |  without line n|
000005a0  75 6d 62 65 72 73 2c 20  75 73 69 6e 67 20 61 20  |umbers, using a |
000005b0  64 65 73 6b 74 6f 70 20  74 65 78 74 20 65 64 69  |desktop text edi|
000005c0  74 6f 72 2e 48 65 72 65  20 69 73 20 61 20 73 75  |tor.Here is a su|
000005d0  6d 6d 61 72 79 20 6f 66  0a 20 20 20 20 21 54 68  |mmary of.    !Th|
000005e0  72 6f 77 62 61 63 6b 27  73 20 75 73 65 20 77 69  |rowback's use wi|
000005f0  74 68 20 73 6f 6d 65 20  77 65 6c 6c 2d 6b 6e 6f  |th some well-kno|
00000600  77 6e 20 74 65 78 74 20  65 64 69 74 6f 72 73 0a  |wn text editors.|
00000610  0a 20 20 20 20 20 20 20  20 20 20 20 20 45 64 69  |.            Edi|
00000620  74 6f 72 20 20 20 20 20  20 20 20 27 43 27 2d 74  |tor        'C'-t|
00000630  68 72 6f 77 62 61 63 6b  20 20 20 20 20 53 69 6d  |hrowback     Sim|
00000640  75 6c 61 74 69 6f 6e 20  20 20 20 20 6c 69 6e 65  |ulation     line|
00000650  2d 6e 75 6d 62 65 72 73  0a 20 20 20 20 20 20 20  |-numbers.       |
00000660  20 20 20 20 20 98 98 98  98 98 98 20 20 20 20 20  |     ......     |
00000670  20 20 20 98 98 98 98 98  98 98 98 98 98 98 98 98  |   .............|
00000680  20 20 20 20 20 98 98 98  98 98 98 98 98 98 98 20  |     .......... |
00000690  20 20 20 20 98 98 98 98  98 98 98 98 98 98 98 98  |    ............|
000006a0  0a 20 20 20 20 20 20 20  20 20 20 20 20 21 45 64  |.            !Ed|
000006b0  69 74 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |it              |
000006c0  84 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000006d0  20 80 20 20 20 20 20 20  20 20 20 20 20 20 20 6e  | .             n|
000006e0  6f 72 6d 61 6c 0a 20 20  20 20 20 20 20 20 20 20  |ormal.          |
000006f0  20 20 21 44 65 73 6b 45  64 69 74 20 20 20 20 20  |  !DeskEdit     |
00000700  20 20 20 20 20 80 9c 20  20 20 20 20 20 20 20 20  |     ..         |
00000710  20 20 20 20 20 20 80 20  20 20 20 20 20 20 20 20  |      .         |
00000720  20 20 20 20 6e 6f 72 6d  61 6c 0a 20 20 20 20 20  |    normal.     |
00000730  20 20 20 20 20 20 20 21  53 74 72 6f 6e 67 45 64  |       !StrongEd|
00000740  20 20 20 20 20 20 20 20  20 20 80 20 20 20 20 20  |          .     |
00000750  20 20 20 20 20 20 20 20  20 20 20 80 20 20 20 20  |           .    |
00000760  20 20 20 20 20 20 20 20  20 6c 6f 67 69 63 61 6c  |         logical|
00000770  0a 20 20 20 20 20 20 20  20 20 20 20 20 21 5a 61  |.            !Za|
00000780  70 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |p               |
00000790  80 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000007a0  20 84 20 20 20 20 20 20  20 20 20 20 20 20 20 6c  | .             l|
000007b0  6f 67 69 63 61 6c 0a 0a  20 20 20 20 20 20 20 20  |ogical..        |
000007c0  9c 20 4e 2e 42 2e 27 43  27 2d 74 79 70 65 20 74  |. N.B.'C'-type t|
000007d0  68 72 6f 77 62 61 63 6b  20 66 6f 72 20 21 44 65  |hrowback for !De|
000007e0  73 6b 45 64 69 74 20 72  65 71 75 69 72 65 73 20  |skEdit requires |
000007f0  74 68 61 74 20 74 68 65  20 74 65 78 74 20 77 69  |that the text wi|
00000800  6e 64 6f 77 0a 20 20 20  20 20 20 20 20 20 20 69  |ndow.          i|
00000810  73 20 61 6c 72 65 61 64  79 20 6f 70 65 6e 20 6f  |s already open o|
00000820  6e 20 74 68 65 20 64 65  73 6b 74 6f 70 20 6f 74  |n the desktop ot|
00000830  68 65 72 77 69 73 65 20  74 68 65 20 66 69 6c 65  |herwise the file|
00000840  20 69 73 20 6e 6f 74 20  64 65 2d 74 6f 6b 65 6e  | is not de-token|
00000850  69 73 65 64 2e 0a 0a 20  20 20 20 0a 20 20 20 20  |ised...    .    |
00000860  20 53 6e 61 67 20 31 20  3a 20 20 49 6e 20 42 41  | Snag 1 :  In BA|
00000870  53 49 43 20 74 68 65 20  6c 69 6e 65 20 6e 75 6d  |SIC the line num|
00000880  62 65 72 20 72 65 70 6f  72 74 65 64 20 77 68 65  |ber reported whe|
00000890  6e 20 61 6e 20 65 72 72  6f 72 20 6f 63 63 75 72  |n an error occur|
000008a0  73 0a 20 20 20 20 20 2d  2d 2d 2d 2d 2d 20 20 20  |s.     ------   |
000008b0  20 28 67 69 76 65 6e 20  62 79 20 74 68 65 20 76  | (given by the v|
000008c0  61 6c 75 65 20 6f 66 20  74 68 65 20 42 41 53 49  |alue of the BASI|
000008d0  43 20 6b 65 79 77 6f 72  64 20 45 52 4c 29 20 69  |C keyword ERL) i|
000008e0  73 20 74 68 65 20 6c 69  6e 65 2d 6e 75 6d 62 65  |s the line-numbe|
000008f0  72 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |r.              |
00000900  20 75 73 65 64 20 62 79  20 74 68 65 20 42 41 53  | used by the BAS|
00000910  49 43 20 63 6f 6d 6d 61  6e 64 2d 6c 69 6e 65 20  |IC command-line |
00000920  61 6e 64 20 69 73 20 6e  6f 74 20 6e 65 63 65 73  |and is not neces|
00000930  73 61 72 69 6c 79 20 74  68 65 20 73 61 6d 65 0a  |sarily the same.|
00000940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 61  |               a|
00000950  73 20 74 68 65 20 22 6c  6f 67 69 63 61 6c 22 20  |s the "logical" |
00000960  6c 69 6e 65 20 6e 75 6d  62 65 72 2e 46 6f 72 20  |line number.For |
00000970  65 78 61 6d 70 6c 65 20  74 68 65 20 70 72 6f 67  |example the prog|
00000980  72 61 6d 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |ram..           |
00000990  20 20 20 20 20 20 20 20  20 20 20 20 20 31 30 20  |             10 |
000009a0  78 3d 31 0a 20 20 20 20  20 20 20 20 20 20 20 20  |x=1.            |
000009b0  20 20 20 20 20 20 20 20  20 20 20 20 32 30 20 50  |            20 P|
000009c0  52 49 4e 54 20 78 2f 30  0a 20 20 20 20 20 20 20  |RINT x/0.       |
000009d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000009e0  20 33 30 20 45 4e 44 0a  0a 20 20 20 20 20 20 20  | 30 END..       |
000009f0  20 20 20 20 20 20 20 20  68 61 73 20 61 20 22 64  |        has a "d|
00000a00  69 76 69 73 69 6f 6e 2d  62 79 2d 7a 65 72 6f 20  |ivision-by-zero |
00000a10  22 20 20 65 72 72 6f 72  20 61 74 20 42 41 53 49  |"  error at BASI|
00000a20  43 20 6c 69 6e 65 20 32  30 20 62 75 74 20 22 6c  |C line 20 but "l|
00000a30  6f 67 69 63 61 6c 22 0a  20 20 20 20 20 20 20 20  |ogical".        |
00000a40  20 20 20 20 20 20 20 6c  69 6e 65 20 32 2e 0a 0a  |       line 2...|
00000a50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 45 61  |              Ea|
00000a60  63 68 20 65 64 69 74 6f  72 20 68 61 73 20 61 20  |ch editor has a |
00000a70  64 69 66 66 65 72 65 6e  74 20 64 65 66 61 75 6c  |different defaul|
00000a80  74 20 77 68 65 6e 20 79  6f 75 20 73 61 76 65 20  |t when you save |
00000a90  61 20 70 72 6f 67 72 61  6d 0a 20 20 20 20 20 20  |a program.      |
00000aa0  20 20 20 20 20 20 20 20  66 72 6f 6d 20 69 74 73  |        from its|
00000ab0  20 74 65 78 74 20 77 69  6e 64 6f 77 20 20 77 69  | text window  wi|
00000ac0  74 68 6f 75 74 20 6c 69  6e 65 2d 6e 75 6d 62 65  |thout line-numbe|
00000ad0  72 73 2e 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |rs...           |
00000ae0  20 20 20 21 54 68 72 6f  77 62 61 63 6b 20 61 73  |   !Throwback as|
00000af0  73 75 6d 65 73 20 74 68  61 74 20 6c 69 6e 65 73  |sumes that lines|
00000b00  20 61 72 65 20 6e 75 6d  62 65 72 65 64 20 22 6e  | are numbered "n|
00000b10  6f 72 6d 61 6c 6c 79 22  20 69 2e 65 0a 20 20 20  |ormally" i.e.   |
00000b20  20 20 20 20 20 20 20 20  20 20 20 20 73 74 61 72  |            star|
00000b30  74 69 6e 67 20 77 69 74  68 20 6c 69 6e 65 20 31  |ting with line 1|
00000b40  30 20 61 6e 64 20 74 68  65 6e 20 69 6e 20 69 6e  |0 and then in in|
00000b50  63 72 65 6d 65 6e 74 73  20 6f 66 20 31 30 2e 20  |crements of 10. |
00000b60  54 68 69 73 0a 20 20 20  20 20 20 20 20 20 20 20  |This.           |
00000b70  20 20 20 20 63 6f 72 72  65 73 70 6f 6e 64 73 20  |    corresponds |
00000b80  74 6f 20 21 45 64 69 74  27 73 20 64 65 66 61 75  |to !Edit's defau|
00000b90  6c 74 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |lt..            |
00000ba0  20 20 20 54 65 63 68 6e  69 63 61 6c 20 6e 6f 74  |   Technical not|
00000bb0  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00000bc0  20 98 98 98 98 98 98 98  98 98 98 98 98 98 98 0a  | ...............|
00000bd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 54  |               T|
00000be0  6f 20 73 77 69 74 63 68  20 21 54 68 72 6f 77 62  |o switch !Throwb|
00000bf0  61 63 6b 20 74 6f 20 61  73 73 75 6d 69 6e 67 20  |ack to assuming |
00000c00  74 68 61 74 20 6c 69 6e  65 73 20 61 72 65 20 6e  |that lines are n|
00000c10  75 6d 62 65 72 65 64 0a  20 20 20 20 20 20 20 20  |umbered.        |
00000c20  20 20 20 20 20 20 20 27  6c 6f 67 69 63 61 6c 6c  |       'logicall|
00000c30  79 27 20 73 65 74 20 74  68 65 20 73 79 73 74 65  |y' set the syste|
00000c40  6d 20 76 61 72 69 61 62  6c 65 2c 20 42 61 73 69  |m variable, Basi|
00000c50  63 24 4f 70 74 69 6f 6e  73 20 74 6f 20 74 68 65  |c$Options to the|
00000c60  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000c70  76 61 6c 75 65 20 27 6c  27 20 69 2e 65 0a 0a 20  |value 'l' i.e.. |
00000c80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000c90  20 20 20 20 20 20 20 20  20 20 2a 53 65 74 20 42  |          *Set B|
00000ca0  61 73 69 63 24 4f 70 74  69 6f 6e 73 20 22 6c 22  |asic$Options "l"|
00000cb0  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00000cc0  20 49 66 20 74 68 69 73  20 73 79 73 74 65 6d 20  | If this system |
00000cd0  76 61 72 61 69 61 62 6c  65 20 63 6f 6e 74 61 69  |varaiable contai|
00000ce0  6e 73 20 6e 6f 20 27 6c  27 20 74 68 65 6e 20 21  |ns no 'l' then !|
00000cf0  54 68 72 6f 77 62 61 63  6b 0a 20 20 20 20 20 20  |Throwback.      |
00000d00  20 20 20 20 20 20 20 20  20 64 65 66 61 75 6c 74  |         default|
00000d10  73 20 74 6f 20 27 6e 6f  72 6d 61 6c 27 20 6c 69  |s to 'normal' li|
00000d20  6e 65 20 6e 75 6d 62 65  72 69 6e 67 2e 0a 20 20  |ne numbering..  |
00000d30  20 20 20 20 20 20 20 20  20 20 20 20 0a 20 20 20  |            .   |
00000d40  20 20 20 20 20 20 20 20  20 20 20 20 20 0a 0a 2d  |             ..-|
00000d50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 31 2e  |-------------.1.|
00000d60  20 53 45 54 54 49 4e 47  20 55 50 0a 2d 2d 2d 2d  | SETTING UP.----|
00000d70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 20 20 20 53  |----------..   S|
00000d80  69 6d 70 6c 79 20 64 6f  75 62 6c 65 2d 63 6c 69  |imply double-cli|
00000d90  63 6b 20 74 68 65 20 61  70 70 6c 69 63 61 74 69  |ck the applicati|
00000da0  6f 6e 20 21 54 68 72 6f  77 62 61 63 6b 20 69 6e  |on !Throwback in|
00000db0  20 74 68 65 20 75 73 75  61 6c 20 77 61 79 2e 0a  | the usual way..|
00000dc0  0a 20 20 20 54 68 69 73  20 6f 6e 6c 79 20 6e 65  |.   This only ne|
00000dd0  65 64 73 20 74 6f 20 62  65 20 64 6f 6e 65 20 6f  |eds to be done o|
00000de0  6e 63 65 20 62 65 66 6f  72 65 20 65 61 63 68 20  |nce before each |
00000df0  65 72 72 6f 72 2d 74 68  72 6f 77 62 61 63 6b 20  |error-throwback |
00000e00  73 65 73 73 69 6f 6e 20  62 65 67 69 6e 73 2e 0a  |session begins..|
00000e10  0a 20 20 20 20 20 20 20  20 20 2a 2a 2a 2a 2a 2a  |.         ******|
00000e20  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000e50  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 0a 20  |**************. |
00000e60  20 20 20 20 20 20 20 20  2a 20 20 20 20 20 20 20  |        *       |
00000e70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000ea0  20 20 20 20 20 20 20 20  20 20 20 2a 0a 20 20 20  |           *.   |
00000eb0  20 20 20 20 20 20 2a 20  20 20 20 20 20 20 20 20  |      *         |
00000ec0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000ed0  20 20 20 20 20 53 55 47  47 45 53 54 49 4f 4e 20  |     SUGGESTION |
00000ee0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000ef0  20 20 20 20 20 20 20 20  20 2a 0a 20 20 20 20 20  |         *.     |
00000f00  20 20 20 20 2a 20 20 20  20 20 20 20 20 20 20 20  |    *           |
00000f10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000f20  20 20 20 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 20 20 20  |   ----------   |
00000f30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000f40  20 20 20 20 20 20 20 2a  0a 20 20 20 20 20 20 20  |       *.       |
00000f50  20 20 2a 20 20 20 20 20  20 20 20 20 20 20 20 20  |  *             |
00000f60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000f90  20 20 20 20 20 2a 0a 20  20 20 20 20 20 20 20 20  |     *.         |
00000fa0  2a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |*               |
00000fb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000fe0  20 20 20 2a 0a 20 20 20  20 20 20 20 20 20 2a 20  |   *.         * |
00000ff0  20 20 20 20 41 64 64 20  61 20 6c 69 6e 65 20 74  |    Add a line t|
00001000  6f 20 79 6f 75 72 20 21  42 6f 6f 74 20 66 69 6c  |o your !Boot fil|
00001010  65 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e               |
00001020  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001030  20 2a 0a 20 20 20 20 20  20 20 20 20 2a 20 20 20  | *.         *   |
00001040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00001070  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2a  |               *|
00001080  0a 20 20 20 20 20 20 20  20 20 2a 20 20 20 20 20  |.         *     |
00001090  20 20 20 20 20 20 20 2a  46 69 6c 65 72 5f 52 75  |       *Filer_Ru|
000010a0  6e 20 3c 50 61 74 68 4e  61 6d 65 3e 2e 21 54 68  |n <PathName>.!Th|
000010b0  72 6f 77 62 61 63 6b 20  20 20 20 20 20 20 20 20  |rowback         |
000010c0  20 20 20 20 20 20 20 20  20 20 20 20 20 2a 0a 20  |             *. |
000010d0  20 20 20 20 20 20 20 20  2a 20 20 20 20 20 20 20  |        *       |
000010e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00001110  20 20 20 20 20 20 20 20  20 20 20 2a 0a 20 20 20  |           *.   |
00001120  20 20 20 20 20 20 2a 20  20 20 20 20 77 68 65 72  |      *     wher|
00001130  65 20 3c 50 61 74 68 6e  61 6d 65 3e 20 69 73 20  |e <Pathname> is |
00001140  74 68 65 20 64 69 72 65  63 74 6f 72 79 20 69 6e  |the directory in|
00001150  20 77 68 69 63 68 20 79  6f 75 20 68 61 76 65 20  | which you have |
00001160  73 74 6f 72 65 64 20 20  20 2a 0a 20 20 20 20 20  |stored   *.     |
00001170  20 20 20 20 2a 20 20 20  20 20 21 54 68 72 6f 77  |    *     !Throw|
00001180  62 61 63 6b 20 6f 6e 20  79 6f 75 72 20 64 69 73  |back on your dis|
00001190  63 20 63 6f 6e 74 61 69  6e 69 6e 67 20 74 68 65  |c containing the|
000011a0  20 21 42 6f 6f 74 20 66  69 6c 65 2e 20 20 20 20  | !Boot file.    |
000011b0  20 20 20 20 20 20 20 2a  0a 20 20 20 20 20 20 20  |       *.       |
000011c0  20 20 2a 20 20 20 20 20  20 20 20 20 20 20 20 20  |  *             |
000011d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00001200  20 20 20 20 20 2a 0a 20  20 20 20 20 20 20 20 20  |     *.         |
00001210  2a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |*               |
00001220  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00001250  20 20 20 2a 0a 20 20 20  20 20 20 20 20 20 2a 2a  |   *.         **|
00001260  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000012a0  2a 2a 0a 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |**..------------|
000012b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000012d0  2d 2d 2d 2d 2d 0a 32 2e  20 4f 52 47 41 4e 49 53  |-----.2. ORGANIS|
000012e0  49 4e 47 20 54 48 52 4f  57 42 41 43 4b 20 46 4f  |ING THROWBACK FO|
000012f0  52 20 53 49 4d 50 4c 45  20 42 41 53 49 43 20 50  |R SIMPLE BASIC P|
00001300  52 4f 47 52 41 4d 53 0a  2d 2d 2d 2d 2d 2d 2d 2d  |ROGRAMS.--------|
00001310  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001330  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 0a 20 20 20 41 20  |---------..   A |
00001340  22 73 69 6d 70 6c 65 22  20 42 41 53 49 43 20 70  |"simple" BASIC p|
00001350  72 6f 67 72 61 6d 20 69  73 20 6f 6e 65 20 77 68  |rogram is one wh|
00001360  69 63 68 20 69 73 20 6e  6f 6e 2d 6d 75 6c 74 69  |ich is non-multi|
00001370  74 61 73 6b 69 6e 67 2e  20 28 45 2e 67 2e 20 74  |tasking. (E.g. t|
00001380  68 6f 73 65 0a 20 20 20  70 72 6f 67 72 61 6d 73  |hose.   programs|
00001390  20 77 68 69 63 68 20 61  72 65 20 72 75 6e 20 62  | which are run b|
000013a0  79 20 64 6f 75 62 6c 65  2d 63 6c 69 63 6b 69 6e  |y double-clickin|
000013b0  67 20 74 68 65 69 72 20  69 63 6f 6e 20 69 6e 20  |g their icon in |
000013c0  61 20 46 69 6c 65 72 20  77 69 6e 64 6f 77 2e 20  |a Filer window. |
000013d0  46 6f 72 0a 20 20 20 6d  75 6c 74 69 2d 74 61 73  |For.   multi-tas|
000013e0  6b 69 6e 67 20 73 65 65  20 62 65 6c 6f 77 2e 29  |king see below.)|
000013f0  0a 0a 20 20 20 49 6e 20  42 41 53 49 43 20 74 68  |..   In BASIC th|
00001400  65 20 70 72 6f 67 72 61  6d 6d 65 72 20 68 61 73  |e programmer has|
00001410  20 74 6f 20 22 74 72 61  70 22 20 61 6e 64 20 64  | to "trap" and d|
00001420  65 61 6c 20 77 69 74 68  20 65 72 72 6f 72 73 20  |eal with errors |
00001430  62 79 20 75 73 69 6e 67  20 74 68 65 0a 20 20 20  |by using the.   |
00001440  22 4f 4e 20 45 52 52 4f  52 22 20 63 6f 6d 6d 61  |"ON ERROR" comma|
00001450  6e 64 3b 20 73 65 65 20  74 68 65 20 22 42 41 53  |nd; see the "BAS|
00001460  49 43 20 50 52 4f 47 52  41 4d 4d 49 4e 47 20 4d  |IC PROGRAMMING M|
00001470  41 4e 55 41 4c 22 0a 0a  20 20 20 54 6f 20 75 73  |ANUAL"..   To us|
00001480  65 20 74 68 65 20 65 72  72 6f 72 20 74 68 72 6f  |e the error thro|
00001490  77 62 61 63 6b 20 66 61  63 69 6c 69 74 69 65 73  |wback facilities|
000014a0  20 6f 66 20 21 54 68 72  6f 77 62 61 63 6b 20 6d  | of !Throwback m|
000014b0  61 6b 65 20 74 68 65 20  66 69 72 73 74 20 6c 69  |ake the first li|
000014c0  6e 65 0a 20 20 20 6f 66  20 79 6f 75 72 20 70 72  |ne.   of your pr|
000014d0  6f 67 72 61 6d 0a 0a 20  20 20 20 20 20 20 20 20  |ogram..         |
000014e0  20 20 20 20 20 20 4f 4e  20 45 52 52 4f 52 20 43  |      ON ERROR C|
000014f0  48 41 49 4e 20 22 45 64  69 74 3a 54 68 72 6f 77  |HAIN "Edit:Throw|
00001500  62 61 63 6b 22 0a 20 20  0a 20 20 20 6f 72 20 65  |back".  .   or e|
00001510  76 65 6e 20 62 65 74 74  65 72 20 28 69 66 20 79  |ven better (if y|
00001520  6f 75 20 75 6e 64 65 72  73 74 61 6e 64 20 70 72  |ou understand pr|
00001530  6f 63 65 64 75 72 65 73  29 20 6d 61 6b 65 20 79  |ocedures) make y|
00001540  6f 75 72 20 70 72 6f 67  72 61 6d 20 6f 66 20 74  |our program of t|
00001550  68 65 20 66 6f 72 6d 0a  0a 20 20 20 20 20 20 20  |he form..       |
00001560  20 20 20 20 20 20 20 20  4f 4e 20 45 52 52 4f 52  |        ON ERROR|
00001570  20 50 52 4f 43 45 72 72  6f 72 0a 20 20 20 20 20  | PROCError.     |
00001580  20 20 20 20 20 20 20 20  20 20 3c 59 6f 75 72 20  |          <Your |
00001590  70 72 6f 67 72 61 6d 20  6c 69 6e 65 73 20 68 65  |program lines he|
000015a0  72 65 3e 0a 20 20 20 20  20 20 20 20 20 20 20 20  |re>.            |
000015b0  20 20 20 45 4e 44 0a 20  20 20 20 20 20 20 20 20  |   END.         |
000015c0  20 20 20 20 20 20 3a 0a  20 20 20 20 20 20 20 20  |      :.        |
000015d0  20 20 20 20 20 20 20 44  45 46 20 50 52 4f 43 45  |       DEF PROCE|
000015e0  72 72 6f 72 0a 20 20 20  20 20 20 20 20 20 20 20  |rror.           |
000015f0  20 20 20 20 4f 4e 20 45  52 52 4f 52 20 4f 46 46  |    ON ERROR OFF|
00001600  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001610  43 48 41 49 4e 20 22 45  64 69 74 3a 54 68 72 6f  |CHAIN "Edit:Thro|
00001620  77 62 61 63 6b 22 0a 20  20 20 20 20 20 20 20 20  |wback".         |
00001630  20 20 20 20 20 20 45 4e  44 50 52 4f 43 0a 0a 20  |      ENDPROC.. |
00001640  20 20 20 4e 2e 42 2e 20  20 57 68 65 6e 20 61 6e  |   N.B.  When an|
00001650  20 65 72 72 6f 72 20 69  73 20 63 6f 6d 69 74 74  | error is comitt|
00001660  65 64 20 69 6e 20 42 41  53 49 43 20 74 68 65 20  |ed in BASIC the |
00001670  63 6f 6e 74 72 6f 6c 20  69 73 20 70 61 73 73 65  |control is passe|
00001680  64 20 74 6f 20 74 68 65  0a 20 20 20 20 3d 3d 3d  |d to the.    ===|
00001690  20 20 20 73 74 61 74 65  6d 65 6e 74 73 20 66 6f  |   statements fo|
000016a0  6c 6c 6f 77 69 6e 67 20  74 68 65 20 6d 6f 73 74  |llowing the most|
000016b0  20 72 65 63 65 6e 74 6c  79 20 65 78 65 63 75 74  | recently execut|
000016c0  65 64 20 22 4f 4e 20 45  52 52 4f 52 22 20 63 6f  |ed "ON ERROR" co|
000016d0  6d 6d 61 6e 64 2e 0a 0a  20 20 20 20 20 20 20 20  |mmand...        |
000016e0  20 20 54 68 75 73 20 69  6e 20 74 68 65 20 73 65  |  Thus in the se|
000016f0  63 6f 6e 64 20 65 78 61  6d 70 6c 65 20 61 62 6f  |cond example abo|
00001700  76 65 20 74 68 65 20 70  72 6f 63 65 64 75 72 65  |ve the procedure|
00001710  20 22 50 52 4f 43 45 72  72 6f 72 22 20 77 6f 75  | "PROCError" wou|
00001720  6c 64 0a 20 20 20 20 20  20 20 20 20 20 62 65 20  |ld.          be |
00001730  6f 62 65 79 65 64 20 6f  6e 20 74 68 65 20 66 69  |obeyed on the fi|
00001740  72 73 74 20 6f 63 63 75  72 72 65 6e 63 65 20 6f  |rst occurrence o|
00001750  66 20 61 6e 20 65 72 72  6f 72 2e 20 54 68 65 20  |f an error. The |
00001760  66 69 72 73 74 20 63 6f  6d 6d 61 6e 64 20 69 6e  |first command in|
00001770  0a 20 20 20 20 20 20 20  20 20 20 74 68 69 73 20  |.          this |
00001780  70 72 6f 63 65 64 75 72  65 20 74 75 72 6e 73 20  |procedure turns |
00001790  74 68 65 20 65 72 72 6f  72 20 68 61 6e 64 6c 65  |the error handle|
000017a0  72 20 6f 66 66 2e 20 54  48 49 53 20 49 53 20 41  |r off. THIS IS A|
000017b0  20 56 45 52 59 20 57 49  53 45 0a 20 20 20 20 20  | VERY WISE.     |
000017c0  20 20 20 20 20 4d 4f 56  45 21 21 21 21 21 21 21  |     MOVE!!!!!!!|
000017d0  21 21 20 49 46 20 41 4e  20 45 52 52 4f 52 20 4f  |!! IF AN ERROR O|
000017e0  43 43 55 52 53 20 49 4e  20 50 52 4f 43 45 72 72  |CCURS IN PROCErr|
000017f0  6f 72 20 41 4e 44 20 54  48 45 20 45 52 52 4f 52  |or AND THE ERROR|
00001800  20 48 41 4e 44 4c 45 52  0a 20 20 20 20 20 20 20  | HANDLER.       |
00001810  20 20 20 49 53 20 4e 4f  54 20 54 55 52 4e 45 44  |   IS NOT TURNED|
00001820  20 4f 46 46 20 54 48 45  20 50 52 4f 43 45 44 55  | OFF THE PROCEDU|
00001830  52 45 20 57 4f 55 4c 44  20 43 41 4c 4c 20 49 54  |RE WOULD CALL IT|
00001840  53 45 4c 46 20 41 44 20  49 4e 46 49 4e 49 54 55  |SELF AD INFINITU|
00001850  4d 2e 20 54 48 45 0a 20  20 20 20 20 20 20 20 20  |M. THE.         |
00001860  20 4f 4e 4c 59 20 57 41  59 20 4f 55 54 20 57 49  | ONLY WAY OUT WI|
00001870  4c 4c 20 42 45 20 54 4f  20 52 45 42 4f 4f 54 20  |LL BE TO REBOOT |
00001880  54 48 45 20 4d 41 43 48  49 4e 45 20 53 4f 20 52  |THE MACHINE SO R|
00001890  45 53 55 4c 54 49 4e 47  20 49 4e 20 41 20 4c 4f  |ESULTING IN A LO|
000018a0  53 53 0a 20 20 20 20 20  20 20 20 20 20 4f 46 20  |SS.          OF |
000018b0  44 41 54 41 20 2d 20 42  45 20 57 41 52 4e 45 44  |DATA - BE WARNED|
000018c0  21 21 21 21 21 21 21 20  28 53 75 63 68 20 61 6e  |!!!!!!! (Such an|
000018d0  20 65 72 72 6f 72 20 6f  63 63 75 72 73 20 69 6e  | error occurs in|
000018e0  20 74 68 65 20 61 62 6f  76 65 0a 20 20 20 20 20  | the above.     |
000018f0  20 20 20 20 20 65 78 61  6d 70 6c 65 20 69 66 20  |     example if |
00001900  79 6f 75 20 68 61 76 65  6e 27 74 20 72 75 6e 20  |you haven't run |
00001910  21 54 68 72 6f 77 62 61  63 6b 20 61 6e 64 20 74  |!Throwback and t|
00001920  68 65 20 70 72 6f 67 72  61 6d 20 22 45 64 69 74  |he program "Edit|
00001930  3a 54 68 72 6f 77 62 61  63 6b 22 0a 20 20 20 20  |:Throwback".    |
00001940  20 20 20 20 20 20 63 61  6e 6e 6f 74 20 62 65 20  |      cannot be |
00001950  66 6f 75 6e 64 2c 20 6f  72 20 69 66 20 79 6f 75  |found, or if you|
00001960  20 6d 69 73 2d 74 79 70  65 20 69 74 73 20 6e 61  | mis-type its na|
00001970  6d 65 2c 20 65 74 63 2e  29 0a 0a 0a 2d 2d 2d 2d  |me, etc.)...----|
00001980  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00001990  2d 2d 2d 2d 0a 33 2e 20  54 48 45 20 54 48 52 4f  |----.3. THE THRO|
000019a0  57 42 41 43 4b 20 57 49  4e 44 4f 57 0a 2d 2d 2d  |WBACK WINDOW.---|
000019b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000019c0  2d 2d 2d 2d 2d 0a 0a 20  20 20 20 49 66 20 22 21  |-----..    If "!|
000019d0  54 68 72 6f 77 62 61 63  6b 22 20 69 73 20 75 73  |Throwback" is us|
000019e0  65 64 20 69 6e 20 74 68  65 20 6d 61 6e 6e 65 72  |ed in the manner|
000019f0  20 64 65 73 63 72 69 62  65 64 20 69 6e 20 a7 32  | described in .2|
00001a00  20 2c 20 77 68 65 6e 20  61 6e 20 65 72 72 6f 72  | , when an error|
00001a10  0a 20 20 20 20 6f 63 63  75 72 73 20 69 6e 20 61  |.    occurs in a|
00001a20  20 70 72 6f 67 72 61 6d  2c 20 61 20 77 69 6e 64  | program, a wind|
00001a30  6f 77 20 6f 70 65 6e 73  20 6f 6e 20 74 68 65 20  |ow opens on the |
00001a40  64 65 73 6b 74 6f 70 20  6f 66 20 74 68 65 20 66  |desktop of the f|
00001a50  6f 72 6d 3a 0a 20 20 20  20 20 20 20 20 20 20 20  |orm:.           |
00001a60  20 20 20 20 20 20 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |      __________|
00001a70  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
00001a80  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 0a 20 20  |_____________.  |
00001a90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 7c  |               ||
00001aa0  20 82 20 7c 20 84 20 7c  20 20 20 20 45 72 72 6f  | . | . |    Erro|
00001ab0  72 20 69 6e 20 42 61 73  69 63 20 50 72 6f 67 72  |r in Basic Progr|
00001ac0  61 6d 20 20 20 7c 0a 20  20 20 20 20 20 20 20 20  |am   |.         |
00001ad0  20 20 20 20 20 20 20 20  98 98 98 98 98 98 98 98  |        ........|
00001ae0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00001af0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 0a  |................|
00001b00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001b10  20 7c 20 20 20 20 20 20  20 20 20 20 20 20 20 20  | |              |
00001b20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001b30  20 20 20 20 20 20 20 7c  0a 20 20 20 20 20 20 20  |       |.       |
00001b40  20 20 20 20 20 20 20 20  20 20 7c 20 20 98 98 98  |          |  ...|
00001b50  45 72 72 6f 72 20 61 74  20 6c 69 6e 65 20 23 98  |Error at line #.|
00001b60  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 20  |............... |
00001b70  7c 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  ||.              |
00001b80  20 20 20 7c 20 20 7c 20  20 20 20 20 20 20 20 20  |   |  |         |
00001b90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001ba0  20 20 20 20 20 20 20 7c  20 7c 0a 20 20 20 20 20  |       | |.     |
00001bb0  20 20 20 20 20 20 20 20  20 20 20 20 7c 20 20 7c  |            |  ||
00001bc0  20 20 20 20 20 20 20 3c  45 72 72 6f 72 20 6d 65  |       <Error me|
00001bd0  73 73 61 67 65 3e 20 20  20 20 20 20 20 20 20 20  |ssage>          |
00001be0  7c 20 7c 0a 20 20 20 20  20 20 20 20 20 20 20 20  || |.            |
00001bf0  20 20 20 20 20 7c 20 20  7c 20 20 20 20 20 20 20  |     |  |       |
00001c00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001c10  20 20 20 20 20 20 20 20  20 7c 20 7c 0a 20 20 20  |         | |.   |
00001c20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 7c 20  |              | |
00001c30  20 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  | ...............|
00001c40  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00001c50  98 98 98 20 7c 0a 20 20  20 20 20 20 20 20 20 20  |... |.          |
00001c60  20 20 20 20 20 20 20 7c  20 20 98 98 98 6c 69 6e  |       |  ...lin|
00001c70  65 20 6e 75 6d 62 65 72  73 98 98 98 98 20 20 20  |e numbers....   |
00001c80  20 20 20 20 20 20 20 20  20 20 20 20 20 7c 0a 20  |             |. |
00001c90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001ca0  7c 20 20 7c 20 20 20 20  20 20 20 20 20 20 20 20  ||  |            |
00001cb0  20 20 20 20 20 7c 20 20  20 20 20 20 20 20 20 20  |     |          |
00001cc0  20 20 20 20 20 20 7c 0a  20 20 20 20 20 20 20 20  |      |.        |
00001cd0  20 20 20 20 20 20 20 20  20 7c 20 20 7c 20 8f 6e  |         |  | .n|
00001ce0  6f 72 6d 61 6c 20 20 20  20 20 20 20 20 20 7c 20  |ormal         | |
00001cf0  20 20 20 98 98 98 98 98  98 98 98 98 20 20 20 7c  |   .........   ||
00001d00  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001d10  20 20 7c 20 20 7c 20 20  20 20 20 20 20 20 20 8f  |  |  |         .|
00001d20  72 65 64 6f 20 20 20 7c  20 20 20 7c 54 68 72 6f  |redo   |   |Thro|
00001d30  77 62 61 63 6b 7c 20 20  7c 0a 20 20 20 20 20 20  |wback|  |.      |
00001d40  20 20 20 20 20 20 20 20  20 20 20 7c 20 20 7c 20  |           |  | |
00001d50  8f 6c 6f 67 69 63 61 6c  20 20 20 20 20 20 20 20  |.logical        |
00001d60  7c 20 20 20 20 98 98 98  98 98 98 98 98 98 20 20  ||    .........  |
00001d70  20 7c 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  | |.             |
00001d80  20 20 20 20 7c 20 20 7c  20 20 20 20 20 20 20 20  |    |  |        |
00001d90  20 20 20 20 20 20 20 20  20 7c 20 20 20 20 20 20  |         |      |
00001da0  20 20 20 20 20 20 20 20  20 20 7c 0a 20 20 20 20  |          |.    |
00001db0  20 20 20 20 20 20 20 20  20 20 20 20 20 7c 20 20  |             |  |
00001dc0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00001dd0  98 98 98 20 20 20 20 20  20 20 20 20 20 20 20 20  |...             |
00001de0  20 20 20 7c 0a 20 20 20  20 20 20 20 20 20 20 20  |   |.           |
00001df0  20 20 20 20 20 20 7c 5f  5f 5f 5f 5f 5f 5f 5f 5f  |      |_________|
00001e00  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
00001e10  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 7c 0a 0a 20  |____________|.. |
00001e20  20 20 20 28 4e 2e 42 2e  20 54 68 65 20 74 68 72  |   (N.B. The thr|
00001e30  6f 77 62 61 63 6b 20 77  69 6e 64 6f 77 20 73 74  |owback window st|
00001e40  61 79 73 20 6f 70 65 6e  20 6f 6e 20 74 68 65 20  |ays open on the |
00001e50  64 65 73 6b 74 6f 70 20  75 6e 74 6c 20 79 6f 75  |desktop untl you|
00001e60  0a 20 20 20 20 63 6c 6f  73 65 20 69 74 20 2d 20  |.    close it - |
00001e70  62 79 20 63 6c 69 63 6b  69 6e 67 20 6f 6e 20 69  |by clicking on i|
00001e80  74 73 20 22 63 6c 6f 73  65 22 20 69 63 6f 6e 2e  |ts "close" icon.|
00001e90  29 0a 0a 20 20 20 20 43  6c 69 63 6b 69 6e 67 20  |)..    Clicking |
00001ea0  6f 6e 20 74 68 65 20 62  75 74 74 6f 6e 20 6d 61  |on the button ma|
00001eb0  72 6b 65 64 20 22 54 68  72 6f 77 62 61 63 6b 22  |rked "Throwback"|
00001ec0  20 77 69 6c 6c 20 6f 70  65 6e 20 61 20 77 69 6e  | will open a win|
00001ed0  64 6f 77 20 6f 6e 20 74  68 65 20 70 72 6f 67 72  |dow on the progr|
00001ee0  61 6d 0a 20 20 20 20 66  69 6c 65 20 28 69 66 20  |am.    file (if |
00001ef0  6e 6f 6e 65 20 77 61 73  20 61 6c 72 65 61 64 79  |none was already|
00001f00  20 6f 70 65 6e 29 20 61  6e 64 20 74 68 65 20 6c  | open) and the l|
00001f10  69 6e 65 20 63 6f 6e 74  61 69 6e 69 6e 67 20 74  |ine containing t|
00001f20  68 65 20 65 72 72 6f 72  20 77 69 6c 6c 20 62 65  |he error will be|
00001f30  0a 20 20 20 20 68 69 67  68 6c 69 67 68 74 65 64  |.    highlighted|
00001f40  20 61 6e 64 20 74 68 65  20 63 75 72 73 6f 72 20  | and the cursor |
00001f50  70 6c 61 63 65 64 20 61  74 20 74 68 65 20 62 65  |placed at the be|
00001f60  67 69 6e 6e 69 6e 67 20  6f 66 20 74 68 65 20 6c  |ginning of the l|
00001f70  69 6e 65 20 72 65 61 64  79 20 66 6f 72 0a 20 20  |ine ready for.  |
00001f80  20 20 65 64 69 74 69 6e  67 2e 0a 0a 0a 20 20 20  |  editing....   |
00001f90  20 50 52 4f 42 4c 45 4d  53 0a 20 20 20 20 98 98  | PROBLEMS.    ..|
00001fa0  98 98 98 98 98 98 0a 20  20 20 20 0a 20 20 20 20  |.......    .    |
00001fb0  31 2e 20 54 68 72 6f 77  62 61 63 6b 20 74 6f 20  |1. Throwback to |
00001fc0  57 52 4f 4e 47 20 70 72  6f 67 72 61 6d 20 66 69  |WRONG program fi|
00001fd0  6c 65 2e 0a 20 20 20 20  98 98 98 98 98 98 98 98  |le..    ........|
00001fe0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00001ff0  98 98 98 98 98 98 98 98  98 98 98 0a 20 20 20 20  |............    |
00002000  0a 20 20 20 20 20 20 20  28 61 29 20 46 6f 72 20  |.       (a) For |
00002010  22 73 69 6d 70 6c 65 22  20 42 41 53 49 43 20 70  |"simple" BASIC p|
00002020  72 6f 67 72 61 6d 73 20  74 68 69 73 20 69 73 20  |rograms this is |
00002030  75 6e 6c 69 6b 65 6c 79  20 74 6f 20 68 61 70 70  |unlikely to happ|
00002040  65 6e 2e 0a 0a 20 20 20  20 20 20 20 49 6e 20 74  |en...       In t|
00002050  68 69 73 20 63 61 73 65  20 74 68 65 20 66 69 6c  |his case the fil|
00002060  65 20 75 73 65 64 20 66  6f 72 20 74 68 72 6f 77  |e used for throw|
00002070  62 61 63 6b 20 69 73 20  74 61 6b 65 6e 20 66 72  |back is taken fr|
00002080  6f 6d 20 74 68 65 20 76  61 6c 75 65 20 6f 66 0a  |om the value of.|
00002090  20 20 20 20 20 20 20 74  68 65 20 73 79 73 74 65  |       the syste|
000020a0  6d 20 76 61 72 69 61 62  6c 65 20 42 61 73 69 63  |m variable Basic|
000020b0  24 46 69 6c 65 20 77 68  69 63 68 20 77 61 73 20  |$File which was |
000020c0  73 65 74 20 74 6f 20 74  68 65 20 70 61 74 68 6e  |set to the pathn|
000020d0  61 6d 65 0a 20 20 20 20  20 20 20 6f 66 20 74 68  |ame.       of th|
000020e0  65 20 42 41 53 49 43 20  70 72 6f 67 72 61 6d 20  |e BASIC program |
000020f0  66 69 6c 65 20 77 68 65  6e 20 69 74 73 20 69 63  |file when its ic|
00002100  6f 6e 20 77 61 73 20 64  6f 75 62 6c 65 2d 63 6c  |on was double-cl|
00002110  69 63 6b 65 64 2e 0a 0a  20 20 20 20 20 20 20 28  |icked...       (|
00002120  20 4e 6f 74 65 20 66 6f  72 20 74 68 65 20 74 65  | Note for the te|
00002130  63 68 6e 69 63 61 6c 6c  79 20 6d 69 6e 64 65 64  |chnically minded|
00002140  3a 20 20 20 0a 20 20 20  20 20 20 20 20 20 98 98  |:   .         ..|
00002150  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00002160  98 98 98 98 98 98 98 98  98 98 98 98 98 0a 20 20  |..............  |
00002170  20 20 20 20 20 20 20 57  68 65 6e 20 21 54 68 72  |       When !Thr|
00002180  6f 77 62 61 63 6b 20 69  73 20 52 75 6e 20 74 68  |owback is Run th|
00002190  65 20 73 6f 2d 63 61 6c  6c 65 64 20 22 52 75 6e  |e so-called "Run|
000021a0  20 61 6c 69 61 73 22 20  66 6f 72 20 42 41 53 49  | alias" for BASI|
000021b0  43 20 66 69 6c 65 73 0a  20 20 20 20 20 20 20 20  |C files.        |
000021c0  20 5b 74 68 65 20 73 79  73 74 65 6d 20 76 61 72  | [the system var|
000021d0  69 61 62 6c 65 20 22 41  6c 69 61 73 24 40 52 75  |iable "Alias$@Ru|
000021e0  6e 54 79 70 65 5f 46 46  42 22 5d 20 69 73 20 63  |nType_FFB"] is c|
000021f0  68 61 6e 67 65 64 20 74  6f 20 69 6e 63 6c 75 64  |hanged to includ|
00002200  65 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 63  |e the.         c|
00002210  6f 6d 6d 61 6e 64 0a 20  20 20 20 20 20 20 20 20  |ommand.         |
00002220  20 20 20 20 20 20 20 20  20 20 20 20 20 2a 53 65  |             *Se|
00002230  74 20 42 61 73 69 63 24  46 69 6c 65 20 25 30 0a  |t Basic$File %0.|
00002240  0a 20 20 20 20 20 20 20  20 20 77 68 69 63 68 20  |.         which |
00002250  73 65 74 73 20 74 68 65  20 76 61 6c 75 65 20 74  |sets the value t|
00002260  6f 20 74 68 65 20 66 69  6c 65 20 64 6f 75 62 6c  |o the file doubl|
00002270  65 2d 63 6c 69 63 6b 65  64 2e 20 54 68 69 73 20  |e-clicked. This |
00002280  6d 65 61 6e 73 20 74 68  61 74 0a 20 20 20 20 20  |means that.     |
00002290  20 20 20 20 66 6f 72 20  73 69 6d 70 6c 65 20 70  |    for simple p|
000022a0  72 6f 67 72 61 6d 73 20  74 68 65 20 75 73 65 72  |rograms the user|
000022b0  20 63 61 6e 20 69 67 6e  6f 72 65 20 74 68 65 20  | can ignore the |
000022c0  73 65 74 74 69 6e 67 20  6f 66 20 74 68 69 73 20  |setting of this |
000022d0  76 61 72 69 61 62 6c 65  2e 29 0a 0a 20 20 20 20  |variable.)..    |
000022e0  20 20 20 20 28 62 29 20  4c 49 42 52 41 52 49 45  |    (b) LIBRARIE|
000022f0  53 0a 20 20 20 20 20 20  20 20 20 20 20 20 98 98  |S.            ..|
00002300  98 98 98 98 98 98 98 0a  20 20 20 20 20 20 20 20  |........        |
00002310  20 20 20 20 4c 69 62 72  61 72 69 65 73 20 6f 66  |    Libraries of|
00002320  20 42 41 53 49 43 20 70  72 6f 63 65 64 75 72 65  | BASIC procedure|
00002330  73 20 61 72 65 20 6c 6f  61 64 65 64 20 62 79 20  |s are loaded by |
00002340  75 73 69 6e 67 20 74 68  65 20 63 6f 6d 6d 61 6e  |using the comman|
00002350  64 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |d..             |
00002360  20 20 20 20 20 20 20 20  20 20 20 20 20 20 4c 49  |              LI|
00002370  42 52 41 52 59 20 22 3c  66 69 6c 65 3e 22 0a 0a  |BRARY "<file>"..|
00002380  20 20 20 20 20 20 20 20  20 20 20 20 66 72 6f 6d  |            from|
00002390  20 77 69 74 68 69 6e 20  79 6f 75 72 20 70 72 6f  | within your pro|
000023a0  67 72 61 6d 2e 20 41 6e  79 20 70 72 6f 63 65 64  |gram. Any proced|
000023b0  75 72 65 20 69 6e 20 74  68 69 73 20 6c 69 62 72  |ure in this libr|
000023c0  61 72 79 20 63 61 6e 0a  20 20 20 20 20 20 20 20  |ary can.        |
000023d0  20 20 20 20 62 65 20 75  73 65 64 20 69 6e 20 79  |    be used in y|
000023e0  6f 75 72 20 70 72 6f 67  72 61 6d 2e 20 49 66 20  |our program. If |
000023f0  61 6e 20 65 72 72 6f 72  20 6f 63 63 75 72 73 20  |an error occurs |
00002400  69 6e 20 6f 6e 65 20 6f  66 20 74 68 65 0a 20 20  |in one of the.  |
00002410  20 20 20 20 20 20 20 20  20 20 6c 69 62 72 61 72  |          librar|
00002420  79 20 70 72 6f 63 65 64  75 72 65 73 20 21 54 68  |y procedures !Th|
00002430  72 6f 77 62 61 63 6b 20  73 74 69 6c 6c 20 77 6f  |rowback still wo|
00002440  72 6b 73 20 70 72 6f 76  69 64 65 64 20 74 68 61  |rks provided tha|
00002450  74 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |t the.          |
00002460  20 20 66 69 72 73 74 20  6c 69 6e 65 20 6f 66 20  |  first line of |
00002470  74 68 65 20 70 72 6f 67  72 61 6d 20 63 6f 6e 74  |the program cont|
00002480  61 69 6e 73 20 74 68 65  20 63 6f 72 72 65 63 74  |ains the correct|
00002490  20 70 61 74 68 6e 61 6d  65 20 6f 66 0a 20 20 20  | pathname of.   |
000024a0  20 20 20 20 20 20 20 20  20 74 68 65 20 6c 69 62  |         the lib|
000024b0  72 61 72 79 2e 20 49 2e  65 2e 20 74 68 65 20 6c  |rary. I.e. the l|
000024c0  69 62 72 61 72 79 20 68  61 73 20 74 68 65 20 66  |ibrary has the f|
000024d0  6f 72 6d 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |orm..           |
000024e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 52 45  |              RE|
000024f0  4d 20 3e 20 3c 66 69 6c  65 3e 0a 20 20 20 20 20  |M > <file>.     |
00002500  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002510  20 20 20 20 2e 2e 2e 0a  20 20 20 20 20 20 20 20  |    ....        |
00002520  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002530  20 2e 2e 2e 0a 20 20 20  20 20 20 20 20 20 20 20  | ....           |
00002540  20 20 20 20 20 20 20 20  20 20 20 20 20 20 0a 20  |              . |
00002550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002560  20 20 20 20 20 20 20 20  6c 69 62 72 61 72 79 20  |        library |
00002570  70 72 6f 63 65 64 75 72  65 20 64 65 66 69 6e 69  |procedure defini|
00002580  74 69 6f 6e 73 0a 20 20  20 20 20 20 20 20 20 20  |tions.          |
00002590  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
000025a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000025b0  20 20 20 20 20 20 20 20  20 2e 2e 2e 0a 20 20 20  |         ....   |
000025c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000025d0  20 20 20 20 20 20 2e 2e  2e 0a 0a 20 20 20 20 20  |      .....     |
000025e0  20 20 20 20 20 20 20 0a  0a 20 20 20 20 20 20 20  |       ..       |
000025f0  20 20 20 20 20 20 54 68  65 20 75 73 65 20 6f 66  |      The use of|
00002600  20 70 73 65 75 64 6f 2d  66 69 6c 69 6e 67 20 73  | pseudo-filing s|
00002610  79 73 74 65 6d 20 76 61  72 69 61 62 6c 65 73 20  |ystem variables |
00002620  69 73 20 68 65 6c 70 66  75 6c 20 68 65 72 65 2e  |is helpful here.|
00002630  0a 0a 0a 20 20 20 20 20  20 20 20 20 28 63 29 a0  |...         (c).|
00002640  4d 75 6c 74 69 2d 74 61  73 6b 69 6e 67 20 41 70  |Multi-tasking Ap|
00002650  70 6c 69 63 61 74 69 6f  6e 73 0a 20 20 20 20 20  |plications.     |
00002660  20 20 20 20 20 20 20 20  98 98 98 98 98 98 98 98  |        ........|
00002670  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
00002680  98 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |...             |
00002690  54 68 65 20 76 61 6c 75  65 20 6f 66 20 42 61 73  |The value of Bas|
000026a0  69 63 24 46 69 6c 65 20  69 73 20 73 65 74 20 74  |ic$File is set t|
000026b0  6f 20 74 68 65 20 70 61  74 68 6e 61 6d 65 20 6f  |o the pathname o|
000026c0  66 20 74 68 65 20 6c 61  73 74 0a 20 20 20 20 20  |f the last.     |
000026d0  20 20 20 20 20 20 20 20  42 41 53 49 43 20 70 72  |        BASIC pr|
000026e0  6f 67 72 61 6d 20 77 68  69 63 68 20 77 61 73 20  |ogram which was |
000026f0  2a 52 75 6e 2e 20 46 6f  72 20 6d 75 6c 74 69 2d  |*Run. For multi-|
00002700  74 61 73 6b 69 6e 67 20  70 72 6f 67 72 61 6d 73  |tasking programs|
00002710  20 74 68 69 73 0a 20 20  20 20 20 20 20 20 20 20  | this.          |
00002720  20 20 20 6d 69 67 68 74  20 6e 6f 74 20 62 65 20  |   might not be |
00002730  74 68 65 20 70 72 6f 67  72 61 6d 20 69 6e 20 77  |the program in w|
00002740  68 69 63 68 20 74 68 65  20 65 72 72 6f 72 20 6f  |hich the error o|
00002750  63 63 75 72 73 2e 0a 0a  20 20 20 20 20 20 20 20  |ccurs...        |
00002760  20 20 20 20 20 53 74 61  6e 64 61 72 64 20 61 70  |     Standard ap|
00002770  70 6c 69 63 61 74 69 6f  6e 73 20 63 6f 6e 74 61  |plications conta|
00002780  69 6e 20 61 20 21 52 75  6e 20 66 69 6c 65 20 28  |in a !Run file (|
00002790  6f 66 20 74 79 70 65 20  22 4f 62 65 79 22 29 0a  |of type "Obey").|
000027a0  20 20 20 20 20 20 20 20  20 20 20 20 20 77 68 69  |             whi|
000027b0  63 68 20 69 6e 20 74 75  72 6e 20 63 61 6c 6c 20  |ch in turn call |
000027c0  74 68 65 20 42 41 53 49  43 20 66 69 6c 65 20 22  |the BASIC file "|
000027d0  21 52 75 6e 49 6d 61 67  65 22 2e 0a 0a 20 20 20  |!RunImage"...   |
000027e0  20 20 20 20 20 20 20 20  20 20 57 72 69 74 65 72  |          Writer|
000027f0  73 20 6f 66 20 6d 75 6c  74 69 2d 74 61 73 6b 69  |s of multi-taski|
00002800  6e 67 20 70 72 6f 67 72  61 6d 73 20 77 69 6c 6c  |ng programs will|
00002810  20 62 65 20 6b 6e 6f 77  20 74 68 61 74 20 77 68  | be know that wh|
00002820  65 6e 20 61 20 2a 4f 62  65 79 0a 20 20 20 20 20  |en a *Obey.     |
00002830  20 20 20 20 20 20 20 20  66 69 6c 65 20 69 73 20  |        file is |
00002840  72 75 6e 20 74 68 65 20  73 79 73 74 65 6d 20 76  |run the system v|
00002850  61 72 69 61 62 6c 65 20  4f 62 65 79 24 44 69 72  |ariable Obey$Dir|
00002860  20 69 73 20 73 65 74 20  74 6f 20 69 74 73 20 70  | is set to its p|
00002870  61 74 68 2e 20 49 74 0a  20 20 20 20 20 20 20 20  |ath. It.        |
00002880  20 20 20 20 20 69 73 20  71 75 69 74 65 20 63 6f  |     is quite co|
00002890  6d 6d 6f 6e 20 74 6f 20  73 74 6f 72 65 20 74 68  |mmon to store th|
000028a0  65 20 76 61 6c 75 65 20  6f 66 20 74 68 69 73 20  |e value of this |
000028b0  76 61 72 69 61 62 6c 65  20 61 74 20 72 75 6e 20  |variable at run |
000028c0  74 69 6d 65 2e 0a 20 20  20 20 20 20 20 20 20 20  |time..          |
000028d0  20 20 20 42 61 73 69 63  24 46 69 6c 65 20 69 73  |   Basic$File is|
000028e0  20 70 6c 61 79 69 6e 67  20 74 68 65 20 73 61 6d  | playing the sam|
000028f0  65 20 72 6f 6c 65 20 66  6f 72 20 42 41 53 49 43  |e role for BASIC|
00002900  20 66 69 6c 65 73 20 61  73 0a 20 20 20 20 20 20  | files as.      |
00002910  20 20 20 20 20 20 20 4f  62 65 79 24 44 69 72 20  |       Obey$Dir |
00002920  64 6f 65 73 20 66 6f 72  20 4f 62 65 79 20 66 69  |does for Obey fi|
00002930  6c 65 73 2e 0a 0a 20 20  20 20 20 20 20 20 20 20  |les...          |
00002940  20 20 20 49 6e 20 74 68  65 20 21 52 75 6e 20 66  |   In the !Run f|
00002950  69 6c 65 20 6f 66 20 61  6e 20 61 70 70 6c 69 63  |ile of an applic|
00002960  61 74 69 6f 6e 2c 20 63  61 6c 6c 65 64 20 21 46  |ation, called !F|
00002970  72 65 64 2c 20 70 6c 61  63 65 20 61 20 6c 69 6e  |red, place a lin|
00002980  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |e.             .|
00002990  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000029a0  20 20 20 20 20 20 20 20  2a 53 65 74 20 46 72 65  |        *Set Fre|
000029b0  64 24 42 61 73 69 63 46  69 6c 65 20 3c 4f 62 65  |d$BasicFile <Obe|
000029c0  79 24 44 69 72 3e 2e 21  52 75 6e 49 6d 61 67 65  |y$Dir>.!RunImage|
000029d0  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 77  |..             w|
000029e0  68 69 63 68 20 73 74 6f  72 65 73 20 74 68 65 20  |hich stores the |
000029f0  76 61 6c 75 65 20 61 74  20 72 75 6e 20 74 69 6d  |value at run tim|
00002a00  65 2e 20 48 61 76 65 20  61 20 50 52 4f 43 45 72  |e. Have a PROCEr|
00002a10  72 6f 72 20 70 72 6f 63  65 64 75 72 65 0a 20 20  |ror procedure.  |
00002a20  20 20 20 20 20 20 20 20  20 20 20 61 73 20 61 62  |           as ab|
00002a30  6f 76 65 20 65 78 63 65  70 74 20 69 6e 63 6c 75  |ove except inclu|
00002a40  64 65 20 61 20 6c 69 6e  65 20 77 68 69 63 68 20  |de a line which |
00002a50  73 65 74 73 20 74 68 65  20 76 61 6c 75 65 20 6f  |sets the value o|
00002a60  66 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 45  |f.             E|
00002a70  64 69 74 24 42 61 73 69  63 46 69 6c 65 2e 20 45  |dit$BasicFile. E|
00002a80  2e 67 2e 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |.g...           |
00002a90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 44 45  |              DE|
00002aa0  46 20 50 52 4f 43 45 72  72 6f 72 0a 20 20 20 20  |F PROCError.    |
00002ab0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002ac0  20 20 20 20 20 4f 4e 20  45 52 52 4f 52 20 4f 46  |     ON ERROR OF|
00002ad0  46 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |F.              |
00002ae0  20 20 20 20 20 20 20 20  20 20 20 2a 53 65 74 20  |           *Set |
00002af0  42 61 73 69 63 24 46 69  6c 65 20 3c 46 72 65 64  |Basic$File <Fred|
00002b00  24 42 61 73 69 63 46 69  6c 65 3e 0a 20 20 20 20  |$BasicFile>.    |
00002b10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002b20  20 20 20 20 20 43 48 41  49 4e 20 22 45 64 69 74  |     CHAIN "Edit|
00002b30  3a 54 68 72 6f 77 62 61  63 6b 22 0a 20 20 20 20  |:Throwback".    |
00002b40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002b50  20 20 20 20 20 45 4e 44  50 52 4f 43 0a 0a 20 20  |     ENDPROC..  |
00002b60  20 20 20 20 20 20 28 64  29 20 50 72 6f 67 72 61  |      (d) Progra|
00002b70  6d 73 20 77 68 69 63 68  20 61 72 65 20 43 48 41  |ms which are CHA|
00002b80  49 4e 45 44 0a 20 20 20  20 20 20 20 20 20 20 20  |INED.           |
00002b90  20 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  | ...............|
00002ba0  98 98 98 98 98 98 98 98  98 98 98 0a 0a 20 20 20  |.............   |
00002bb0  20 20 20 20 20 20 20 20  20 49 6e 20 74 68 69 73  |         In this|
00002bc0  20 63 61 73 65 20 74 68  65 20 76 61 6c 75 65 20  | case the value |
00002bd0  6f 66 20 42 61 73 69 63  24 46 69 6c 65 20 68 61  |of Basic$File ha|
00002be0  73 20 74 6f 20 62 65 20  73 65 74 20 62 79 20 74  |s to be set by t|
00002bf0  68 65 0a 20 20 20 20 20  20 20 20 20 20 20 20 70  |he.            p|
00002c00  72 6f 67 72 61 6d 6d 65  72 20 61 73 20 69 6e 20  |rogrammer as in |
00002c10  28 63 29 2e 0a 0a 0a 20  20 20 20 20 20 20 20 28  |(c)....        (|
00002c20  65 29 20 44 52 41 47 47  49 4e 47 0a 20 20 20 20  |e) DRAGGING.    |
00002c30  20 20 20 20 20 20 20 20  98 98 98 98 98 98 98 98  |        ........|
00002c40  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 49 46  |..            IF|
00002c50  20 61 20 42 41 53 49 43  20 70 72 6f 67 72 61 6d  | a BASIC program|
00002c60  20 6f 72 20 61 20 22 73  74 61 6e 64 61 72 64 22  | or a "standard"|
00002c70  20 61 70 70 6c 69 63 61  74 69 6f 6e 20 28 69 2e  | application (i.|
00002c80  65 2e 20 77 69 74 68 20  61 20 42 41 53 49 43 0a  |e. with a BASIC.|
00002c90  20 20 20 20 20 20 20 20  20 20 20 20 21 52 75 6e  |            !Run|
00002ca0  49 6d 61 67 65 20 66 69  6c 65 29 20 69 73 20 64  |Image file) is d|
00002cb0  72 61 67 67 65 64 20 6f  6e 74 6f 20 74 68 65 20  |ragged onto the |
00002cc0  74 68 72 6f 77 62 61 63  6b 20 77 69 6e 64 6f 77  |throwback window|
00002cd0  20 74 68 65 20 70 61 74  68 6e 61 6d 65 0a 20 20  | the pathname.  |
00002ce0  20 20 20 20 20 20 20 20  20 20 6f 66 20 74 68 65  |          of the|
00002cf0  20 66 69 6c 65 20 74 6f  20 74 68 72 6f 77 20 62  | file to throw b|
00002d00  61 63 6b 20 74 6f 20 63  68 61 6e 67 65 73 20 61  |ack to changes a|
00002d10  70 70 72 6f 70 72 69 61  74 65 6c 79 2e 0a 0a 20  |ppropriately... |
00002d20  20 20 20 20 20 20 20 20  20 20 20 49 66 20 79 6f  |           If yo|
00002d30  75 20 6e 65 65 64 20 74  6f 20 64 6f 20 74 68 69  |u need to do thi|
00002d40  73 20 69 74 20 69 73 20  62 65 63 61 75 73 65 20  |s it is because |
00002d50  79 6f 75 20 68 61 76 65  6e 27 74 20 62 65 65 6e  |you haven't been|
00002d60  20 6f 62 73 65 72 76 69  6e 67 0a 20 20 20 20 20  | observing.     |
00002d70  20 20 20 20 20 20 20 74  68 65 20 22 72 75 6c 65  |       the "rule|
00002d80  73 22 20 69 6e 20 28 61  29 2d 28 64 29 20 61 62  |s" in (a)-(d) ab|
00002d90  6f 76 65 21 0a 0a 0a 20  20 20 20 20 20 20 32 2e  |ove!...       2.|
00002da0  20 54 68 72 6f 77 62 61  63 6b 20 74 6f 20 74 68  | Throwback to th|
00002db0  65 20 77 72 6f 6e 67 20  6c 69 6e 65 20 28 62 75  |e wrong line (bu|
00002dc0  74 20 74 68 65 20 63 6f  72 72 65 63 74 20 66 69  |t the correct fi|
00002dd0  6c 65 29 0a 20 20 20 20  20 20 20 98 98 98 98 98  |le).       .....|
00002de0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
*
00002e10  0a 0a 20 20 20 20 20 20  20 20 20 20 41 73 20 61  |..          As a|
00002e20  20 66 69 72 73 74 20 72  65 73 6f 72 74 20 74 72  | first resort tr|
00002e30  79 20 74 6f 67 67 6c 69  6e 67 20 62 65 74 77 65  |y toggling betwe|
00002e40  65 6e 20 22 6e 6f 72 6d  61 6c 22 20 61 6e 64 20  |en "normal" and |
00002e50  22 6c 6f 67 69 63 61 6c  22 20 6c 69 6e 65 0a 20  |"logical" line. |
00002e60  20 20 20 20 20 20 20 20  20 6e 75 6d 62 65 72 73  |         numbers|
00002e70  2e 20 54 68 69 73 20 77  69 6c 6c 20 70 72 6f 62  |. This will prob|
00002e80  61 62 6c 79 20 22 63 75  72 65 22 20 79 6f 75 72  |ably "cure" your|
00002e90  20 70 72 6f 62 6c 65 6d  73 2e 0a 0a 20 20 20 20  | problems...    |
00002ea0  20 20 20 20 20 20 28 52  65 6d 65 6d 62 65 72 20  |      (Remember |
00002eb0  74 68 61 74 20 21 54 68  72 6f 77 62 61 63 6b 20  |that !Throwback |
00002ec0  61 73 73 75 6d 65 73 20  6c 69 6e 65 20 6e 75 6d  |assumes line num|
00002ed0  62 65 72 73 20 69 6e 20  69 6e 63 72 65 6d 65 6e  |bers in incremen|
00002ee0  74 73 20 6f 66 20 31 30  2e 0a 20 20 20 20 20 20  |ts of 10..      |
00002ef0  20 20 20 20 20 49 66 2c  20 66 6f 72 20 65 78 61  |     If, for exa|
00002f00  6d 70 6c 65 2c 20 79 6f  75 72 20 70 72 6f 67 72  |mple, your progr|
00002f10  61 6d 20 61 63 74 75 61  6c 6c 79 20 68 61 73 20  |am actually has |
00002f20  6c 6f 67 69 63 61 6c 20  6c 69 6e 65 20 6e 75 6d  |logical line num|
00002f30  62 65 72 73 0a 20 20 20  20 20 20 20 20 20 20 20  |bers.           |
00002f40  74 68 65 6e 20 61 6e 20  65 72 72 6f 72 20 6f 6e  |then an error on|
00002f50  20 6c 69 6e 65 20 34 20  77 6f 75 6c 64 20 62 65  | line 4 would be|
00002f60  20 73 68 6f 77 6e 20 61  73 20 22 65 72 72 6f 72  | shown as "error|
00002f70  20 61 74 20 6c 69 6e 65  20 30 2e 34 22 2e 20 54  | at line 0.4". T|
00002f80  68 65 0a 20 20 20 20 20  20 20 20 20 20 20 72 65  |he.           re|
00002f90  6d 65 64 79 20 69 6e 20  74 68 69 73 20 63 61 73  |medy in this cas|
00002fa0  65 20 69 73 20 73 69 6d  70 6c 65 20 2d 20 63 68  |e is simple - ch|
00002fb0  6f 6f 73 65 20 6c 6f 67  69 63 61 6c 20 6c 69 6e  |oose logical lin|
00002fc0  65 20 6e 75 6d 62 65 72  73 2e 29 0a 0a 20 20 20  |e numbers.)..   |
00002fd0  20 20 20 20 20 20 20 49  66 20 74 68 65 20 6c 69  |       If the li|
00002fe0  6e 65 20 6e 75 6d 62 65  72 73 20 61 72 65 20 6e  |ne numbers are n|
00002ff0  65 69 74 68 65 72 20 6c  6f 67 69 63 61 6c 20 6e  |either logical n|
00003000  6f 72 20 6e 6f 72 6d 61  6c 20 74 68 65 20 70 72  |or normal the pr|
00003010  6f 67 72 61 6d 20 68 61  73 0a 20 20 20 20 20 20  |ogram has.      |
00003020  20 20 20 20 74 6f 20 62  65 20 72 65 6e 75 6d 62  |    to be renumb|
00003030  65 72 65 64 2e 20 54 68  69 73 20 63 61 6e 20 62  |ered. This can b|
00003040  65 20 64 6f 6e 65 20 62  79 20 63 6c 69 63 6b 69  |e done by clicki|
00003050  6e 67 20 6f 6e 20 74 68  65 20 22 72 65 64 6f 22  |ng on the "redo"|
00003060  20 62 75 74 74 6f 6e 0a  20 20 20 20 20 20 20 20  | button.        |
00003070  20 20 6f 6e 20 74 68 65  20 74 68 72 6f 77 62 61  |  on the throwba|
00003080  63 6b 20 77 69 6e 64 6f  77 2e 20 28 41 6c 74 65  |ck window. (Alte|
00003090  72 6e 61 74 69 76 65 6c  79 2c 45 6e 74 65 72 20  |rnatively,Enter |
000030a0  74 68 65 20 42 41 53 49  43 20 63 6f 6d 6d 61 6e  |the BASIC comman|
000030b0  64 20 6c 69 6e 65 2c 0a  20 20 20 20 20 20 20 20  |d line,.        |
000030c0  20 20 6c 6f 61 64 69 6e  67 20 74 68 65 20 70 72  |  loading the pr|
000030d0  6f 67 72 61 6d 20 61 6e  64 20 67 69 76 69 6e 67  |ogram and giving|
000030e0  20 74 68 65 20 63 6f 6d  6d 61 6e 64 20 52 45 4e  | the command REN|
000030f0  55 4d 42 45 52 20 66 6f  6c 6c 6f 77 65 64 20 62  |UMBER followed b|
00003100  79 20 61 0a 20 20 20 20  20 20 20 20 20 20 53 41  |y a.          SA|
00003110  56 45 2e 0a 20 20 20 20  20 20 20 20 20 20 20 0a  |VE..           .|
00003120  20 20 20 20 20 20 20 0a  20 20 20 20 20 20 20 20  |       .        |
00003130  53 55 4d 4d 41 52 59 0a  20 20 20 20 20 20 20 20  |SUMMARY.        |
00003140  3d 3d 3d 3d 3d 3d 3d 0a  0a 20 20 20 20 20 20 20  |=======..       |
00003150  20 21 54 68 72 6f 77 62  61 63 6b 20 69 73 20 69  | !Throwback is i|
00003160  6e 20 65 66 66 65 63 74  20 63 6f 6e 74 72 6f 6c  |n effect control|
00003170  6c 65 64 20 62 79 20 74  77 6f 20 73 79 73 74 65  |led by two syste|
00003180  6d 20 76 61 72 69 61 62  6c 65 73 3a 0a 0a 20 20  |m variables:..  |
00003190  20 20 20 20 20 20 42 61  73 69 63 24 46 69 6c 65  |      Basic$File|
000031a0  20 20 3d 20 20 70 61 74  68 6e 61 6d 65 20 6f 66  |  =  pathname of|
000031b0  20 66 69 6c 65 20 63 6f  6e 74 61 69 6e 69 6e 67  | file containing|
000031c0  20 65 72 72 6f 72 0a 20  20 20 20 20 20 20 20 0a  | error.        .|
000031d0  20 20 20 20 20 20 20 20  42 61 73 69 63 24 4f 70  |        Basic$Op|
000031e0  74 69 6f 6e 73 20 20 49  66 20 63 6f 6e 74 61 69  |tions  If contai|
000031f0  6e 73 20 22 6c 22 20 74  68 65 6e 20 6c 6f 67 69  |ns "l" then logi|
00003200  63 61 6c 20 6c 69 6e 65  20 6e 75 6d 62 65 72 73  |cal line numbers|
00003210  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00003220  20 20 20 20 20 20 20 20  20 20 20 20 6f 74 68 65  |            othe|
00003230  72 77 69 73 65 20 6e 6f  72 6d 61 6c 2e 0a 20 20  |rwise normal..  |
00003240  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003250  20 20 20 20 20 20 20 20  20 49 66 20 63 6f 6e 74  |         If cont|
00003260  61 69 6e 73 20 22 2b 22  20 74 68 65 20 75 73 75  |ains "+" the usu|
00003270  61 6c 20 65 72 72 6f 72  20 6d 65 73 73 61 67 65  |al error message|
00003280  73 20 77 69 6c 6c 0a 20  20 20 20 20 20 20 20 20  |s will.         |
00003290  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000032a0  20 20 62 65 20 67 69 76  65 6e 20 62 65 66 6f 72  |  be given befor|
000032b0  65 20 74 68 65 20 74 68  72 6f 77 62 61 63 6b 20  |e the throwback |
000032c0  77 69 6e 64 6f 77 20 69  73 20 6f 70 65 6e 65 64  |window is opened|
000032d0  2e 0a 0a 20 20 20 20 20  20 20 20 4c 69 62 72 61  |...        Libra|
000032e0  72 79 20 70 61 74 68 20  6e 61 6d 65 73 20 61 72  |ry path names ar|
000032f0  65 20 63 6f 6e 74 61 69  6e 65 64 20 69 6e 20 74  |e contained in t|
00003300  68 65 69 72 20 66 69 72  73 74 20 6c 69 6e 65 20  |heir first line |
00003310  28 61 73 20 73 70 65 63  69 66 69 65 64 0a 20 20  |(as specified.  |
00003320  20 20 20 20 20 20 69 6e  20 42 41 53 49 43 20 70  |      in BASIC p|
00003330  72 6f 67 72 61 6d 6d 69  6e 67 20 6d 61 6e 75 61  |rogramming manua|
00003340  6c 29 0a 20 20 20 20 20  20 20 20 0a 0a 20 20 20  |l).        ..   |
00003350  20 20 20 20 20 20 20 20  20 20 0a 20 20 20 20 20  |          .     |
00003360  20 20 20 20 20 20 20 0a  20 20 20 20 20 20 20 20  |       .        |
00003370  20 0a 0a 20 20 20 20 20  20 20 20 0a 0a 20 20 20  | ..        ..   |
00003380  20 20 20 20 0a 0a 20 20  20 20 0a 0a 20 20 20 0a  |    ..    ..   .|
00003390  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000033a0  0a 20 20 20 0a                                    |.   .|
000033a5