Home » Archimedes archive » Archimedes World » archimedes_world_volume_15_issue_2_scp.adf » !ARMEdit_ARMEdit » Docs/Ensure

Docs/Ensure

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 » archimedes_world_volume_15_issue_2_scp.adf » !ARMEdit_ARMEdit
Filename: Docs/Ensure
Read OK:
File size: 1118 bytes
Load address: 0000
Exec address: 0000
File contents
File        : Ensure
Date        : 09-May-95
Author      : � A.Thoukydides, 1995
Description : Description of the "Ensure" utility.


INTRODUCTION

The "Ensure" utility is used to ensure that suitable versions of modules from
the !System.modules directory are loaded. There are two advantages over the
usual RMEnsure commands in a script file: only a single command is required
for each module, and the error messages are friendlier.

This utility is FreeWare; it may be freely used and copied. However, I
retain full copyright. See the section on "LEGAL MATTERS" for more details.


USAGE

The syntax is:

    Ensure <ModuleTitle> <Version> <Filename>

where

    <ModuleTitle>   - the name of the module, as given by *Modules
    
    <Version>       - the minimum version of the module required
    
    <Filename>      - the filename of the file within the !System.modules
                      directory, i.e. it is appended after "System:modules."

Note that no checking of arguments is currently performed.

Example of use:

    Run <App$Dir>.Ensure Iconbar 1.11 Toolbox.IconBar

This starts the Ensure utility from the application directory to ensure that
version 1.11 of the Iconbar module is loaded. If necessary the module is
loaded as "System:modules.Toolbox.Iconbar".


LEGAL MATTERS

The "Ensure" utility and documentation is supplied "as is"; no warranty,
express or implied, of the merchantability of this software or its fitness
for any particular purpose is given. In no circumstances shall the author, or
any provider or distributor of this software, be liable for any damage, loss
of profits, or any indirect or consequential loss arising out of the use of
this software or inability to use this software.

This utility is FreeWare. Permission is granted for anyone to distribute it
unchanged and in its entirety, providing that no profit is made in the
process. The "Ensure" utility may not be distributed if modified or
incomplete; neither may it be distributed without this documentation.

To use this utility, or any part of it, as part of a system or other
application that is for sale (for however much and for whatever reasons) or
released as copyright material then the author's express permission in
writing must be obtained. The author maintains copyright on all the material
supplied and reserves the right to change these conditions at any time
without notice.


CONTACTING THE AUTHOR

I would be interested in hearing of any bugs or other unexpected features in
this utility, and will endeavour to correct any such problems in future
releases. Suggestions for improvements are also most welcome. Implementation
depends upon practicability and on how much spare time I have.

If you have any comments on this program, or would like to suggest ways in
which it could be improved, I can be contacted at one of the following
addresses:
    
    Thalna
    2 Dukes Drive
    Bearwood
    Bournemouth
    Dorset
    BH11 9SZ
    
    thouky@tcp.co.uk

If in any communication you make specific reference to the program code please:

    Quote the version number and date of the utility (it is contained near
    the start of the executable binary).
    
    Refer only to the utility as released.
    
    Supply as many details as possible about the problem, including the
    hardware and software configuration of the machine being used.

Please send a stamped and self addressed envelope, or give details of how to
contact via e-mail, if you would like a reply.

I hope you find this application of some use.


ACKNOWLEDGEMENTS

I would like to the thank the following people for their contributions to
the development of this utility:

    Acorn Computers - The Risc PC, RISC OS and the ObjAsm assembler.
    Dominic Symes   - The brilliant !Zap editor; get a copy immediately.
    Robin Watts     - !Larger, the greatest backdrop program ever.

and everyone at the Acorn User Group in Oxford.


THINGS TO DO

The following are changes that may be made to this utility sometime in the
future:
    
    Checking of command-line arguments and display of syntax message.
    
    Use (optional) Messages file or system variables for error message text.


VERSION HISTORY

0.00 (16-Apr-95)    Original development version.

0.01 (03-May-95)    Tidied up the code and improved the documentation.

1.00 (09-May-95)    First official release version.
00000000  46 69 6c 65 20 20 20 20  20 20 20 20 3a 20 45 6e  |File        : En|
00000010  73 75 72 65 0a 44 61 74  65 20 20 20 20 20 20 20  |sure.Date       |
00000020  20 3a 20 30 39 2d 4d 61  79 2d 39 35 0a 41 75 74  | : 09-May-95.Aut|
00000030  68 6f 72 20 20 20 20 20  20 3a 20 a9 20 41 2e 54  |hor      : . A.T|
00000040  68 6f 75 6b 79 64 69 64  65 73 2c 20 31 39 39 35  |houkydides, 1995|
00000050  0a 44 65 73 63 72 69 70  74 69 6f 6e 20 3a 20 44  |.Description : D|
00000060  65 73 63 72 69 70 74 69  6f 6e 20 6f 66 20 74 68  |escription of th|
00000070  65 20 22 45 6e 73 75 72  65 22 20 75 74 69 6c 69  |e "Ensure" utili|
00000080  74 79 2e 0a 0a 0a 49 4e  54 52 4f 44 55 43 54 49  |ty....INTRODUCTI|
00000090  4f 4e 0a 0a 54 68 65 20  22 45 6e 73 75 72 65 22  |ON..The "Ensure"|
000000a0  20 75 74 69 6c 69 74 79  20 69 73 20 75 73 65 64  | utility is used|
000000b0  20 74 6f 20 65 6e 73 75  72 65 20 74 68 61 74 20  | to ensure that |
000000c0  73 75 69 74 61 62 6c 65  20 76 65 72 73 69 6f 6e  |suitable version|
000000d0  73 20 6f 66 20 6d 6f 64  75 6c 65 73 20 66 72 6f  |s of modules fro|
000000e0  6d 0a 74 68 65 20 21 53  79 73 74 65 6d 2e 6d 6f  |m.the !System.mo|
000000f0  64 75 6c 65 73 20 64 69  72 65 63 74 6f 72 79 20  |dules directory |
00000100  61 72 65 20 6c 6f 61 64  65 64 2e 20 54 68 65 72  |are loaded. Ther|
00000110  65 20 61 72 65 20 74 77  6f 20 61 64 76 61 6e 74  |e are two advant|
00000120  61 67 65 73 20 6f 76 65  72 20 74 68 65 0a 75 73  |ages over the.us|
00000130  75 61 6c 20 52 4d 45 6e  73 75 72 65 20 63 6f 6d  |ual RMEnsure com|
00000140  6d 61 6e 64 73 20 69 6e  20 61 20 73 63 72 69 70  |mands in a scrip|
00000150  74 20 66 69 6c 65 3a 20  6f 6e 6c 79 20 61 20 73  |t file: only a s|
00000160  69 6e 67 6c 65 20 63 6f  6d 6d 61 6e 64 20 69 73  |ingle command is|
00000170  20 72 65 71 75 69 72 65  64 0a 66 6f 72 20 65 61  | required.for ea|
00000180  63 68 20 6d 6f 64 75 6c  65 2c 20 61 6e 64 20 74  |ch module, and t|
00000190  68 65 20 65 72 72 6f 72  20 6d 65 73 73 61 67 65  |he error message|
000001a0  73 20 61 72 65 20 66 72  69 65 6e 64 6c 69 65 72  |s are friendlier|
000001b0  2e 0a 0a 54 68 69 73 20  75 74 69 6c 69 74 79 20  |...This utility |
000001c0  69 73 20 46 72 65 65 57  61 72 65 3b 20 69 74 20  |is FreeWare; it |
000001d0  6d 61 79 20 62 65 20 66  72 65 65 6c 79 20 75 73  |may be freely us|
000001e0  65 64 20 61 6e 64 20 63  6f 70 69 65 64 2e 20 48  |ed and copied. H|
000001f0  6f 77 65 76 65 72 2c 20  49 0a 72 65 74 61 69 6e  |owever, I.retain|
00000200  20 66 75 6c 6c 20 63 6f  70 79 72 69 67 68 74 2e  | full copyright.|
00000210  20 53 65 65 20 74 68 65  20 73 65 63 74 69 6f 6e  | See the section|
00000220  20 6f 6e 20 22 4c 45 47  41 4c 20 4d 41 54 54 45  | on "LEGAL MATTE|
00000230  52 53 22 20 66 6f 72 20  6d 6f 72 65 20 64 65 74  |RS" for more det|
00000240  61 69 6c 73 2e 0a 0a 0a  55 53 41 47 45 0a 0a 54  |ails....USAGE..T|
00000250  68 65 20 73 79 6e 74 61  78 20 69 73 3a 0a 0a 20  |he syntax is:.. |
00000260  20 20 20 45 6e 73 75 72  65 20 3c 4d 6f 64 75 6c  |   Ensure <Modul|
00000270  65 54 69 74 6c 65 3e 20  3c 56 65 72 73 69 6f 6e  |eTitle> <Version|
00000280  3e 20 3c 46 69 6c 65 6e  61 6d 65 3e 0a 0a 77 68  |> <Filename>..wh|
00000290  65 72 65 0a 0a 20 20 20  20 3c 4d 6f 64 75 6c 65  |ere..    <Module|
000002a0  54 69 74 6c 65 3e 20 20  20 2d 20 74 68 65 20 6e  |Title>   - the n|
000002b0  61 6d 65 20 6f 66 20 74  68 65 20 6d 6f 64 75 6c  |ame of the modul|
000002c0  65 2c 20 61 73 20 67 69  76 65 6e 20 62 79 20 2a  |e, as given by *|
000002d0  4d 6f 64 75 6c 65 73 0a  20 20 20 20 0a 20 20 20  |Modules.    .   |
000002e0  20 3c 56 65 72 73 69 6f  6e 3e 20 20 20 20 20 20  | <Version>      |
000002f0  20 2d 20 74 68 65 20 6d  69 6e 69 6d 75 6d 20 76  | - the minimum v|
00000300  65 72 73 69 6f 6e 20 6f  66 20 74 68 65 20 6d 6f  |ersion of the mo|
00000310  64 75 6c 65 20 72 65 71  75 69 72 65 64 0a 20 20  |dule required.  |
00000320  20 20 0a 20 20 20 20 3c  46 69 6c 65 6e 61 6d 65  |  .    <Filename|
00000330  3e 20 20 20 20 20 20 2d  20 74 68 65 20 66 69 6c  |>      - the fil|
00000340  65 6e 61 6d 65 20 6f 66  20 74 68 65 20 66 69 6c  |ename of the fil|
00000350  65 20 77 69 74 68 69 6e  20 74 68 65 20 21 53 79  |e within the !Sy|
00000360  73 74 65 6d 2e 6d 6f 64  75 6c 65 73 0a 20 20 20  |stem.modules.   |
00000370  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000380  20 20 20 64 69 72 65 63  74 6f 72 79 2c 20 69 2e  |   directory, i.|
00000390  65 2e 20 69 74 20 69 73  20 61 70 70 65 6e 64 65  |e. it is appende|
000003a0  64 20 61 66 74 65 72 20  22 53 79 73 74 65 6d 3a  |d after "System:|
000003b0  6d 6f 64 75 6c 65 73 2e  22 0a 0a 4e 6f 74 65 20  |modules."..Note |
000003c0  74 68 61 74 20 6e 6f 20  63 68 65 63 6b 69 6e 67  |that no checking|
000003d0  20 6f 66 20 61 72 67 75  6d 65 6e 74 73 20 69 73  | of arguments is|
000003e0  20 63 75 72 72 65 6e 74  6c 79 20 70 65 72 66 6f  | currently perfo|
000003f0  72 6d 65 64 2e 0a 0a 45  78 61 6d 70 6c 65 20 6f  |rmed...Example o|
00000400  66 20 75 73 65 3a 0a 0a  20 20 20 20 52 75 6e 20  |f use:..    Run |
00000410  3c 41 70 70 24 44 69 72  3e 2e 45 6e 73 75 72 65  |<App$Dir>.Ensure|
00000420  20 49 63 6f 6e 62 61 72  20 31 2e 31 31 20 54 6f  | Iconbar 1.11 To|
00000430  6f 6c 62 6f 78 2e 49 63  6f 6e 42 61 72 0a 0a 54  |olbox.IconBar..T|
00000440  68 69 73 20 73 74 61 72  74 73 20 74 68 65 20 45  |his starts the E|
00000450  6e 73 75 72 65 20 75 74  69 6c 69 74 79 20 66 72  |nsure utility fr|
00000460  6f 6d 20 74 68 65 20 61  70 70 6c 69 63 61 74 69  |om the applicati|
00000470  6f 6e 20 64 69 72 65 63  74 6f 72 79 20 74 6f 20  |on directory to |
00000480  65 6e 73 75 72 65 20 74  68 61 74 0a 76 65 72 73  |ensure that.vers|
00000490  69 6f 6e 20 31 2e 31 31  20 6f 66 20 74 68 65 20  |ion 1.11 of the |
000004a0  49 63 6f 6e 62 61 72 20  6d 6f 64 75 6c 65 20 69  |Iconbar module i|
000004b0  73 20 6c 6f 61 64 65 64  2e 20 49 66 20 6e 65 63  |s loaded. If nec|
000004c0  65 73 73 61 72 79 20 74  68 65 20 6d 6f 64 75 6c  |essary the modul|
000004d0  65 20 69 73 0a 6c 6f 61  64 65 64 20 61 73 20 22  |e is.loaded as "|
000004e0  53 79 73 74 65 6d 3a 6d  6f 64 75 6c 65 73 2e 54  |System:modules.T|
000004f0  6f 6f 6c 62 6f 78 2e 49  63 6f 6e 62 61 72 22 2e  |oolbox.Iconbar".|
00000500  0a 0a 0a 4c 45 47 41 4c  20 4d 41 54 54 45 52 53  |...LEGAL MATTERS|
00000510  0a 0a 54 68 65 20 22 45  6e 73 75 72 65 22 20 75  |..The "Ensure" u|
00000520  74 69 6c 69 74 79 20 61  6e 64 20 64 6f 63 75 6d  |tility and docum|
00000530  65 6e 74 61 74 69 6f 6e  20 69 73 20 73 75 70 70  |entation is supp|
00000540  6c 69 65 64 20 22 61 73  20 69 73 22 3b 20 6e 6f  |lied "as is"; no|
00000550  20 77 61 72 72 61 6e 74  79 2c 0a 65 78 70 72 65  | warranty,.expre|
00000560  73 73 20 6f 72 20 69 6d  70 6c 69 65 64 2c 20 6f  |ss or implied, o|
00000570  66 20 74 68 65 20 6d 65  72 63 68 61 6e 74 61 62  |f the merchantab|
00000580  69 6c 69 74 79 20 6f 66  20 74 68 69 73 20 73 6f  |ility of this so|
00000590  66 74 77 61 72 65 20 6f  72 20 69 74 73 20 66 69  |ftware or its fi|
000005a0  74 6e 65 73 73 0a 66 6f  72 20 61 6e 79 20 70 61  |tness.for any pa|
000005b0  72 74 69 63 75 6c 61 72  20 70 75 72 70 6f 73 65  |rticular purpose|
000005c0  20 69 73 20 67 69 76 65  6e 2e 20 49 6e 20 6e 6f  | is given. In no|
000005d0  20 63 69 72 63 75 6d 73  74 61 6e 63 65 73 20 73  | circumstances s|
000005e0  68 61 6c 6c 20 74 68 65  20 61 75 74 68 6f 72 2c  |hall the author,|
000005f0  20 6f 72 0a 61 6e 79 20  70 72 6f 76 69 64 65 72  | or.any provider|
00000600  20 6f 72 20 64 69 73 74  72 69 62 75 74 6f 72 20  | or distributor |
00000610  6f 66 20 74 68 69 73 20  73 6f 66 74 77 61 72 65  |of this software|
00000620  2c 20 62 65 20 6c 69 61  62 6c 65 20 66 6f 72 20  |, be liable for |
00000630  61 6e 79 20 64 61 6d 61  67 65 2c 20 6c 6f 73 73  |any damage, loss|
00000640  0a 6f 66 20 70 72 6f 66  69 74 73 2c 20 6f 72 20  |.of profits, or |
00000650  61 6e 79 20 69 6e 64 69  72 65 63 74 20 6f 72 20  |any indirect or |
00000660  63 6f 6e 73 65 71 75 65  6e 74 69 61 6c 20 6c 6f  |consequential lo|
00000670  73 73 20 61 72 69 73 69  6e 67 20 6f 75 74 20 6f  |ss arising out o|
00000680  66 20 74 68 65 20 75 73  65 20 6f 66 0a 74 68 69  |f the use of.thi|
00000690  73 20 73 6f 66 74 77 61  72 65 20 6f 72 20 69 6e  |s software or in|
000006a0  61 62 69 6c 69 74 79 20  74 6f 20 75 73 65 20 74  |ability to use t|
000006b0  68 69 73 20 73 6f 66 74  77 61 72 65 2e 0a 0a 54  |his software...T|
000006c0  68 69 73 20 75 74 69 6c  69 74 79 20 69 73 20 46  |his utility is F|
000006d0  72 65 65 57 61 72 65 2e  20 50 65 72 6d 69 73 73  |reeWare. Permiss|
000006e0  69 6f 6e 20 69 73 20 67  72 61 6e 74 65 64 20 66  |ion is granted f|
000006f0  6f 72 20 61 6e 79 6f 6e  65 20 74 6f 20 64 69 73  |or anyone to dis|
00000700  74 72 69 62 75 74 65 20  69 74 0a 75 6e 63 68 61  |tribute it.uncha|
00000710  6e 67 65 64 20 61 6e 64  20 69 6e 20 69 74 73 20  |nged and in its |
00000720  65 6e 74 69 72 65 74 79  2c 20 70 72 6f 76 69 64  |entirety, provid|
00000730  69 6e 67 20 74 68 61 74  20 6e 6f 20 70 72 6f 66  |ing that no prof|
00000740  69 74 20 69 73 20 6d 61  64 65 20 69 6e 20 74 68  |it is made in th|
00000750  65 0a 70 72 6f 63 65 73  73 2e 20 54 68 65 20 22  |e.process. The "|
00000760  45 6e 73 75 72 65 22 20  75 74 69 6c 69 74 79 20  |Ensure" utility |
00000770  6d 61 79 20 6e 6f 74 20  62 65 20 64 69 73 74 72  |may not be distr|
00000780  69 62 75 74 65 64 20 69  66 20 6d 6f 64 69 66 69  |ibuted if modifi|
00000790  65 64 20 6f 72 0a 69 6e  63 6f 6d 70 6c 65 74 65  |ed or.incomplete|
000007a0  3b 20 6e 65 69 74 68 65  72 20 6d 61 79 20 69 74  |; neither may it|
000007b0  20 62 65 20 64 69 73 74  72 69 62 75 74 65 64 20  | be distributed |
000007c0  77 69 74 68 6f 75 74 20  74 68 69 73 20 64 6f 63  |without this doc|
000007d0  75 6d 65 6e 74 61 74 69  6f 6e 2e 0a 0a 54 6f 20  |umentation...To |
000007e0  75 73 65 20 74 68 69 73  20 75 74 69 6c 69 74 79  |use this utility|
000007f0  2c 20 6f 72 20 61 6e 79  20 70 61 72 74 20 6f 66  |, or any part of|
00000800  20 69 74 2c 20 61 73 20  70 61 72 74 20 6f 66 20  | it, as part of |
00000810  61 20 73 79 73 74 65 6d  20 6f 72 20 6f 74 68 65  |a system or othe|
00000820  72 0a 61 70 70 6c 69 63  61 74 69 6f 6e 20 74 68  |r.application th|
00000830  61 74 20 69 73 20 66 6f  72 20 73 61 6c 65 20 28  |at is for sale (|
00000840  66 6f 72 20 68 6f 77 65  76 65 72 20 6d 75 63 68  |for however much|
00000850  20 61 6e 64 20 66 6f 72  20 77 68 61 74 65 76 65  | and for whateve|
00000860  72 20 72 65 61 73 6f 6e  73 29 20 6f 72 0a 72 65  |r reasons) or.re|
00000870  6c 65 61 73 65 64 20 61  73 20 63 6f 70 79 72 69  |leased as copyri|
00000880  67 68 74 20 6d 61 74 65  72 69 61 6c 20 74 68 65  |ght material the|
00000890  6e 20 74 68 65 20 61 75  74 68 6f 72 27 73 20 65  |n the author's e|
000008a0  78 70 72 65 73 73 20 70  65 72 6d 69 73 73 69 6f  |xpress permissio|
000008b0  6e 20 69 6e 0a 77 72 69  74 69 6e 67 20 6d 75 73  |n in.writing mus|
000008c0  74 20 62 65 20 6f 62 74  61 69 6e 65 64 2e 20 54  |t be obtained. T|
000008d0  68 65 20 61 75 74 68 6f  72 20 6d 61 69 6e 74 61  |he author mainta|
000008e0  69 6e 73 20 63 6f 70 79  72 69 67 68 74 20 6f 6e  |ins copyright on|
000008f0  20 61 6c 6c 20 74 68 65  20 6d 61 74 65 72 69 61  | all the materia|
00000900  6c 0a 73 75 70 70 6c 69  65 64 20 61 6e 64 20 72  |l.supplied and r|
00000910  65 73 65 72 76 65 73 20  74 68 65 20 72 69 67 68  |eserves the righ|
00000920  74 20 74 6f 20 63 68 61  6e 67 65 20 74 68 65 73  |t to change thes|
00000930  65 20 63 6f 6e 64 69 74  69 6f 6e 73 20 61 74 20  |e conditions at |
00000940  61 6e 79 20 74 69 6d 65  0a 77 69 74 68 6f 75 74  |any time.without|
00000950  20 6e 6f 74 69 63 65 2e  0a 0a 0a 43 4f 4e 54 41  | notice....CONTA|
00000960  43 54 49 4e 47 20 54 48  45 20 41 55 54 48 4f 52  |CTING THE AUTHOR|
00000970  0a 0a 49 20 77 6f 75 6c  64 20 62 65 20 69 6e 74  |..I would be int|
00000980  65 72 65 73 74 65 64 20  69 6e 20 68 65 61 72 69  |erested in heari|
00000990  6e 67 20 6f 66 20 61 6e  79 20 62 75 67 73 20 6f  |ng of any bugs o|
000009a0  72 20 6f 74 68 65 72 20  75 6e 65 78 70 65 63 74  |r other unexpect|
000009b0  65 64 20 66 65 61 74 75  72 65 73 20 69 6e 0a 74  |ed features in.t|
000009c0  68 69 73 20 75 74 69 6c  69 74 79 2c 20 61 6e 64  |his utility, and|
000009d0  20 77 69 6c 6c 20 65 6e  64 65 61 76 6f 75 72 20  | will endeavour |
000009e0  74 6f 20 63 6f 72 72 65  63 74 20 61 6e 79 20 73  |to correct any s|
000009f0  75 63 68 20 70 72 6f 62  6c 65 6d 73 20 69 6e 20  |uch problems in |
00000a00  66 75 74 75 72 65 0a 72  65 6c 65 61 73 65 73 2e  |future.releases.|
00000a10  20 53 75 67 67 65 73 74  69 6f 6e 73 20 66 6f 72  | Suggestions for|
00000a20  20 69 6d 70 72 6f 76 65  6d 65 6e 74 73 20 61 72  | improvements ar|
00000a30  65 20 61 6c 73 6f 20 6d  6f 73 74 20 77 65 6c 63  |e also most welc|
00000a40  6f 6d 65 2e 20 49 6d 70  6c 65 6d 65 6e 74 61 74  |ome. Implementat|
00000a50  69 6f 6e 0a 64 65 70 65  6e 64 73 20 75 70 6f 6e  |ion.depends upon|
00000a60  20 70 72 61 63 74 69 63  61 62 69 6c 69 74 79 20  | practicability |
00000a70  61 6e 64 20 6f 6e 20 68  6f 77 20 6d 75 63 68 20  |and on how much |
00000a80  73 70 61 72 65 20 74 69  6d 65 20 49 20 68 61 76  |spare time I hav|
00000a90  65 2e 0a 0a 49 66 20 79  6f 75 20 68 61 76 65 20  |e...If you have |
00000aa0  61 6e 79 20 63 6f 6d 6d  65 6e 74 73 20 6f 6e 20  |any comments on |
00000ab0  74 68 69 73 20 70 72 6f  67 72 61 6d 2c 20 6f 72  |this program, or|
00000ac0  20 77 6f 75 6c 64 20 6c  69 6b 65 20 74 6f 20 73  | would like to s|
00000ad0  75 67 67 65 73 74 20 77  61 79 73 20 69 6e 0a 77  |uggest ways in.w|
00000ae0  68 69 63 68 20 69 74 20  63 6f 75 6c 64 20 62 65  |hich it could be|
00000af0  20 69 6d 70 72 6f 76 65  64 2c 20 49 20 63 61 6e  | improved, I can|
00000b00  20 62 65 20 63 6f 6e 74  61 63 74 65 64 20 61 74  | be contacted at|
00000b10  20 6f 6e 65 20 6f 66 20  74 68 65 20 66 6f 6c 6c  | one of the foll|
00000b20  6f 77 69 6e 67 0a 61 64  64 72 65 73 73 65 73 3a  |owing.addresses:|
00000b30  0a 20 20 20 20 0a 20 20  20 20 54 68 61 6c 6e 61  |.    .    Thalna|
00000b40  0a 20 20 20 20 32 20 44  75 6b 65 73 20 44 72 69  |.    2 Dukes Dri|
00000b50  76 65 0a 20 20 20 20 42  65 61 72 77 6f 6f 64 0a  |ve.    Bearwood.|
00000b60  20 20 20 20 42 6f 75 72  6e 65 6d 6f 75 74 68 0a  |    Bournemouth.|
00000b70  20 20 20 20 44 6f 72 73  65 74 0a 20 20 20 20 42  |    Dorset.    B|
00000b80  48 31 31 20 39 53 5a 0a  20 20 20 20 0a 20 20 20  |H11 9SZ.    .   |
00000b90  20 74 68 6f 75 6b 79 40  74 63 70 2e 63 6f 2e 75  | thouky@tcp.co.u|
00000ba0  6b 0a 0a 49 66 20 69 6e  20 61 6e 79 20 63 6f 6d  |k..If in any com|
00000bb0  6d 75 6e 69 63 61 74 69  6f 6e 20 79 6f 75 20 6d  |munication you m|
00000bc0  61 6b 65 20 73 70 65 63  69 66 69 63 20 72 65 66  |ake specific ref|
00000bd0  65 72 65 6e 63 65 20 74  6f 20 74 68 65 20 70 72  |erence to the pr|
00000be0  6f 67 72 61 6d 20 63 6f  64 65 20 70 6c 65 61 73  |ogram code pleas|
00000bf0  65 3a 0a 0a 20 20 20 20  51 75 6f 74 65 20 74 68  |e:..    Quote th|
00000c00  65 20 76 65 72 73 69 6f  6e 20 6e 75 6d 62 65 72  |e version number|
00000c10  20 61 6e 64 20 64 61 74  65 20 6f 66 20 74 68 65  | and date of the|
00000c20  20 75 74 69 6c 69 74 79  20 28 69 74 20 69 73 20  | utility (it is |
00000c30  63 6f 6e 74 61 69 6e 65  64 20 6e 65 61 72 0a 20  |contained near. |
00000c40  20 20 20 74 68 65 20 73  74 61 72 74 20 6f 66 20  |   the start of |
00000c50  74 68 65 20 65 78 65 63  75 74 61 62 6c 65 20 62  |the executable b|
00000c60  69 6e 61 72 79 29 2e 0a  20 20 20 20 0a 20 20 20  |inary)..    .   |
00000c70  20 52 65 66 65 72 20 6f  6e 6c 79 20 74 6f 20 74  | Refer only to t|
00000c80  68 65 20 75 74 69 6c 69  74 79 20 61 73 20 72 65  |he utility as re|
00000c90  6c 65 61 73 65 64 2e 0a  20 20 20 20 0a 20 20 20  |leased..    .   |
00000ca0  20 53 75 70 70 6c 79 20  61 73 20 6d 61 6e 79 20  | Supply as many |
00000cb0  64 65 74 61 69 6c 73 20  61 73 20 70 6f 73 73 69  |details as possi|
00000cc0  62 6c 65 20 61 62 6f 75  74 20 74 68 65 20 70 72  |ble about the pr|
00000cd0  6f 62 6c 65 6d 2c 20 69  6e 63 6c 75 64 69 6e 67  |oblem, including|
00000ce0  20 74 68 65 0a 20 20 20  20 68 61 72 64 77 61 72  | the.    hardwar|
00000cf0  65 20 61 6e 64 20 73 6f  66 74 77 61 72 65 20 63  |e and software c|
00000d00  6f 6e 66 69 67 75 72 61  74 69 6f 6e 20 6f 66 20  |onfiguration of |
00000d10  74 68 65 20 6d 61 63 68  69 6e 65 20 62 65 69 6e  |the machine bein|
00000d20  67 20 75 73 65 64 2e 0a  0a 50 6c 65 61 73 65 20  |g used...Please |
00000d30  73 65 6e 64 20 61 20 73  74 61 6d 70 65 64 20 61  |send a stamped a|
00000d40  6e 64 20 73 65 6c 66 20  61 64 64 72 65 73 73 65  |nd self addresse|
00000d50  64 20 65 6e 76 65 6c 6f  70 65 2c 20 6f 72 20 67  |d envelope, or g|
00000d60  69 76 65 20 64 65 74 61  69 6c 73 20 6f 66 20 68  |ive details of h|
00000d70  6f 77 20 74 6f 0a 63 6f  6e 74 61 63 74 20 76 69  |ow to.contact vi|
00000d80  61 20 65 2d 6d 61 69 6c  2c 20 69 66 20 79 6f 75  |a e-mail, if you|
00000d90  20 77 6f 75 6c 64 20 6c  69 6b 65 20 61 20 72 65  | would like a re|
00000da0  70 6c 79 2e 0a 0a 49 20  68 6f 70 65 20 79 6f 75  |ply...I hope you|
00000db0  20 66 69 6e 64 20 74 68  69 73 20 61 70 70 6c 69  | find this appli|
00000dc0  63 61 74 69 6f 6e 20 6f  66 20 73 6f 6d 65 20 75  |cation of some u|
00000dd0  73 65 2e 0a 0a 0a 41 43  4b 4e 4f 57 4c 45 44 47  |se....ACKNOWLEDG|
00000de0  45 4d 45 4e 54 53 0a 0a  49 20 77 6f 75 6c 64 20  |EMENTS..I would |
00000df0  6c 69 6b 65 20 74 6f 20  74 68 65 20 74 68 61 6e  |like to the than|
00000e00  6b 20 74 68 65 20 66 6f  6c 6c 6f 77 69 6e 67 20  |k the following |
00000e10  70 65 6f 70 6c 65 20 66  6f 72 20 74 68 65 69 72  |people for their|
00000e20  20 63 6f 6e 74 72 69 62  75 74 69 6f 6e 73 20 74  | contributions t|
00000e30  6f 0a 74 68 65 20 64 65  76 65 6c 6f 70 6d 65 6e  |o.the developmen|
00000e40  74 20 6f 66 20 74 68 69  73 20 75 74 69 6c 69 74  |t of this utilit|
00000e50  79 3a 0a 0a 20 20 20 20  41 63 6f 72 6e 20 43 6f  |y:..    Acorn Co|
00000e60  6d 70 75 74 65 72 73 20  2d 20 54 68 65 20 52 69  |mputers - The Ri|
00000e70  73 63 20 50 43 2c 20 52  49 53 43 20 4f 53 20 61  |sc PC, RISC OS a|
00000e80  6e 64 20 74 68 65 20 4f  62 6a 41 73 6d 20 61 73  |nd the ObjAsm as|
00000e90  73 65 6d 62 6c 65 72 2e  0a 20 20 20 20 44 6f 6d  |sembler..    Dom|
00000ea0  69 6e 69 63 20 53 79 6d  65 73 20 20 20 2d 20 54  |inic Symes   - T|
00000eb0  68 65 20 62 72 69 6c 6c  69 61 6e 74 20 21 5a 61  |he brilliant !Za|
00000ec0  70 20 65 64 69 74 6f 72  3b 20 67 65 74 20 61 20  |p editor; get a |
00000ed0  63 6f 70 79 20 69 6d 6d  65 64 69 61 74 65 6c 79  |copy immediately|
00000ee0  2e 0a 20 20 20 20 52 6f  62 69 6e 20 57 61 74 74  |..    Robin Watt|
00000ef0  73 20 20 20 20 20 2d 20  21 4c 61 72 67 65 72 2c  |s     - !Larger,|
00000f00  20 74 68 65 20 67 72 65  61 74 65 73 74 20 62 61  | the greatest ba|
00000f10  63 6b 64 72 6f 70 20 70  72 6f 67 72 61 6d 20 65  |ckdrop program e|
00000f20  76 65 72 2e 0a 0a 61 6e  64 20 65 76 65 72 79 6f  |ver...and everyo|
00000f30  6e 65 20 61 74 20 74 68  65 20 41 63 6f 72 6e 20  |ne at the Acorn |
00000f40  55 73 65 72 20 47 72 6f  75 70 20 69 6e 20 4f 78  |User Group in Ox|
00000f50  66 6f 72 64 2e 0a 0a 0a  54 48 49 4e 47 53 20 54  |ford....THINGS T|
00000f60  4f 20 44 4f 0a 0a 54 68  65 20 66 6f 6c 6c 6f 77  |O DO..The follow|
00000f70  69 6e 67 20 61 72 65 20  63 68 61 6e 67 65 73 20  |ing are changes |
00000f80  74 68 61 74 20 6d 61 79  20 62 65 20 6d 61 64 65  |that may be made|
00000f90  20 74 6f 20 74 68 69 73  20 75 74 69 6c 69 74 79  | to this utility|
00000fa0  20 73 6f 6d 65 74 69 6d  65 20 69 6e 20 74 68 65  | sometime in the|
00000fb0  0a 66 75 74 75 72 65 3a  0a 20 20 20 20 0a 20 20  |.future:.    .  |
00000fc0  20 20 43 68 65 63 6b 69  6e 67 20 6f 66 20 63 6f  |  Checking of co|
00000fd0  6d 6d 61 6e 64 2d 6c 69  6e 65 20 61 72 67 75 6d  |mmand-line argum|
00000fe0  65 6e 74 73 20 61 6e 64  20 64 69 73 70 6c 61 79  |ents and display|
00000ff0  20 6f 66 20 73 79 6e 74  61 78 20 6d 65 73 73 61  | of syntax messa|
00001000  67 65 2e 0a 20 20 20 20  0a 20 20 20 20 55 73 65  |ge..    .    Use|
00001010  20 28 6f 70 74 69 6f 6e  61 6c 29 20 4d 65 73 73  | (optional) Mess|
00001020  61 67 65 73 20 66 69 6c  65 20 6f 72 20 73 79 73  |ages file or sys|
00001030  74 65 6d 20 76 61 72 69  61 62 6c 65 73 20 66 6f  |tem variables fo|
00001040  72 20 65 72 72 6f 72 20  6d 65 73 73 61 67 65 20  |r error message |
00001050  74 65 78 74 2e 0a 0a 0a  56 45 52 53 49 4f 4e 20  |text....VERSION |
00001060  48 49 53 54 4f 52 59 0a  0a 30 2e 30 30 20 28 31  |HISTORY..0.00 (1|
00001070  36 2d 41 70 72 2d 39 35  29 20 20 20 20 4f 72 69  |6-Apr-95)    Ori|
00001080  67 69 6e 61 6c 20 64 65  76 65 6c 6f 70 6d 65 6e  |ginal developmen|
00001090  74 20 76 65 72 73 69 6f  6e 2e 0a 0a 30 2e 30 31  |t version...0.01|
000010a0  20 28 30 33 2d 4d 61 79  2d 39 35 29 20 20 20 20  | (03-May-95)    |
000010b0  54 69 64 69 65 64 20 75  70 20 74 68 65 20 63 6f  |Tidied up the co|
000010c0  64 65 20 61 6e 64 20 69  6d 70 72 6f 76 65 64 20  |de and improved |
000010d0  74 68 65 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |the documentatio|
000010e0  6e 2e 0a 0a 31 2e 30 30  20 28 30 39 2d 4d 61 79  |n...1.00 (09-May|
000010f0  2d 39 35 29 20 20 20 20  46 69 72 73 74 20 6f 66  |-95)    First of|
00001100  66 69 63 69 61 6c 20 72  65 6c 65 61 73 65 20 76  |ficial release v|
00001110  65 72 73 69 6f 6e 2e 0a                           |ersion..|
00001118