Home » CEEFAX disks » telesoftware3.adl » 01_11_87/HLP\INF
01_11_87/HLP\INF
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 » CEEFAX disks » telesoftware3.adl |
Filename: | 01_11_87/HLP\INF |
Read OK: | ✔ |
File size: | 1E86 bytes |
Load address: | 0000 |
Exec address: | 0000 |
Duplicates
There is 1 duplicate copy of this file in the archive:
- CEEFAX disks » telesoftware3.adl » 01_11_87/HLP\INF
- CEEFAX disks » telesoftware6.adl » 28-03-88/HLP\INF
File contents
M.J.RAWLINGS 17-4-87 HELPFILE If, like me, you have an unreliable memory you are probably fed up with constantly searching through the various advance manuals available for the B.B.C. looking for confirmation of something you should know but could not quite remember the exact syntax of. How much more convenient it would be if all the most important facts could be available as *HELP information. Loaded into a sideways ram bank and ready to be displayed at any time. If you have more than one bank of sideways ram, as many BEEB users now do, you could have multiple banks of helpfiles booted up ready for any programming session. The HELPFILE program can be used to create your own customised sideways ram *HELP facility. On running the program you will be presented with a menu, to start creating your own helpfile choose option 1, this sets up a random access disc file which will be used to store the data needed to create the final rom image. This random access file is broken up into sections, one for each *HELP command, you can see them being counted off on the screen as the file is created. When the count reaches the maximum number of files (150) you will then be presented with the editing screen. Note that this file is nearly twice as long (almost 32K) as the maximum size of rom image being created (16k), this is because each command is initially allowed message space of 5 lines of 40 characters. When the final helpfile is created all the unwanted spaces are removed, the editor includes a byte count constantly updated on the screen to help you use the available space efficiently. EDITOR The editor is entered at command number 1, you will see the cursor on the command line, below this there are 5 lines for typing in the message to be displayed. At the top right the number of bytes left is displayed, this should read 16157 for a new blank file. Use the cursor keys to move around the screen, anything typed will either be inserted at the cursor position or will overwrite current text at the cursor position. You can toggle between insert and over modes using the <COPY> key, the current state of this switch being displayed at the bottom right of the screen. Commands have a maximum length of ten letters and are automatically restricted by the editor to upper case, numbers and the characters:- /<=>?@[\]^_# i.e. characters numbered from 47 to 96. This is not only to eliminate characters which BBC Basic might misinterpret but also because *HELP commands are automatically converted to upper case and would not be recognised if the rom image contained lower case commands. The actual message displayed on the screen is not limited in this way and can contain any typable character, i.e. character numbers 32 to 126. Each line of text has a line limiter at the end "|", this is there so that you can "see" any blank spaces on a line. The bytes left count is automatically updated as you type, but you will notice that if the command line is empty then this count will remain unchanged, this is because when the final rom image is created all zero commands are ignored. Similarly all zero message lines will be ignored, if you wish to space out your messages then you will have to put at least one blank space in the line between the messages. You can continue to type even when the bytes count is minus, though if you do not go back and edit other commands to return the byte count to positive then when the helpfile is created you will lose any surplus commands. The routine to create a helpfile includes its own byte count check and will ensure that there is enough space left before encoding each command, you should never end up with half a message tacked on at the end of the file. When you have finished the first command press <TAB>, you now have the choice of either pressing <RETURN> to go onto the next command, or entering the command number you wish to edit next or pressing <ESCAPE> to return to the menu. On pressing <TAB> the data you have just typed in will be stored on disk in the data file, you do not have to create the whole rom image in one sitting, any data file can be edited one command at a time at your convenience using menu option number 2. You can type in and edit commands out of order as any blank commands will be ignored. CREATING A HELPFILE Choose option 3 and enter the filename to be used for creating the finished rom image, this must be different from the filename for the datafile from which the final helpfile is created. Next enter the datafile filename and you will see the commands being counted off on the screen. When this process is finished you can exit the program and load the helpfile into sideways ram, you will need to press <BREAK> to initialise it. This should display the name of your helpfile along with the normal startup messages. Now type *HELP <RETURN> and this same message will be displayed, any message can now be displayed by typing *H.(COMMAND) <RETURN>. OPERATING SYSTEM COMMANDS Any * command can be entered from the menu either by choosing option 4 or typing <*>. The program includes a *FX180 command which sets OSHWM (operating system high water mark) to an address above the area used by the program. This means that any command which would normally corrupt the program area, such as *BACKUP or *COMPACT can be issued from within the program in complete safety. These commands use the area from OSHWM to HIMEM as an extended disk buffer, OSHWM is normally set at the same address as PAGE thereby corrupting any program or data stored above PAGE. Setting OSHWM above the area used by the program sets up a safe buffer area, this buffer is smaller than usual so *BACKUP will require more passes and will take longer than usual. If you use this idea in your own program be careful not to issue the O/S command from within a procedure or function as the return addresses and local variables used by PROCs and FNs are stored on the stack below HIMEM and could be corrupted. If you are creating a helpfile with many repetitive messages then you can enter a *KEY command to setup the function keys to type these parts for you. COMPATIBILITY This program has been tested on a BBC B with an issue 7 board and O/S 1.2/ACORN DFS 1.2, using Solidisk's 2MHZ 256K sideways ram (with and without a 6502 second processor). It has also been used on an identical machine fitted with Solidisk's original SWR128 and on the same machine fitted with Acorn User's 16K UserRAM. There are no illegal peeks or pokes, and only well documented operating system calls are used so it should work with all BBC type machines including the ELECTRON and COMPACT. FXHELP Broadcast with this program is an example helpfile (FXHELP) together with the datafile used in its creation (FXDATA). This gives help messages on all the available FX commands, load this into sideways ram, press <BREAK> and you should see the message:- Help File : FXHELP Typing *H.FXHELP will display a list of the available FX help messages, for example *H.FX0 will display:- Print OS No. If you can create a really useful helpfile why not send it in to the BBC Telesoftware service for broadcasting?
00000000 0d 0d 0d 0d 0d 0d 20 20 20 20 20 20 20 20 20 20 |...... | 00000010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 00000030 20 20 20 20 20 20 20 20 4d 2e 4a 2e 52 41 57 4c | M.J.RAWL| 00000040 49 4e 47 53 20 31 37 2d 34 2d 38 37 0d 20 20 20 |INGS 17-4-87. | 00000050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000060 20 20 20 20 20 20 20 20 20 20 20 20 48 45 4c 50 | HELP| 00000070 46 49 4c 45 0d 0d 0d 20 20 20 20 20 20 20 20 20 |FILE... | 00000080 20 49 66 2c 20 20 6c 69 6b 65 20 6d 65 2c 20 79 | If, like me, y| 00000090 6f 75 20 68 61 76 65 20 61 6e 20 75 6e 72 65 6c |ou have an unrel| 000000a0 69 61 62 6c 65 20 6d 65 6d 6f 72 79 20 79 6f 75 |iable memory you| 000000b0 20 61 72 65 20 70 72 6f 62 61 62 6c 79 0d 66 65 | are probably.fe| 000000c0 64 20 75 70 20 77 69 74 68 20 63 6f 6e 73 74 61 |d up with consta| 000000d0 6e 74 6c 79 20 73 65 61 72 63 68 69 6e 67 20 74 |ntly searching t| 000000e0 68 72 6f 75 67 68 20 74 68 65 20 76 61 72 69 6f |hrough the vario| 000000f0 75 73 20 20 61 64 76 61 6e 63 65 20 20 6d 61 6e |us advance man| 00000100 75 61 6c 73 0d 61 76 61 69 6c 61 62 6c 65 20 20 |uals.available | 00000110 66 6f 72 20 20 74 68 65 20 20 42 2e 42 2e 43 2e |for the B.B.C.| 00000120 20 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 63 6f | looking for co| 00000130 6e 66 69 72 6d 61 74 69 6f 6e 20 6f 66 20 73 6f |nfirmation of so| 00000140 6d 65 74 68 69 6e 67 20 79 6f 75 0d 73 68 6f 75 |mething you.shou| 00000150 6c 64 20 6b 6e 6f 77 20 62 75 74 20 63 6f 75 6c |ld know but coul| 00000160 64 20 6e 6f 74 20 71 75 69 74 65 20 72 65 6d 65 |d not quite reme| 00000170 6d 62 65 72 20 74 68 65 20 65 78 61 63 74 20 73 |mber the exact s| 00000180 79 6e 74 61 78 20 6f 66 2e 20 48 6f 77 20 6d 75 |yntax of. How mu| 00000190 63 68 0d 6d 6f 72 65 20 63 6f 6e 76 65 6e 69 65 |ch.more convenie| 000001a0 6e 74 20 69 74 20 77 6f 75 6c 64 20 62 65 20 69 |nt it would be i| 000001b0 66 20 61 6c 6c 20 74 68 65 20 6d 6f 73 74 20 69 |f all the most i| 000001c0 6d 70 6f 72 74 61 6e 74 20 66 61 63 74 73 20 20 |mportant facts | 000001d0 63 6f 75 6c 64 20 20 62 65 0d 61 76 61 69 6c 61 |could be.availa| 000001e0 62 6c 65 20 20 61 73 20 20 2a 48 45 4c 50 20 20 |ble as *HELP | 000001f0 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 4c 6f 61 |information. Loa| 00000200 64 65 64 20 69 6e 74 6f 20 61 20 73 69 64 65 77 |ded into a sidew| 00000210 61 79 73 20 72 61 6d 20 62 61 6e 6b 20 61 6e 64 |ays ram bank and| 00000220 0d 72 65 61 64 79 20 74 6f 20 62 65 20 64 69 73 |.ready to be dis| 00000230 70 6c 61 79 65 64 20 61 74 20 61 6e 79 20 74 69 |played at any ti| 00000240 6d 65 2e 20 49 66 20 79 6f 75 20 68 61 76 65 20 |me. If you have | 00000250 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 20 62 |more than one b| 00000260 61 6e 6b 20 20 6f 66 0d 73 69 64 65 77 61 79 73 |ank of.sideways| 00000270 20 72 61 6d 2c 20 61 73 20 6d 61 6e 79 20 42 45 | ram, as many BE| 00000280 45 42 20 75 73 65 72 73 20 6e 6f 77 20 64 6f 2c |EB users now do,| 00000290 20 79 6f 75 20 63 6f 75 6c 64 20 68 61 76 65 20 | you could have | 000002a0 6d 75 6c 74 69 70 6c 65 20 62 61 6e 6b 73 0d 6f |multiple banks.o| 000002b0 66 20 68 65 6c 70 66 69 6c 65 73 20 62 6f 6f 74 |f helpfiles boot| 000002c0 65 64 20 75 70 20 72 65 61 64 79 20 66 6f 72 20 |ed up ready for | 000002d0 61 6e 79 20 70 72 6f 67 72 61 6d 6d 69 6e 67 20 |any programming | 000002e0 73 65 73 73 69 6f 6e 2e 20 0d 0d 20 20 20 20 20 |session. .. | 000002f0 20 20 20 20 20 54 68 65 20 20 48 45 4c 50 46 49 | The HELPFI| 00000300 4c 45 20 20 70 72 6f 67 72 61 6d 20 20 63 61 6e |LE program can| 00000310 20 20 62 65 20 20 75 73 65 64 20 20 74 6f 20 20 | be used to | 00000320 63 72 65 61 74 65 20 20 79 6f 75 72 20 20 6f 77 |create your ow| 00000330 6e 0d 63 75 73 74 6f 6d 69 73 65 64 20 73 69 64 |n.customised sid| 00000340 65 77 61 79 73 20 72 61 6d 20 2a 48 45 4c 50 20 |eways ram *HELP | 00000350 66 61 63 69 6c 69 74 79 2e 20 4f 6e 20 20 72 75 |facility. On ru| 00000360 6e 6e 69 6e 67 20 20 74 68 65 20 20 70 72 6f 67 |nning the prog| 00000370 72 61 6d 20 20 79 6f 75 0d 77 69 6c 6c 20 20 62 |ram you.will b| 00000380 65 20 20 70 72 65 73 65 6e 74 65 64 20 20 77 69 |e presented wi| 00000390 74 68 20 20 61 20 6d 65 6e 75 2c 20 74 6f 20 73 |th a menu, to s| 000003a0 74 61 72 74 20 63 72 65 61 74 69 6e 67 20 79 6f |tart creating yo| 000003b0 75 72 20 6f 77 6e 20 68 65 6c 70 66 69 6c 65 0d |ur own helpfile.| 000003c0 63 68 6f 6f 73 65 20 6f 70 74 69 6f 6e 20 31 2c |choose option 1,| 000003d0 20 74 68 69 73 20 73 65 74 73 20 75 70 20 61 20 | this sets up a | 000003e0 72 61 6e 64 6f 6d 20 61 63 63 65 73 73 20 64 69 |random access di| 000003f0 73 63 20 66 69 6c 65 20 77 68 69 63 68 20 77 69 |sc file which wi| 00000400 6c 6c 20 20 62 65 0d 75 73 65 64 20 20 74 6f 20 |ll be.used to | 00000410 20 73 74 6f 72 65 20 20 74 68 65 20 20 64 61 74 | store the dat| 00000420 61 20 20 6e 65 65 64 65 64 20 74 6f 20 63 72 65 |a needed to cre| 00000430 61 74 65 20 74 68 65 20 66 69 6e 61 6c 20 72 6f |ate the final ro| 00000440 6d 20 69 6d 61 67 65 2e 20 54 68 69 73 0d 72 61 |m image. This.ra| 00000450 6e 64 6f 6d 20 61 63 63 65 73 73 20 66 69 6c 65 |ndom access file| 00000460 20 69 73 20 62 72 6f 6b 65 6e 20 75 70 20 69 6e | is broken up in| 00000470 74 6f 20 20 73 65 63 74 69 6f 6e 73 2c 20 20 6f |to sections, o| 00000480 6e 65 20 20 66 6f 72 20 20 65 61 63 68 20 20 2a |ne for each *| 00000490 48 45 4c 50 0d 63 6f 6d 6d 61 6e 64 2c 20 20 79 |HELP.command, y| 000004a0 6f 75 20 63 61 6e 20 73 65 65 20 74 68 65 6d 20 |ou can see them | 000004b0 62 65 69 6e 67 20 63 6f 75 6e 74 65 64 20 6f 66 |being counted of| 000004c0 66 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 20 |f on the screen | 000004d0 61 73 20 74 68 65 20 66 69 6c 65 0d 69 73 20 63 |as the file.is c| 000004e0 72 65 61 74 65 64 2e 20 57 68 65 6e 20 74 68 65 |reated. When the| 000004f0 20 63 6f 75 6e 74 20 72 65 61 63 68 65 73 20 74 | count reaches t| 00000500 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 |he maximum numbe| 00000510 72 20 6f 66 20 20 66 69 6c 65 73 20 20 28 31 35 |r of files (15| 00000520 30 29 0d 79 6f 75 20 20 77 69 6c 6c 20 20 74 68 |0).you will th| 00000530 65 6e 20 20 62 65 20 20 70 72 65 73 65 6e 74 65 |en be presente| 00000540 64 20 77 69 74 68 20 74 68 65 20 65 64 69 74 69 |d with the editi| 00000550 6e 67 20 73 63 72 65 65 6e 2e 20 4e 6f 74 65 20 |ng screen. Note | 00000560 74 68 61 74 20 74 68 69 73 0d 66 69 6c 65 20 69 |that this.file i| 00000570 73 20 6e 65 61 72 6c 79 20 74 77 69 63 65 20 61 |s nearly twice a| 00000580 73 20 6c 6f 6e 67 20 28 61 6c 6d 6f 73 74 20 33 |s long (almost 3| 00000590 32 4b 29 20 61 73 20 74 68 65 20 6d 61 78 69 6d |2K) as the maxim| 000005a0 75 6d 20 73 69 7a 65 20 20 6f 66 20 20 72 6f 6d |um size of rom| 000005b0 0d 69 6d 61 67 65 20 20 62 65 69 6e 67 20 20 63 |.image being c| 000005c0 72 65 61 74 65 64 20 28 31 36 6b 29 2c 20 74 68 |reated (16k), th| 000005d0 69 73 20 69 73 20 62 65 63 61 75 73 65 20 65 61 |is is because ea| 000005e0 63 68 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e |ch command is in| 000005f0 69 74 69 61 6c 6c 79 0d 61 6c 6c 6f 77 65 64 20 |itially.allowed | 00000600 6d 65 73 73 61 67 65 20 73 70 61 63 65 20 6f 66 |message space of| 00000610 20 35 20 6c 69 6e 65 73 20 6f 66 20 20 34 30 20 | 5 lines of 40 | 00000620 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 57 68 | characters. Wh| 00000630 65 6e 20 20 74 68 65 20 20 66 69 6e 61 6c 0d 68 |en the final.h| 00000640 65 6c 70 66 69 6c 65 20 20 69 73 20 20 63 72 65 |elpfile is cre| 00000650 61 74 65 64 20 20 61 6c 6c 20 74 68 65 20 75 6e |ated all the un| 00000660 77 61 6e 74 65 64 20 73 70 61 63 65 73 20 61 72 |wanted spaces ar| 00000670 65 20 72 65 6d 6f 76 65 64 2c 20 74 68 65 20 65 |e removed, the e| 00000680 64 69 74 6f 72 0d 69 6e 63 6c 75 64 65 73 20 61 |ditor.includes a| 00000690 20 62 79 74 65 20 63 6f 75 6e 74 20 63 6f 6e 73 | byte count cons| 000006a0 74 61 6e 74 6c 79 20 75 70 64 61 74 65 64 20 6f |tantly updated o| 000006b0 6e 20 74 68 65 20 73 63 72 65 65 6e 20 74 6f 20 |n the screen to | 000006c0 68 65 6c 70 20 79 6f 75 20 75 73 65 0d 74 68 65 |help you use.the| 000006d0 20 61 76 61 69 6c 61 62 6c 65 20 73 70 61 63 65 | available space| 000006e0 20 65 66 66 69 63 69 65 6e 74 6c 79 2e 0d 0d 20 | efficiently... | 000006f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 | E| 00000710 44 49 54 4f 52 0d 0d 20 20 20 20 20 20 20 20 20 |DITOR.. | 00000720 20 54 68 65 20 65 64 69 74 6f 72 20 69 73 20 65 | The editor is e| 00000730 6e 74 65 72 65 64 20 61 74 20 63 6f 6d 6d 61 6e |ntered at comman| 00000740 64 20 6e 75 6d 62 65 72 20 31 2c 20 79 6f 75 20 |d number 1, you | 00000750 77 69 6c 6c 20 73 65 65 20 20 74 68 65 0d 63 75 |will see the.cu| 00000760 72 73 6f 72 20 6f 6e 20 74 68 65 20 63 6f 6d 6d |rsor on the comm| 00000770 61 6e 64 20 6c 69 6e 65 2c 20 62 65 6c 6f 77 20 |and line, below | 00000780 74 68 69 73 20 74 68 65 72 65 20 61 72 65 20 35 |this there are 5| 00000790 20 6c 69 6e 65 73 20 66 6f 72 20 74 79 70 69 6e | lines for typin| 000007a0 67 20 69 6e 0d 74 68 65 20 6d 65 73 73 61 67 65 |g in.the message| 000007b0 20 74 6f 20 62 65 20 64 69 73 70 6c 61 79 65 64 | to be displayed| 000007c0 2e 20 41 74 20 74 68 65 20 74 6f 70 20 72 69 67 |. At the top rig| 000007d0 68 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 |ht the number of| 000007e0 20 62 79 74 65 73 20 6c 65 66 74 0d 69 73 20 20 | bytes left.is | 000007f0 64 69 73 70 6c 61 79 65 64 2c 20 20 74 68 69 73 |displayed, this| 00000800 20 20 73 68 6f 75 6c 64 20 20 72 65 61 64 20 31 | should read 1| 00000810 36 31 35 37 20 66 6f 72 20 61 20 6e 65 77 20 62 |6157 for a new b| 00000820 6c 61 6e 6b 20 66 69 6c 65 2e 20 55 73 65 20 74 |lank file. Use t| 00000830 68 65 0d 63 75 72 73 6f 72 20 6b 65 79 73 20 74 |he.cursor keys t| 00000840 6f 20 6d 6f 76 65 20 61 72 6f 75 6e 64 20 74 68 |o move around th| 00000850 65 20 73 63 72 65 65 6e 2c 20 61 6e 79 74 68 69 |e screen, anythi| 00000860 6e 67 20 74 79 70 65 64 20 77 69 6c 6c 20 20 65 |ng typed will e| 00000870 69 74 68 65 72 20 20 62 65 0d 69 6e 73 65 72 74 |ither be.insert| 00000880 65 64 20 20 61 74 20 74 68 65 20 63 75 72 73 6f |ed at the curso| 00000890 72 20 70 6f 73 69 74 69 6f 6e 20 6f 72 20 77 69 |r position or wi| 000008a0 6c 6c 20 6f 76 65 72 77 72 69 74 65 20 63 75 72 |ll overwrite cur| 000008b0 72 65 6e 74 20 74 65 78 74 20 61 74 20 74 68 65 |rent text at the| 000008c0 0d 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e |.cursor position| 000008d0 2e 20 59 6f 75 20 63 61 6e 20 74 6f 67 67 6c 65 |. You can toggle| 000008e0 20 62 65 74 77 65 65 6e 20 69 6e 73 65 72 74 20 | between insert | 000008f0 61 6e 64 20 20 6f 76 65 72 20 20 6d 6f 64 65 73 |and over modes| 00000900 20 20 75 73 69 6e 67 0d 74 68 65 20 20 3c 43 4f | using.the <CO| 00000910 50 59 3e 20 20 6b 65 79 2c 20 20 74 68 65 20 63 |PY> key, the c| 00000920 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 |urrent state of | 00000930 74 68 69 73 20 73 77 69 74 63 68 20 62 65 69 6e |this switch bein| 00000940 67 20 64 69 73 70 6c 61 79 65 64 20 61 74 0d 74 |g displayed at.t| 00000950 68 65 20 62 6f 74 74 6f 6d 20 72 69 67 68 74 20 |he bottom right | 00000960 6f 66 20 74 68 65 20 73 63 72 65 65 6e 2e 20 43 |of the screen. C| 00000970 6f 6d 6d 61 6e 64 73 20 68 61 76 65 20 61 20 6d |ommands have a m| 00000980 61 78 69 6d 75 6d 20 6c 65 6e 67 74 68 20 6f 66 |aximum length of| 00000990 20 20 74 65 6e 0d 6c 65 74 74 65 72 73 20 20 61 | ten.letters a| 000009a0 6e 64 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 |nd are automatic| 000009b0 61 6c 6c 79 20 72 65 73 74 72 69 63 74 65 64 20 |ally restricted | 000009c0 62 79 20 74 68 65 20 65 64 69 74 6f 72 20 74 6f |by the editor to| 000009d0 20 75 70 70 65 72 20 63 61 73 65 2c 0d 6e 75 6d | upper case,.num| 000009e0 62 65 72 73 20 61 6e 64 20 74 68 65 20 63 68 61 |bers and the cha| 000009f0 72 61 63 74 65 72 73 3a 2d 20 20 2f 3c 3d 3e 3f |racters:- /<=>?| 00000a00 40 5b 5c 5d 5e 5f 23 20 20 69 2e 65 2e 20 20 63 |@[\]^_# i.e. c| 00000a10 68 61 72 61 63 74 65 72 73 20 20 6e 75 6d 62 65 |haracters numbe| 00000a20 72 65 64 0d 66 72 6f 6d 20 20 34 37 20 20 74 6f |red.from 47 to| 00000a30 20 20 39 36 2e 20 20 54 68 69 73 20 20 69 73 20 | 96. This is | 00000a40 6e 6f 74 20 6f 6e 6c 79 20 74 6f 20 65 6c 69 6d |not only to elim| 00000a50 69 6e 61 74 65 20 63 68 61 72 61 63 74 65 72 73 |inate characters| 00000a60 20 77 68 69 63 68 20 42 42 43 0d 42 61 73 69 63 | which BBC.Basic| 00000a70 20 20 6d 69 67 68 74 20 20 6d 69 73 69 6e 74 65 | might misinte| 00000a80 72 70 72 65 74 20 20 62 75 74 20 20 61 6c 73 6f |rpret but also| 00000a90 20 20 62 65 63 61 75 73 65 20 20 2a 48 45 4c 50 | because *HELP| 00000aa0 20 20 20 63 6f 6d 6d 61 6e 64 73 20 20 20 61 72 | commands ar| 00000ab0 65 0d 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 |e.automatically | 00000ac0 20 63 6f 6e 76 65 72 74 65 64 20 20 74 6f 20 75 | converted to u| 00000ad0 70 70 65 72 20 63 61 73 65 20 61 6e 64 20 77 6f |pper case and wo| 00000ae0 75 6c 64 20 6e 6f 74 20 62 65 20 72 65 63 6f 67 |uld not be recog| 00000af0 6e 69 73 65 64 20 69 66 0d 74 68 65 20 72 6f 6d |nised if.the rom| 00000b00 20 69 6d 61 67 65 20 20 63 6f 6e 74 61 69 6e 65 | image containe| 00000b10 64 20 20 6c 6f 77 65 72 20 20 63 61 73 65 20 20 |d lower case | 00000b20 63 6f 6d 6d 61 6e 64 73 2e 20 20 54 68 65 20 20 |commands. The | 00000b30 61 63 74 75 61 6c 20 20 6d 65 73 73 61 67 65 0d |actual message.| 00000b40 64 69 73 70 6c 61 79 65 64 20 6f 6e 20 74 68 65 |displayed on the| 00000b50 20 73 63 72 65 65 6e 20 69 73 20 6e 6f 74 20 6c | screen is not l| 00000b60 69 6d 69 74 65 64 20 69 6e 20 74 68 69 73 20 77 |imited in this w| 00000b70 61 79 20 61 6e 64 20 63 61 6e 20 63 6f 6e 74 61 |ay and can conta| 00000b80 69 6e 20 61 6e 79 0d 74 79 70 61 62 6c 65 20 63 |in any.typable c| 00000b90 68 61 72 61 63 74 65 72 2c 20 69 2e 65 2e 20 63 |haracter, i.e. c| 00000ba0 68 61 72 61 63 74 65 72 20 6e 75 6d 62 65 72 73 |haracter numbers| 00000bb0 20 33 32 20 74 6f 20 31 32 36 2e 0d 0d 20 20 20 | 32 to 126... | 00000bc0 20 20 20 20 20 20 20 45 61 63 68 20 6c 69 6e 65 | Each line| 00000bd0 20 6f 66 20 74 65 78 74 20 68 61 73 20 61 20 6c | of text has a l| 00000be0 69 6e 65 20 6c 69 6d 69 74 65 72 20 61 74 20 74 |ine limiter at t| 00000bf0 68 65 20 65 6e 64 20 22 7c 22 2c 20 74 68 69 73 |he end "|", this| 00000c00 20 69 73 0d 74 68 65 72 65 20 73 6f 20 74 68 61 | is.there so tha| 00000c10 74 20 79 6f 75 20 63 61 6e 20 22 73 65 65 22 20 |t you can "see" | 00000c20 61 6e 79 20 62 6c 61 6e 6b 20 73 70 61 63 65 73 |any blank spaces| 00000c30 20 6f 6e 20 61 20 6c 69 6e 65 2e 20 54 68 65 20 | on a line. The | 00000c40 62 79 74 65 73 20 6c 65 66 74 0d 63 6f 75 6e 74 |bytes left.count| 00000c50 20 20 69 73 20 20 61 75 74 6f 6d 61 74 69 63 61 | is automatica| 00000c60 6c 6c 79 20 75 70 64 61 74 65 64 20 61 73 20 79 |lly updated as y| 00000c70 6f 75 20 74 79 70 65 2c 20 62 75 74 20 79 6f 75 |ou type, but you| 00000c80 20 77 69 6c 6c 20 6e 6f 74 69 63 65 20 74 68 61 | will notice tha| 00000c90 74 0d 69 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 |t.if the command| 00000ca0 20 6c 69 6e 65 20 69 73 20 65 6d 70 74 79 20 74 | line is empty t| 00000cb0 68 65 6e 20 74 68 69 73 20 63 6f 75 6e 74 20 20 |hen this count | 00000cc0 77 69 6c 6c 20 20 72 65 6d 61 69 6e 20 20 75 6e |will remain un| 00000cd0 63 68 61 6e 67 65 64 2c 0d 0d 0d 0d 0d 0d 0d 0d |changed,........| 00000ce0 0d 0d 0d 0d 0d 74 68 69 73 20 20 69 73 20 62 65 |.....this is be| 00000cf0 63 61 75 73 65 20 77 68 65 6e 20 74 68 65 20 66 |cause when the f| 00000d00 69 6e 61 6c 20 72 6f 6d 20 69 6d 61 67 65 20 69 |inal rom image i| 00000d10 73 20 63 72 65 61 74 65 64 20 61 6c 6c 20 7a 65 |s created all ze| 00000d20 72 6f 20 63 6f 6d 6d 61 6e 64 73 0d 61 72 65 20 |ro commands.are | 00000d30 69 67 6e 6f 72 65 64 2e 20 53 69 6d 69 6c 61 72 |ignored. Similar| 00000d40 6c 79 20 61 6c 6c 20 7a 65 72 6f 20 6d 65 73 73 |ly all zero mess| 00000d50 61 67 65 20 6c 69 6e 65 73 20 77 69 6c 6c 20 62 |age lines will b| 00000d60 65 20 69 67 6e 6f 72 65 64 2c 20 69 66 20 20 79 |e ignored, if y| 00000d70 6f 75 0d 77 69 73 68 20 74 6f 20 73 70 61 63 65 |ou.wish to space| 00000d80 20 6f 75 74 20 79 6f 75 72 20 6d 65 73 73 61 67 | out your messag| 00000d90 65 73 20 74 68 65 6e 20 79 6f 75 20 77 69 6c 6c |es then you will| 00000da0 20 68 61 76 65 20 74 6f 20 70 75 74 20 61 74 20 | have to put at | 00000db0 6c 65 61 73 74 20 6f 6e 65 0d 62 6c 61 6e 6b 20 |least one.blank | 00000dc0 73 70 61 63 65 20 69 6e 20 74 68 65 20 6c 69 6e |space in the lin| 00000dd0 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 6d 65 |e between the me| 00000de0 73 73 61 67 65 73 2e 20 59 6f 75 20 63 61 6e 20 |ssages. You can | 00000df0 63 6f 6e 74 69 6e 75 65 20 74 6f 20 74 79 70 65 |continue to type| 00000e00 0d 65 76 65 6e 20 20 77 68 65 6e 20 20 74 68 65 |.even when the| 00000e10 20 62 79 74 65 73 20 63 6f 75 6e 74 20 69 73 20 | bytes count is | 00000e20 6d 69 6e 75 73 2c 20 74 68 6f 75 67 68 20 69 66 |minus, though if| 00000e30 20 79 6f 75 20 64 6f 20 6e 6f 74 20 67 6f 20 62 | you do not go b| 00000e40 61 63 6b 20 61 6e 64 0d 65 64 69 74 20 6f 74 68 |ack and.edit oth| 00000e50 65 72 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 72 |er commands to r| 00000e60 65 74 75 72 6e 20 74 68 65 20 62 79 74 65 20 63 |eturn the byte c| 00000e70 6f 75 6e 74 20 74 6f 20 70 6f 73 69 74 69 76 65 |ount to positive| 00000e80 20 74 68 65 6e 20 77 68 65 6e 20 74 68 65 0d 68 | then when the.h| 00000e90 65 6c 70 66 69 6c 65 20 69 73 20 63 72 65 61 74 |elpfile is creat| 00000ea0 65 64 20 79 6f 75 20 77 69 6c 6c 20 6c 6f 73 65 |ed you will lose| 00000eb0 20 61 6e 79 20 73 75 72 70 6c 75 73 20 63 6f 6d | any surplus com| 00000ec0 6d 61 6e 64 73 2e 20 54 68 65 20 72 6f 75 74 69 |mands. The routi| 00000ed0 6e 65 20 74 6f 0d 63 72 65 61 74 65 20 61 20 68 |ne to.create a h| 00000ee0 65 6c 70 66 69 6c 65 20 69 6e 63 6c 75 64 65 73 |elpfile includes| 00000ef0 20 69 74 73 20 6f 77 6e 20 62 79 74 65 20 63 6f | its own byte co| 00000f00 75 6e 74 20 63 68 65 63 6b 20 20 61 6e 64 20 20 |unt check and | 00000f10 77 69 6c 6c 20 20 65 6e 73 75 72 65 0d 74 68 61 |will ensure.tha| 00000f20 74 20 20 74 68 65 72 65 20 20 69 73 20 20 65 6e |t there is en| 00000f30 6f 75 67 68 20 20 73 70 61 63 65 20 20 6c 65 66 |ough space lef| 00000f40 74 20 62 65 66 6f 72 65 20 65 6e 63 6f 64 69 6e |t before encodin| 00000f50 67 20 65 61 63 68 20 63 6f 6d 6d 61 6e 64 2c 20 |g each command, | 00000f60 79 6f 75 0d 73 68 6f 75 6c 64 20 6e 65 76 65 72 |you.should never| 00000f70 20 65 6e 64 20 75 70 20 77 69 74 68 20 68 61 6c | end up with hal| 00000f80 66 20 61 20 6d 65 73 73 61 67 65 20 74 61 63 6b |f a message tack| 00000f90 65 64 20 6f 6e 20 61 74 20 74 68 65 20 20 65 6e |ed on at the en| 00000fa0 64 20 20 6f 66 20 20 74 68 65 0d 66 69 6c 65 2e |d of the.file.| 00000fb0 0d 0d 20 20 20 20 20 20 20 20 20 20 57 68 65 6e |.. When| 00000fc0 20 20 79 6f 75 20 20 68 61 76 65 20 20 66 69 6e | you have fin| 00000fd0 69 73 68 65 64 20 74 68 65 20 66 69 72 73 74 20 |ished the first | 00000fe0 63 6f 6d 6d 61 6e 64 20 70 72 65 73 73 20 3c 54 |command press <T| 00000ff0 41 42 3e 2c 20 79 6f 75 0d 6e 6f 77 20 68 61 76 |AB>, you.now hav| 00001000 65 20 74 68 65 20 63 68 6f 69 63 65 20 6f 66 20 |e the choice of | 00001010 65 69 74 68 65 72 20 70 72 65 73 73 69 6e 67 20 |either pressing | 00001020 3c 52 45 54 55 52 4e 3e 20 74 6f 20 67 6f 20 20 |<RETURN> to go | 00001030 6f 6e 74 6f 20 20 74 68 65 20 20 6e 65 78 74 0d |onto the next.| 00001040 63 6f 6d 6d 61 6e 64 2c 20 20 6f 72 20 20 65 6e |command, or en| 00001050 74 65 72 69 6e 67 20 20 74 68 65 20 20 63 6f 6d |tering the com| 00001060 6d 61 6e 64 20 20 6e 75 6d 62 65 72 20 20 79 6f |mand number yo| 00001070 75 20 77 69 73 68 20 74 6f 20 65 64 69 74 20 6e |u wish to edit n| 00001080 65 78 74 20 6f 72 0d 70 72 65 73 73 69 6e 67 20 |ext or.pressing | 00001090 3c 45 53 43 41 50 45 3e 20 74 6f 20 72 65 74 75 |<ESCAPE> to retu| 000010a0 72 6e 20 74 6f 20 74 68 65 20 6d 65 6e 75 2e 20 |rn to the menu. | 000010b0 4f 6e 20 70 72 65 73 73 69 6e 67 20 20 3c 54 41 |On pressing <TA| 000010c0 42 3e 20 20 74 68 65 20 20 64 61 74 61 0d 79 6f |B> the data.yo| 000010d0 75 20 68 61 76 65 20 6a 75 73 74 20 74 79 70 65 |u have just type| 000010e0 64 20 69 6e 20 77 69 6c 6c 20 62 65 20 73 74 6f |d in will be sto| 000010f0 72 65 64 20 6f 6e 20 64 69 73 6b 20 69 6e 20 74 |red on disk in t| 00001100 68 65 20 64 61 74 61 20 66 69 6c 65 2c 20 79 6f |he data file, yo| 00001110 75 20 64 6f 0d 6e 6f 74 20 20 68 61 76 65 20 20 |u do.not have | 00001120 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 77 68 |to create the wh| 00001130 6f 6c 65 20 72 6f 6d 20 69 6d 61 67 65 20 69 6e |ole rom image in| 00001140 20 6f 6e 65 20 73 69 74 74 69 6e 67 2c 20 61 6e | one sitting, an| 00001150 79 20 64 61 74 61 20 66 69 6c 65 0d 63 61 6e 20 |y data file.can | 00001160 62 65 20 65 64 69 74 65 64 20 6f 6e 65 20 63 6f |be edited one co| 00001170 6d 6d 61 6e 64 20 61 74 20 61 20 74 69 6d 65 20 |mmand at a time | 00001180 61 74 20 20 79 6f 75 72 20 20 63 6f 6e 76 65 6e |at your conven| 00001190 69 65 6e 63 65 20 20 75 73 69 6e 67 20 20 6d 65 |ience using me| 000011a0 6e 75 0d 6f 70 74 69 6f 6e 20 6e 75 6d 62 65 72 |nu.option number| 000011b0 20 32 2e 20 59 6f 75 20 63 61 6e 20 74 79 70 65 | 2. You can type| 000011c0 20 69 6e 20 61 6e 64 20 65 64 69 74 20 63 6f 6d | in and edit com| 000011d0 6d 61 6e 64 73 20 6f 75 74 20 6f 66 20 6f 72 64 |mands out of ord| 000011e0 65 72 20 61 73 20 61 6e 79 0d 62 6c 61 6e 6b 20 |er as any.blank | 000011f0 63 6f 6d 6d 61 6e 64 73 20 77 69 6c 6c 20 62 65 |commands will be| 00001200 20 69 67 6e 6f 72 65 64 2e 0d 0d 20 20 20 20 20 | ignored... | 00001210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001220 20 20 20 20 43 52 45 41 54 49 4e 47 20 41 20 48 | CREATING A H| 00001230 45 4c 50 46 49 4c 45 0d 0d 20 20 20 20 20 20 20 |ELPFILE.. | 00001240 20 20 20 43 68 6f 6f 73 65 20 20 6f 70 74 69 6f | Choose optio| 00001250 6e 20 20 33 20 20 61 6e 64 20 20 65 6e 74 65 72 |n 3 and enter| 00001260 20 20 74 68 65 20 20 66 69 6c 65 6e 61 6d 65 20 | the filename | 00001270 20 74 6f 20 62 65 20 75 73 65 64 20 66 6f 72 0d | to be used for.| 00001280 63 72 65 61 74 69 6e 67 20 74 68 65 20 66 69 6e |creating the fin| 00001290 69 73 68 65 64 20 72 6f 6d 20 69 6d 61 67 65 2c |ished rom image,| 000012a0 20 20 74 68 69 73 20 20 6d 75 73 74 20 20 62 65 | this must be| 000012b0 20 20 64 69 66 66 65 72 65 6e 74 20 20 66 72 6f | different fro| 000012c0 6d 20 20 74 68 65 0d 66 69 6c 65 6e 61 6d 65 20 |m the.filename | 000012d0 20 66 6f 72 20 20 74 68 65 20 20 64 61 74 61 66 | for the dataf| 000012e0 69 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 74 |ile from which t| 000012f0 68 65 20 66 69 6e 61 6c 20 68 65 6c 70 66 69 6c |he final helpfil| 00001300 65 20 69 73 20 63 72 65 61 74 65 64 2e 0d 4e 65 |e is created..Ne| 00001310 78 74 20 65 6e 74 65 72 20 74 68 65 20 64 61 74 |xt enter the dat| 00001320 61 66 69 6c 65 20 66 69 6c 65 6e 61 6d 65 20 61 |afile filename a| 00001330 6e 64 20 79 6f 75 20 77 69 6c 6c 20 73 65 65 20 |nd you will see | 00001340 74 68 65 20 20 63 6f 6d 6d 61 6e 64 73 20 20 62 |the commands b| 00001350 65 69 6e 67 0d 63 6f 75 6e 74 65 64 20 20 6f 66 |eing.counted of| 00001360 66 20 6f 6e 20 74 68 65 20 73 63 72 65 65 6e 2e |f on the screen.| 00001370 20 57 68 65 6e 20 74 68 69 73 20 70 72 6f 63 65 | When this proce| 00001380 73 73 20 69 73 20 66 69 6e 69 73 68 65 64 20 79 |ss is finished y| 00001390 6f 75 20 63 61 6e 20 65 78 69 74 0d 74 68 65 20 |ou can exit.the | 000013a0 70 72 6f 67 72 61 6d 20 61 6e 64 20 6c 6f 61 64 |program and load| 000013b0 20 74 68 65 20 68 65 6c 70 66 69 6c 65 20 69 6e | the helpfile in| 000013c0 74 6f 20 73 69 64 65 77 61 79 73 20 72 61 6d 2c |to sideways ram,| 000013d0 20 79 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 20 | you will need | 000013e0 74 6f 0d 70 72 65 73 73 20 20 3c 42 52 45 41 4b |to.press <BREAK| 000013f0 3e 20 20 74 6f 20 69 6e 69 74 69 61 6c 69 73 65 |> to initialise| 00001400 20 69 74 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 | it. This should| 00001410 20 64 69 73 70 6c 61 79 20 74 68 65 20 6e 61 6d | display the nam| 00001420 65 20 6f 66 20 79 6f 75 72 0d 68 65 6c 70 66 69 |e of your.helpfi| 00001430 6c 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 20 74 |le along with t| 00001440 68 65 20 20 6e 6f 72 6d 61 6c 20 20 73 74 61 72 |he normal star| 00001450 74 75 70 20 20 6d 65 73 73 61 67 65 73 2e 20 20 |tup messages. | 00001460 4e 6f 77 20 20 74 79 70 65 20 20 2a 48 45 4c 50 |Now type *HELP| 00001470 0d 3c 52 45 54 55 52 4e 3e 20 20 61 6e 64 20 74 |.<RETURN> and t| 00001480 68 69 73 20 73 61 6d 65 20 6d 65 73 73 61 67 65 |his same message| 00001490 20 77 69 6c 6c 20 62 65 20 64 69 73 70 6c 61 79 | will be display| 000014a0 65 64 2c 20 61 6e 79 20 6d 65 73 73 61 67 65 20 |ed, any message | 000014b0 63 61 6e 20 6e 6f 77 0d 62 65 20 64 69 73 70 6c |can now.be displ| 000014c0 61 79 65 64 20 62 79 20 74 79 70 69 6e 67 20 2a |ayed by typing *| 000014d0 48 2e 28 43 4f 4d 4d 41 4e 44 29 20 3c 52 45 54 |H.(COMMAND) <RET| 000014e0 55 52 4e 3e 2e 0d 0d 20 20 20 20 20 20 20 20 20 |URN>... | 000014f0 20 20 20 20 20 20 20 20 20 20 20 20 20 4f 50 45 | OPE| 00001500 52 41 54 49 4e 47 20 53 59 53 54 45 4d 20 43 4f |RATING SYSTEM CO| 00001510 4d 4d 41 4e 44 53 0d 0d 20 20 20 20 20 20 20 20 |MMANDS.. | 00001520 20 20 41 6e 79 20 2a 20 63 6f 6d 6d 61 6e 64 20 | Any * command | 00001530 20 63 61 6e 20 20 62 65 20 20 65 6e 74 65 72 65 | can be entere| 00001540 64 20 20 66 72 6f 6d 20 20 74 68 65 20 20 6d 65 |d from the me| 00001550 6e 75 20 20 65 69 74 68 65 72 20 20 62 79 0d 63 |nu either by.c| 00001560 68 6f 6f 73 69 6e 67 20 6f 70 74 69 6f 6e 20 34 |hoosing option 4| 00001570 20 6f 72 20 74 79 70 69 6e 67 20 3c 2a 3e 2e 20 | or typing <*>. | 00001580 54 68 65 20 70 72 6f 67 72 61 6d 20 69 6e 63 6c |The program incl| 00001590 75 64 65 73 20 61 20 2a 46 58 31 38 30 20 63 6f |udes a *FX180 co| 000015a0 6d 6d 61 6e 64 0d 77 68 69 63 68 20 20 73 65 74 |mmand.which set| 000015b0 73 20 20 4f 53 48 57 4d 20 20 28 6f 70 65 72 61 |s OSHWM (opera| 000015c0 74 69 6e 67 20 20 73 79 73 74 65 6d 20 20 68 69 |ting system hi| 000015d0 67 68 20 77 61 74 65 72 20 6d 61 72 6b 29 20 74 |gh water mark) t| 000015e0 6f 20 61 6e 20 61 64 64 72 65 73 73 0d 61 62 6f |o an address.abo| 000015f0 76 65 20 74 68 65 20 61 72 65 61 20 75 73 65 64 |ve the area used| 00001600 20 62 79 20 74 68 65 20 70 72 6f 67 72 61 6d 2e | by the program.| 00001610 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 | This means that| 00001620 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 20 20 77 68 | any command wh| 00001630 69 63 68 0d 77 6f 75 6c 64 20 20 6e 6f 72 6d 61 |ich.would norma| 00001640 6c 6c 79 20 20 63 6f 72 72 75 70 74 20 74 68 65 |lly corrupt the| 00001650 20 70 72 6f 67 72 61 6d 20 61 72 65 61 2c 20 73 | program area, s| 00001660 75 63 68 20 61 73 20 2a 42 41 43 4b 55 50 20 6f |uch as *BACKUP o| 00001670 72 20 2a 43 4f 4d 50 41 43 54 0d 63 61 6e 20 62 |r *COMPACT.can b| 00001680 65 20 69 73 73 75 65 64 20 66 72 6f 6d 20 20 77 |e issued from w| 00001690 69 74 68 69 6e 20 20 74 68 65 20 20 70 72 6f 67 |ithin the prog| 000016a0 72 61 6d 20 20 69 6e 20 20 63 6f 6d 70 6c 65 74 |ram in complet| 000016b0 65 20 20 73 61 66 65 74 79 2e 20 20 54 68 65 73 |e safety. Thes| 000016c0 65 0d 63 6f 6d 6d 61 6e 64 73 20 20 75 73 65 20 |e.commands use | 000016d0 74 68 65 20 61 72 65 61 20 66 72 6f 6d 20 4f 53 |the area from OS| 000016e0 48 57 4d 20 74 6f 20 48 49 4d 45 4d 20 61 73 20 |HWM to HIMEM as | 000016f0 61 6e 20 65 78 74 65 6e 64 65 64 20 64 69 73 6b |an extended disk| 00001700 20 62 75 66 66 65 72 2c 0d 4f 53 48 57 4d 20 69 | buffer,.OSHWM i| 00001710 73 20 6e 6f 72 6d 61 6c 6c 79 20 73 65 74 20 61 |s normally set a| 00001720 74 20 74 68 65 20 73 61 6d 65 20 61 64 64 72 65 |t the same addre| 00001730 73 73 20 61 73 20 50 41 47 45 20 20 74 68 65 72 |ss as PAGE ther| 00001740 65 62 79 20 20 63 6f 72 72 75 70 74 69 6e 67 0d |eby corrupting.| 00001750 61 6e 79 20 20 70 72 6f 67 72 61 6d 20 20 6f 72 |any program or| 00001760 20 20 64 61 74 61 20 73 74 6f 72 65 64 20 61 62 | data stored ab| 00001770 6f 76 65 20 50 41 47 45 2e 20 53 65 74 74 69 6e |ove PAGE. Settin| 00001780 67 20 4f 53 48 57 4d 20 61 62 6f 76 65 20 74 68 |g OSHWM above th| 00001790 65 20 61 72 65 61 0d 75 73 65 64 20 62 79 20 74 |e area.used by t| 000017a0 68 65 20 70 72 6f 67 72 61 6d 20 73 65 74 73 20 |he program sets | 000017b0 75 70 20 61 20 73 61 66 65 20 62 75 66 66 65 72 |up a safe buffer| 000017c0 20 61 72 65 61 2c 20 74 68 69 73 20 62 75 66 66 | area, this buff| 000017d0 65 72 20 69 73 20 73 6d 61 6c 6c 65 72 0d 74 68 |er is smaller.th| 000017e0 61 6e 20 75 73 75 61 6c 20 73 6f 20 2a 42 41 43 |an usual so *BAC| 000017f0 4b 55 50 20 77 69 6c 6c 20 72 65 71 75 69 72 65 |KUP will require| 00001800 20 6d 6f 72 65 20 70 61 73 73 65 73 20 61 6e 64 | more passes and| 00001810 20 20 77 69 6c 6c 20 20 74 61 6b 65 20 20 6c 6f | will take lo| 00001820 6e 67 65 72 0d 74 68 61 6e 20 75 73 75 61 6c 2e |nger.than usual.| 00001830 20 49 66 20 79 6f 75 20 75 73 65 20 74 68 69 73 | If you use this| 00001840 20 69 64 65 61 20 69 6e 20 79 6f 75 72 20 6f 77 | idea in your ow| 00001850 6e 20 70 72 6f 67 72 61 6d 20 62 65 20 63 61 72 |n program be car| 00001860 65 66 75 6c 20 6e 6f 74 20 74 6f 0d 69 73 73 75 |eful not to.issu| 00001870 65 20 20 74 68 65 20 20 4f 2f 53 20 20 63 6f 6d |e the O/S com| 00001880 6d 61 6e 64 20 20 66 72 6f 6d 20 20 77 69 74 68 |mand from with| 00001890 69 6e 20 20 61 20 70 72 6f 63 65 64 75 72 65 20 |in a procedure | 000018a0 6f 72 20 66 75 6e 63 74 69 6f 6e 20 61 73 20 74 |or function as t| 000018b0 68 65 0d 72 65 74 75 72 6e 20 61 64 64 72 65 73 |he.return addres| 000018c0 73 65 73 20 61 6e 64 20 6c 6f 63 61 6c 20 76 61 |ses and local va| 000018d0 72 69 61 62 6c 65 73 20 75 73 65 64 20 62 79 20 |riables used by | 000018e0 50 52 4f 43 73 20 61 6e 64 20 46 4e 73 20 61 72 |PROCs and FNs ar| 000018f0 65 20 20 73 74 6f 72 65 64 0d 6f 6e 20 74 68 65 |e stored.on the| 00001900 20 73 74 61 63 6b 20 62 65 6c 6f 77 20 48 49 4d | stack below HIM| 00001910 45 4d 20 61 6e 64 20 63 6f 75 6c 64 20 62 65 20 |EM and could be | 00001920 63 6f 72 72 75 70 74 65 64 2e 20 49 66 20 79 6f |corrupted. If yo| 00001930 75 20 61 72 65 20 63 72 65 61 74 69 6e 67 20 61 |u are creating a| 00001940 0d 68 65 6c 70 66 69 6c 65 20 20 77 69 74 68 20 |.helpfile with | 00001950 20 6d 61 6e 79 20 20 72 65 70 65 74 69 74 69 76 | many repetitiv| 00001960 65 20 20 6d 65 73 73 61 67 65 73 20 20 74 68 65 |e messages the| 00001970 6e 20 20 79 6f 75 20 63 61 6e 20 65 6e 74 65 72 |n you can enter| 00001980 20 61 20 2a 4b 45 59 0d 63 6f 6d 6d 61 6e 64 20 | a *KEY.command | 00001990 74 6f 20 73 65 74 75 70 20 74 68 65 20 66 75 6e |to setup the fun| 000019a0 63 74 69 6f 6e 20 6b 65 79 73 20 74 6f 20 74 79 |ction keys to ty| 000019b0 70 65 20 74 68 65 73 65 20 70 61 72 74 73 20 66 |pe these parts f| 000019c0 6f 72 20 79 6f 75 2e 0d 0d 0d 0d 0d 0d 0d 0d 0d |or you..........| 000019d0 0d 0d 0d 0d 0d 20 20 20 20 20 20 20 20 20 20 20 |..... | 000019e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000019f0 20 43 4f 4d 50 41 54 49 42 49 4c 49 54 59 0d 0d | COMPATIBILITY..| 00001a00 20 20 20 20 20 20 20 20 20 20 54 68 69 73 20 70 | This p| 00001a10 72 6f 67 72 61 6d 20 68 61 73 20 62 65 65 6e 20 |rogram has been | 00001a20 74 65 73 74 65 64 20 6f 6e 20 61 20 42 42 43 20 |tested on a BBC | 00001a30 20 42 20 20 77 69 74 68 20 20 61 6e 20 20 69 73 | B with an is| 00001a40 73 75 65 20 20 37 0d 62 6f 61 72 64 20 20 61 6e |sue 7.board an| 00001a50 64 20 20 4f 2f 53 20 31 2e 32 2f 41 43 4f 52 4e |d O/S 1.2/ACORN| 00001a60 20 44 46 53 20 31 2e 32 2c 20 75 73 69 6e 67 20 | DFS 1.2, using | 00001a70 53 6f 6c 69 64 69 73 6b 27 73 20 32 4d 48 5a 20 |Solidisk's 2MHZ | 00001a80 32 35 36 4b 20 73 69 64 65 77 61 79 73 0d 72 61 |256K sideways.ra| 00001a90 6d 20 28 77 69 74 68 20 61 6e 64 20 77 69 74 68 |m (with and with| 00001aa0 6f 75 74 20 61 20 36 35 30 32 20 73 65 63 6f 6e |out a 6502 secon| 00001ab0 64 20 70 72 6f 63 65 73 73 6f 72 29 2e 20 49 74 |d processor). It| 00001ac0 20 68 61 73 20 61 6c 73 6f 20 62 65 65 6e 20 20 | has also been | 00001ad0 75 73 65 64 0d 6f 6e 20 20 61 6e 20 69 64 65 6e |used.on an iden| 00001ae0 74 69 63 61 6c 20 6d 61 63 68 69 6e 65 20 66 69 |tical machine fi| 00001af0 74 74 65 64 20 77 69 74 68 20 53 6f 6c 69 64 69 |tted with Solidi| 00001b00 73 6b 27 73 20 6f 72 69 67 69 6e 61 6c 20 53 57 |sk's original SW| 00001b10 52 31 32 38 20 61 6e 64 20 6f 6e 0d 74 68 65 20 |R128 and on.the | 00001b20 73 61 6d 65 20 6d 61 63 68 69 6e 65 20 66 69 74 |same machine fit| 00001b30 74 65 64 20 77 69 74 68 20 41 63 6f 72 6e 20 55 |ted with Acorn U| 00001b40 73 65 72 27 73 20 31 36 4b 20 55 73 65 72 52 41 |ser's 16K UserRA| 00001b50 4d 2e 20 20 54 68 65 72 65 20 20 61 72 65 20 20 |M. There are | 00001b60 6e 6f 0d 69 6c 6c 65 67 61 6c 20 20 70 65 65 6b |no.illegal peek| 00001b70 73 20 20 6f 72 20 20 70 6f 6b 65 73 2c 20 20 61 |s or pokes, a| 00001b80 6e 64 20 20 6f 6e 6c 79 20 77 65 6c 6c 20 64 6f |nd only well do| 00001b90 63 75 6d 65 6e 74 65 64 20 6f 70 65 72 61 74 69 |cumented operati| 00001ba0 6e 67 20 73 79 73 74 65 6d 0d 63 61 6c 6c 73 20 |ng system.calls | 00001bb0 61 72 65 20 75 73 65 64 20 73 6f 20 69 74 20 73 |are used so it s| 00001bc0 68 6f 75 6c 64 20 77 6f 72 6b 20 77 69 74 68 20 |hould work with | 00001bd0 61 6c 6c 20 42 42 43 20 74 79 70 65 20 6d 61 63 |all BBC type mac| 00001be0 68 69 6e 65 73 20 20 69 6e 63 6c 75 64 69 6e 67 |hines including| 00001bf0 0d 74 68 65 20 45 4c 45 43 54 52 4f 4e 20 61 6e |.the ELECTRON an| 00001c00 64 20 43 4f 4d 50 41 43 54 2e 0d 0d 20 20 20 20 |d COMPACT... | 00001c10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001c20 20 20 20 20 20 20 20 20 20 20 20 20 46 58 48 45 | FXHE| 00001c30 4c 50 0d 0d 20 20 20 20 20 20 20 20 20 20 42 72 |LP.. Br| 00001c40 6f 61 64 63 61 73 74 20 20 77 69 74 68 20 74 68 |oadcast with th| 00001c50 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 61 6e |is program is an| 00001c60 20 65 78 61 6d 70 6c 65 20 68 65 6c 70 66 69 6c | example helpfil| 00001c70 65 20 28 46 58 48 45 4c 50 29 0d 74 6f 67 65 74 |e (FXHELP).toget| 00001c80 68 65 72 20 77 69 74 68 20 74 68 65 20 64 61 74 |her with the dat| 00001c90 61 66 69 6c 65 20 75 73 65 64 20 69 6e 20 69 74 |afile used in it| 00001ca0 73 20 63 72 65 61 74 69 6f 6e 20 28 46 58 44 41 |s creation (FXDA| 00001cb0 54 41 29 2e 20 20 54 68 69 73 20 20 67 69 76 65 |TA). This give| 00001cc0 73 0d 68 65 6c 70 20 20 6d 65 73 73 61 67 65 73 |s.help messages| 00001cd0 20 20 6f 6e 20 20 61 6c 6c 20 20 74 68 65 20 20 | on all the | 00001ce0 61 76 61 69 6c 61 62 6c 65 20 20 46 58 20 20 63 |available FX c| 00001cf0 6f 6d 6d 61 6e 64 73 2c 20 20 6c 6f 61 64 20 74 |ommands, load t| 00001d00 68 69 73 20 69 6e 74 6f 0d 73 69 64 65 77 61 79 |his into.sideway| 00001d10 73 20 72 61 6d 2c 20 70 72 65 73 73 20 3c 42 52 |s ram, press <BR| 00001d20 45 41 4b 3e 20 61 6e 64 20 79 6f 75 20 73 68 6f |EAK> and you sho| 00001d30 75 6c 64 20 73 65 65 20 74 68 65 20 6d 65 73 73 |uld see the mess| 00001d40 61 67 65 3a 2d 0d 0d 20 20 20 20 20 20 20 20 20 |age:-.. | 00001d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001d60 20 48 65 6c 70 20 46 69 6c 65 20 3a 20 46 58 48 | Help File : FXH| 00001d70 45 4c 50 0d 0d 54 79 70 69 6e 67 20 2a 48 2e 46 |ELP..Typing *H.F| 00001d80 58 48 45 4c 50 20 20 77 69 6c 6c 20 20 64 69 73 |XHELP will dis| 00001d90 70 6c 61 79 20 20 61 20 20 6c 69 73 74 20 20 6f |play a list o| 00001da0 66 20 20 74 68 65 20 20 61 76 61 69 6c 61 62 6c |f the availabl| 00001db0 65 20 20 46 58 20 20 68 65 6c 70 0d 6d 65 73 73 |e FX help.mess| 00001dc0 61 67 65 73 2c 20 66 6f 72 20 65 78 61 6d 70 6c |ages, for exampl| 00001dd0 65 20 2a 48 2e 46 58 30 20 77 69 6c 6c 20 64 69 |e *H.FX0 will di| 00001de0 73 70 6c 61 79 3a 2d 0d 0d 20 20 20 20 20 20 20 |splay:-.. | 00001df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001e00 20 20 20 20 20 20 50 72 69 6e 74 20 4f 53 20 4e | Print OS N| 00001e10 6f 2e 0d 0d 49 66 20 20 79 6f 75 20 20 63 61 6e |o...If you can| 00001e20 20 63 72 65 61 74 65 20 61 20 72 65 61 6c 6c 79 | create a really| 00001e30 20 75 73 65 66 75 6c 20 68 65 6c 70 66 69 6c 65 | useful helpfile| 00001e40 20 77 68 79 20 6e 6f 74 20 73 65 6e 64 20 69 74 | why not send it| 00001e50 20 69 6e 20 74 6f 20 74 68 65 0d 42 42 43 20 54 | in to the.BBC T| 00001e60 65 6c 65 73 6f 66 74 77 61 72 65 20 73 65 72 76 |elesoftware serv| 00001e70 69 63 65 20 66 6f 72 20 62 72 6f 61 64 63 61 73 |ice for broadcas| 00001e80 74 69 6e 67 3f 0d |ting?.| 00001e86