Purpose: This program creates BASIC source code for a module, saving you the programmer up to about 100 lines of code and allowing you to get down to the business of writing the code rather than messing about with the BASIC assembler.
How to use
----------
1) Load it up; I'm afraid you'll need RISC OS 3
2) Choose which sections of code your module will need such as start code, init code and service call handlers. This part defines the module header
3) Type in the title and help strings (version and creation date do not need to be included here).
4) If either the command table or SWI code are selected the choose how many CLI commands and/or SWIs that you want your program to have. Also enter the SWI prefix if necessary.
5) Choose whether you want the source code to save and/or run the code once it has assembled itself.
6) Type in a name and save the source code somewhere.
Notes
-----
The program generates the source code by writing a Command (*Exec) file to PipeFS which starts BASIC, writes the program, saves it and issues a QUIT command. This looks messy when you save the source code as the program is spooled out very quickly in a window but is easier to program and not that much of a handicap to the user.
Apart from this programming quirk, there isn't much to say about it. SWI source code handling is dodgy at the best of times because I never program modules that support them. If you find this a problem then write to me and complain.
Feedback
--------
This program was written very much for my needs and as such supports them very well. However I am sure that somebody else will want it to do something else or find a bug that could be corrected. If you do add to the program or correct any bugs then DON'T DISTRIBUTE IT! Send it first back to me with a covering letter and I will update it, credit you and re-distribute it. This ensures that different versions are not floating around.
If you want something doing to the program and can't or don't want to do it yourself then send it back to me, explain your problem and I will try to help you.
My name and address: Matthew Bloch,
5 Brookside,
Headington,
Oxford, OX3 7PJ.
Copyright
---------
This program is FREEWARE. This means that you may distribute it to anyone you want providing that you do not charge for it (except in the case of P.D. libraries) and do not alter it in any way. You may also not use parts of it in your own programs. The copyright remains mine at all times. P.D. libraries please contact me if you want to distribute this.
