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

!AWSept93/Goodies/ThrowBack/Examples/!ReadMe

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/Examples/!ReadMe
Read OK:
File size: 03AD bytes
Load address: 0000
Exec address: 0000
File contents

1. "SampleProg" is an example of a simple BASIC program
   with an error.

   Double-click to see what happens.

2. "!SampleApp" illustrates the structure of throwback
   when used with an application. Double-click it.

3. The directory "SampleLib" contains
 
        � a procedure library "!SampleLib"
        � a program "LibExample" which uses the procedure library.

   If the program LibExample is double-clicked there
   is an error which occurs in PROCPrint in the library.

   Note the use of the psuedo-filing system

              SampleLib$Path

   which enables us to refer to any file in the
   directory Library (inside !SampleLib) as

             SampleLib:<file-name>

   Try moving the Library application to different locations and 
   re-setting the value of this system variable by double-
   clicking !SampleLib. 

   Every time you run LibExample the file 
   (and hence the error) will be found by throwback.


   
00000000  0a 0a 31 2e 20 22 53 61  6d 70 6c 65 50 72 6f 67  |..1. "SampleProg|
00000010  22 20 69 73 20 61 6e 20  65 78 61 6d 70 6c 65 20  |" is an example |
00000020  6f 66 20 61 20 73 69 6d  70 6c 65 20 42 41 53 49  |of a simple BASI|
00000030  43 20 70 72 6f 67 72 61  6d 0a 20 20 20 77 69 74  |C program.   wit|
00000040  68 20 61 6e 20 65 72 72  6f 72 2e 0a 0a 20 20 20  |h an error...   |
00000050  44 6f 75 62 6c 65 2d 63  6c 69 63 6b 20 74 6f 20  |Double-click to |
00000060  73 65 65 20 77 68 61 74  20 68 61 70 70 65 6e 73  |see what happens|
00000070  2e 0a 0a 32 2e 20 22 21  53 61 6d 70 6c 65 41 70  |...2. "!SampleAp|
00000080  70 22 20 69 6c 6c 75 73  74 72 61 74 65 73 20 74  |p" illustrates t|
00000090  68 65 20 73 74 72 75 63  74 75 72 65 20 6f 66 20  |he structure of |
000000a0  74 68 72 6f 77 62 61 63  6b 0a 20 20 20 77 68 65  |throwback.   whe|
000000b0  6e 20 75 73 65 64 20 77  69 74 68 20 61 6e 20 61  |n used with an a|
000000c0  70 70 6c 69 63 61 74 69  6f 6e 2e 20 44 6f 75 62  |pplication. Doub|
000000d0  6c 65 2d 63 6c 69 63 6b  20 69 74 2e 0a 0a 33 2e  |le-click it...3.|
000000e0  20 54 68 65 20 64 69 72  65 63 74 6f 72 79 20 22  | The directory "|
000000f0  53 61 6d 70 6c 65 4c 69  62 22 20 63 6f 6e 74 61  |SampleLib" conta|
00000100  69 6e 73 0a 20 0a 20 20  20 20 20 20 20 20 8f 20  |ins. .        . |
00000110  61 20 70 72 6f 63 65 64  75 72 65 20 6c 69 62 72  |a procedure libr|
00000120  61 72 79 20 22 21 53 61  6d 70 6c 65 4c 69 62 22  |ary "!SampleLib"|
00000130  0a 20 20 20 20 20 20 20  20 8f 20 61 20 70 72 6f  |.        . a pro|
00000140  67 72 61 6d 20 22 4c 69  62 45 78 61 6d 70 6c 65  |gram "LibExample|
00000150  22 20 77 68 69 63 68 20  75 73 65 73 20 74 68 65  |" which uses the|
00000160  20 70 72 6f 63 65 64 75  72 65 20 6c 69 62 72 61  | procedure libra|
00000170  72 79 2e 0a 0a 20 20 20  49 66 20 74 68 65 20 70  |ry...   If the p|
00000180  72 6f 67 72 61 6d 20 4c  69 62 45 78 61 6d 70 6c  |rogram LibExampl|
00000190  65 20 69 73 20 64 6f 75  62 6c 65 2d 63 6c 69 63  |e is double-clic|
000001a0  6b 65 64 20 74 68 65 72  65 0a 20 20 20 69 73 20  |ked there.   is |
000001b0  61 6e 20 65 72 72 6f 72  20 77 68 69 63 68 20 6f  |an error which o|
000001c0  63 63 75 72 73 20 69 6e  20 50 52 4f 43 50 72 69  |ccurs in PROCPri|
000001d0  6e 74 20 69 6e 20 74 68  65 20 6c 69 62 72 61 72  |nt in the librar|
000001e0  79 2e 0a 0a 20 20 20 4e  6f 74 65 20 74 68 65 20  |y...   Note the |
000001f0  75 73 65 20 6f 66 20 74  68 65 20 70 73 75 65 64  |use of the psued|
00000200  6f 2d 66 69 6c 69 6e 67  20 73 79 73 74 65 6d 0a  |o-filing system.|
00000210  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 53  |.              S|
00000220  61 6d 70 6c 65 4c 69 62  24 50 61 74 68 0a 0a 20  |ampleLib$Path.. |
00000230  20 20 77 68 69 63 68 20  65 6e 61 62 6c 65 73 20  |  which enables |
00000240  75 73 20 74 6f 20 72 65  66 65 72 20 74 6f 20 61  |us to refer to a|
00000250  6e 79 20 66 69 6c 65 20  69 6e 20 74 68 65 0a 20  |ny file in the. |
00000260  20 20 64 69 72 65 63 74  6f 72 79 20 4c 69 62 72  |  directory Libr|
00000270  61 72 79 20 28 69 6e 73  69 64 65 20 21 53 61 6d  |ary (inside !Sam|
00000280  70 6c 65 4c 69 62 29 20  61 73 0a 0a 20 20 20 20  |pleLib) as..    |
00000290  20 20 20 20 20 20 20 20  20 53 61 6d 70 6c 65 4c  |         SampleL|
000002a0  69 62 3a 3c 66 69 6c 65  2d 6e 61 6d 65 3e 0a 0a  |ib:<file-name>..|
000002b0  20 20 20 54 72 79 20 6d  6f 76 69 6e 67 20 74 68  |   Try moving th|
000002c0  65 20 4c 69 62 72 61 72  79 20 61 70 70 6c 69 63  |e Library applic|
000002d0  61 74 69 6f 6e 20 74 6f  20 64 69 66 66 65 72 65  |ation to differe|
000002e0  6e 74 20 6c 6f 63 61 74  69 6f 6e 73 20 61 6e 64  |nt locations and|
000002f0  20 0a 20 20 20 72 65 2d  73 65 74 74 69 6e 67 20  | .   re-setting |
00000300  74 68 65 20 76 61 6c 75  65 20 6f 66 20 74 68 69  |the value of thi|
00000310  73 20 73 79 73 74 65 6d  20 76 61 72 69 61 62 6c  |s system variabl|
00000320  65 20 62 79 20 64 6f 75  62 6c 65 2d 0a 20 20 20  |e by double-.   |
00000330  63 6c 69 63 6b 69 6e 67  20 21 53 61 6d 70 6c 65  |clicking !Sample|
00000340  4c 69 62 2e 20 0a 0a 20  20 20 45 76 65 72 79 20  |Lib. ..   Every |
00000350  74 69 6d 65 20 79 6f 75  20 72 75 6e 20 4c 69 62  |time you run Lib|
00000360  45 78 61 6d 70 6c 65 20  74 68 65 20 66 69 6c 65  |Example the file|
00000370  20 0a 20 20 20 28 61 6e  64 20 68 65 6e 63 65 20  | .   (and hence |
00000380  74 68 65 20 65 72 72 6f  72 29 20 77 69 6c 6c 20  |the error) will |
00000390  62 65 20 66 6f 75 6e 64  20 62 79 20 74 68 72 6f  |be found by thro|
000003a0  77 62 61 63 6b 2e 0a 0a  0a 20 20 20 0a           |wback....   .|
000003ad