Home » Archimedes archive » Micro User » MU 1991-04.adf » PD-Stuff » Mod_Dis/GetStarted

Mod_Dis/GetStarted

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 » Micro User » MU 1991-04.adf » PD-Stuff
Filename: Mod_Dis/GetStarted
Read OK:
File size: 05A6 bytes
Load address: 0000
Exec address: 0000
File contents
> GetStarted

To get trying out the program as quickly as possible, do the following:

1. Make MOD_DIS your current directory

2. Copy the SpriteUtils module into the ORIGINALS directory. To do this
   with RISC OS 2.00, the following command should work:
   *Save ORIGINALS.SpriteUtil 0387EA48 0387F04C

3. Run the program ModDis201. When prompted reply as follows:
   <prompt>                               <response>
   Filename?                              SpriteUtils
   1 byte(s) at 3AF of unknown type       6
   4 byte(s) at 600 of unknown type       4
   How many?                              1

4. Load the newly-created file SOURCES.SpriteUtil into Twin or !Edit and
   remove the carriage-returns. Save the file again and set its type to FFB
   with *SetType SOURCES.SpriteUtil FFB

5. Run the BASIC program SOURCES.SpriteUtil. This re-assembles the module and
   stores it in MODULES.SpriteUtil.

6. To test the re-assembled module, run the BASIC program Checker. When
   prompted for a filename, reply SpriteUtil. If all is well, Checker will
   not report any differences between the original module and the
   re-assembled version, proving that the disassembly is good.

7. If you run ModDis201 again, this time the program will not ask you any
   questions, but will read the responses from the file SCRIPTS.SpriteUtil,
   which was created during the last run. You should never have to answer
   the questions more than once!
00000000  3e 20 47 65 74 53 74 61  72 74 65 64 0a 0a 54 6f  |> GetStarted..To|
00000010  20 67 65 74 20 74 72 79  69 6e 67 20 6f 75 74 20  | get trying out |
00000020  74 68 65 20 70 72 6f 67  72 61 6d 20 61 73 20 71  |the program as q|
00000030  75 69 63 6b 6c 79 20 61  73 20 70 6f 73 73 69 62  |uickly as possib|
00000040  6c 65 2c 20 64 6f 20 74  68 65 20 66 6f 6c 6c 6f  |le, do the follo|
00000050  77 69 6e 67 3a 0a 0a 31  2e 20 4d 61 6b 65 20 4d  |wing:..1. Make M|
00000060  4f 44 5f 44 49 53 20 79  6f 75 72 20 63 75 72 72  |OD_DIS your curr|
00000070  65 6e 74 20 64 69 72 65  63 74 6f 72 79 0a 0a 32  |ent directory..2|
00000080  2e 20 43 6f 70 79 20 74  68 65 20 53 70 72 69 74  |. Copy the Sprit|
00000090  65 55 74 69 6c 73 20 6d  6f 64 75 6c 65 20 69 6e  |eUtils module in|
000000a0  74 6f 20 74 68 65 20 4f  52 49 47 49 4e 41 4c 53  |to the ORIGINALS|
000000b0  20 64 69 72 65 63 74 6f  72 79 2e 20 54 6f 20 64  | directory. To d|
000000c0  6f 20 74 68 69 73 0a 20  20 20 77 69 74 68 20 52  |o this.   with R|
000000d0  49 53 43 20 4f 53 20 32  2e 30 30 2c 20 74 68 65  |ISC OS 2.00, the|
000000e0  20 66 6f 6c 6c 6f 77 69  6e 67 20 63 6f 6d 6d 61  | following comma|
000000f0  6e 64 20 73 68 6f 75 6c  64 20 77 6f 72 6b 3a 0a  |nd should work:.|
00000100  20 20 20 2a 53 61 76 65  20 4f 52 49 47 49 4e 41  |   *Save ORIGINA|
00000110  4c 53 2e 53 70 72 69 74  65 55 74 69 6c 20 30 33  |LS.SpriteUtil 03|
00000120  38 37 45 41 34 38 20 30  33 38 37 46 30 34 43 0a  |87EA48 0387F04C.|
00000130  0a 33 2e 20 52 75 6e 20  74 68 65 20 70 72 6f 67  |.3. Run the prog|
00000140  72 61 6d 20 4d 6f 64 44  69 73 32 30 31 2e 20 57  |ram ModDis201. W|
00000150  68 65 6e 20 70 72 6f 6d  70 74 65 64 20 72 65 70  |hen prompted rep|
00000160  6c 79 20 61 73 20 66 6f  6c 6c 6f 77 73 3a 0a 20  |ly as follows:. |
00000170  20 20 3c 70 72 6f 6d 70  74 3e 20 20 20 20 20 20  |  <prompt>      |
00000180  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000190  20 20 20 20 20 20 20 20  20 3c 72 65 73 70 6f 6e  |         <respon|
000001a0  73 65 3e 0a 20 20 20 46  69 6c 65 6e 61 6d 65 3f  |se>.   Filename?|
000001b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000001c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 53 70  |              Sp|
000001d0  72 69 74 65 55 74 69 6c  73 0a 20 20 20 31 20 62  |riteUtils.   1 b|
000001e0  79 74 65 28 73 29 20 61  74 20 33 41 46 20 6f 66  |yte(s) at 3AF of|
000001f0  20 75 6e 6b 6e 6f 77 6e  20 74 79 70 65 20 20 20  | unknown type   |
00000200  20 20 20 20 36 0a 20 20  20 34 20 62 79 74 65 28  |    6.   4 byte(|
00000210  73 29 20 61 74 20 36 30  30 20 6f 66 20 75 6e 6b  |s) at 600 of unk|
00000220  6e 6f 77 6e 20 74 79 70  65 20 20 20 20 20 20 20  |nown type       |
00000230  34 0a 20 20 20 48 6f 77  20 6d 61 6e 79 3f 20 20  |4.   How many?  |
00000240  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000250  20 20 20 20 20 20 20 20  20 20 20 20 31 0a 0a 34  |            1..4|
00000260  2e 20 4c 6f 61 64 20 74  68 65 20 6e 65 77 6c 79  |. Load the newly|
00000270  2d 63 72 65 61 74 65 64  20 66 69 6c 65 20 53 4f  |-created file SO|
00000280  55 52 43 45 53 2e 53 70  72 69 74 65 55 74 69 6c  |URCES.SpriteUtil|
00000290  20 69 6e 74 6f 20 54 77  69 6e 20 6f 72 20 21 45  | into Twin or !E|
000002a0  64 69 74 20 61 6e 64 0a  20 20 20 72 65 6d 6f 76  |dit and.   remov|
000002b0  65 20 74 68 65 20 63 61  72 72 69 61 67 65 2d 72  |e the carriage-r|
000002c0  65 74 75 72 6e 73 2e 20  53 61 76 65 20 74 68 65  |eturns. Save the|
000002d0  20 66 69 6c 65 20 61 67  61 69 6e 20 61 6e 64 20  | file again and |
000002e0  73 65 74 20 69 74 73 20  74 79 70 65 20 74 6f 20  |set its type to |
000002f0  46 46 42 0a 20 20 20 77  69 74 68 20 2a 53 65 74  |FFB.   with *Set|
00000300  54 79 70 65 20 53 4f 55  52 43 45 53 2e 53 70 72  |Type SOURCES.Spr|
00000310  69 74 65 55 74 69 6c 20  46 46 42 0a 0a 35 2e 20  |iteUtil FFB..5. |
00000320  52 75 6e 20 74 68 65 20  42 41 53 49 43 20 70 72  |Run the BASIC pr|
00000330  6f 67 72 61 6d 20 53 4f  55 52 43 45 53 2e 53 70  |ogram SOURCES.Sp|
00000340  72 69 74 65 55 74 69 6c  2e 20 54 68 69 73 20 72  |riteUtil. This r|
00000350  65 2d 61 73 73 65 6d 62  6c 65 73 20 74 68 65 20  |e-assembles the |
00000360  6d 6f 64 75 6c 65 20 61  6e 64 0a 20 20 20 73 74  |module and.   st|
00000370  6f 72 65 73 20 69 74 20  69 6e 20 4d 4f 44 55 4c  |ores it in MODUL|
00000380  45 53 2e 53 70 72 69 74  65 55 74 69 6c 2e 0a 0a  |ES.SpriteUtil...|
00000390  36 2e 20 54 6f 20 74 65  73 74 20 74 68 65 20 72  |6. To test the r|
000003a0  65 2d 61 73 73 65 6d 62  6c 65 64 20 6d 6f 64 75  |e-assembled modu|
000003b0  6c 65 2c 20 72 75 6e 20  74 68 65 20 42 41 53 49  |le, run the BASI|
000003c0  43 20 70 72 6f 67 72 61  6d 20 43 68 65 63 6b 65  |C program Checke|
000003d0  72 2e 20 57 68 65 6e 0a  20 20 20 70 72 6f 6d 70  |r. When.   promp|
000003e0  74 65 64 20 66 6f 72 20  61 20 66 69 6c 65 6e 61  |ted for a filena|
000003f0  6d 65 2c 20 72 65 70 6c  79 20 53 70 72 69 74 65  |me, reply Sprite|
00000400  55 74 69 6c 2e 20 49 66  20 61 6c 6c 20 69 73 20  |Util. If all is |
00000410  77 65 6c 6c 2c 20 43 68  65 63 6b 65 72 20 77 69  |well, Checker wi|
00000420  6c 6c 0a 20 20 20 6e 6f  74 20 72 65 70 6f 72 74  |ll.   not report|
00000430  20 61 6e 79 20 64 69 66  66 65 72 65 6e 63 65 73  | any differences|
00000440  20 62 65 74 77 65 65 6e  20 74 68 65 20 6f 72 69  | between the ori|
00000450  67 69 6e 61 6c 20 6d 6f  64 75 6c 65 20 61 6e 64  |ginal module and|
00000460  20 74 68 65 0a 20 20 20  72 65 2d 61 73 73 65 6d  | the.   re-assem|
00000470  62 6c 65 64 20 76 65 72  73 69 6f 6e 2c 20 70 72  |bled version, pr|
00000480  6f 76 69 6e 67 20 74 68  61 74 20 74 68 65 20 64  |oving that the d|
00000490  69 73 61 73 73 65 6d 62  6c 79 20 69 73 20 67 6f  |isassembly is go|
000004a0  6f 64 2e 0a 0a 37 2e 20  49 66 20 79 6f 75 20 72  |od...7. If you r|
000004b0  75 6e 20 4d 6f 64 44 69  73 32 30 31 20 61 67 61  |un ModDis201 aga|
000004c0  69 6e 2c 20 74 68 69 73  20 74 69 6d 65 20 74 68  |in, this time th|
000004d0  65 20 70 72 6f 67 72 61  6d 20 77 69 6c 6c 20 6e  |e program will n|
000004e0  6f 74 20 61 73 6b 20 79  6f 75 20 61 6e 79 0a 20  |ot ask you any. |
000004f0  20 20 71 75 65 73 74 69  6f 6e 73 2c 20 62 75 74  |  questions, but|
00000500  20 77 69 6c 6c 20 72 65  61 64 20 74 68 65 20 72  | will read the r|
00000510  65 73 70 6f 6e 73 65 73  20 66 72 6f 6d 20 74 68  |esponses from th|
00000520  65 20 66 69 6c 65 20 53  43 52 49 50 54 53 2e 53  |e file SCRIPTS.S|
00000530  70 72 69 74 65 55 74 69  6c 2c 0a 20 20 20 77 68  |priteUtil,.   wh|
00000540  69 63 68 20 77 61 73 20  63 72 65 61 74 65 64 20  |ich was created |
00000550  64 75 72 69 6e 67 20 74  68 65 20 6c 61 73 74 20  |during the last |
00000560  72 75 6e 2e 20 59 6f 75  20 73 68 6f 75 6c 64 20  |run. You should |
00000570  6e 65 76 65 72 20 68 61  76 65 20 74 6f 20 61 6e  |never have to an|
00000580  73 77 65 72 0a 20 20 20  74 68 65 20 71 75 65 73  |swer.   the ques|
00000590  74 69 6f 6e 73 20 6d 6f  72 65 20 74 68 61 6e 20  |tions more than |
000005a0  6f 6e 63 65 21 0a                                 |once!.|
000005a6