Home » CEEFAX disks » telesoftware6.adl » 28-03-88/HLP\INF

28-03-88/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 » telesoftware6.adl
Filename: 28-03-88/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:

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
28-03-88/HLP\INF.m0
28-03-88/HLP\INF.m1
28-03-88/HLP\INF.m2
28-03-88/HLP\INF.m4
28-03-88/HLP\INF.m5