home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / bbc / progs / 65loader / !65Loader / !Help next >
Encoding:
Text File  |  1992-10-17  |  7.0 KB  |  154 lines
  1. !65Loader Version r3 1.00                                          !Help file
  2. -----------------------------------------------------------------------------
  3. Version    : r3 1.00 (17-Oct-92)
  4.  
  5. Written by Derek Dawson, (c) Armour Software 1992.
  6.  
  7. Program Information
  8. ===================
  9. !65Loader is a small utility that is ideal for quickly loading BBC BASIC
  10. programs and other BBC programs directly into !65Host by simply double
  11. clicking on the BBC file from the RISC OS Desktop.
  12. After the computer has seen both the !65Host and !65Loader applications
  13. (ie. after a directory viewer containing !65Host and !65Loader has been
  14. opened),clicking on a BBC Basic or BBC ROM file will automatically enter
  15. the !65Host environment with the file loaded.
  16.  
  17. You can easily alter the action taken when a file is to be loaded into
  18. the emulator by editing the 'ScriptFile' text file within the !65Loader
  19. directory.
  20. You can add details of how to load different types of files (for example
  21. View files) or indeed alter how !65Loader deals with BBC Basic or BBC ROM
  22. files (for example you may simply wish to LOAD a BBC Basic program rather
  23. than CHAIN it).
  24.  
  25. Running Instructions
  26. ====================
  27. 65Loader requires a temporary file to be created each time it is run. This
  28. file has to be stored on disc. By default, it is set to be created inside
  29. the 65Loader directory. The disc you are storing 65Loader on must at ALL
  30. times have write access (ie. if you are storing 65Loader on a floppy disc
  31. then you must not write protect it.)
  32. It is a good idea to keep 65Loader and 65Host together on a disc (or in 
  33. a sub-directory on a hard disc).
  34. If you are a floppy disc user then it is a even better idea to load !65Host
  35. (by double clicking on !65Host and then typing *QUIT) and then copying 
  36. !65Loader into the RAM disc, and then double clicking on the RAM disc copy 
  37. of !65Loader. This will dramatically cut down on disc swaps.
  38.  
  39. How to modify the Script file (Experienced Users Only)
  40. ============================= ------------------------
  41. The Script file should be loaded in to Edit to alter it.First load !Edit
  42. (from App Disc 1 on RISC OS 2 Machines or from the 'Apps' icon on the icon
  43. bar on RISC OS 3 Machines)
  44. Then hold down shift and double click on the !65Loader icon whilst keeping
  45. shift held down. Release shift.
  46. Double click on the 'ScriptFile' text file and the file will be loaded into
  47. !Edit.
  48.  
  49. The first line must always contain the following:
  50. 65Loader Script File
  51. followed by the script file format number.
  52.  
  53. The second line contains the 65Host Boot Options (see user guide for !65Host)
  54. which you should never need to change. It is as follows:
  55. boot:&803
  56.  
  57. The third line contains the filename of the temporary file that 65Loader
  58. creates each time you load a BBC file. It can be changed as desired (eg.
  59. for use on Econet then the file should be something like net:&.Scrap). 
  60. file:<65Loader$Dir>.LoaderFile
  61.  
  62. The fourth line is a separation line which contains several dashes -----.
  63.                                                                   
  64. From now on the following format must be adhered to for each file type.
  65. 1) The line after the dashes should contain the actual file type and file
  66.    type name of a BBC file you wish to have loaded into the emulator when
  67.    you double click on it.
  68.    First should come the file type number (such as &F1B) followed by the
  69.    file type name (such as BBCBasic)
  70.    For example:
  71.    &F1B BBCBasic                        
  72.    or:
  73.    &001 BBC View
  74. 2) The following lines should contain lines which will be run when the
  75.    BBC Emulator has just run.
  76.    Each following line should start with the greater than symbol (>)
  77.    The directory in which the BBC file is stored is represented by <Dir>
  78.    The filename of the BBC file is represented by <File>
  79.    (Note that it must be typed exactly as <File> or <Dir>)
  80.    For example imagine all BBCBasic files have to loaded in the following
  81.    way: Enter the directory in which the file is stored, Enter Basic, 
  82.    Provide a comment, Load the file, list the file.
  83.    The following lines in the script file should look like:
  84.    >*Dir <Dir>
  85.    >*Basic
  86.    >REM We are now in BASIC
  87.    >LOAD "<File>"
  88.    >LIST         
  89. 3) The last line should be a line of dashes as before
  90.  
  91. 4) The relevant !Sprites file should be edited if desired or required.
  92.    Copy the existing file_f1b sprite and rename it to file_xxx where xxx
  93.    is the file type number.
  94.  
  95. Always make a copy of the script file for backup purposes in case you 
  96. make a serious error in altering it.
  97. The error message '65Loader Script file is invalid.' will be displayed
  98. if there has been an error in the ScriptFile
  99. The error message 'Script file has ended.' also means there has been an
  100. error in the ScriptFile.
  101. If any of these two errors occur, first check the file for any spaces/new
  102. lines that may have appeared then check what you have typed.
  103.  
  104. Corrections since Release 2 Version 5.01
  105. ========================================
  106.  
  107. Thanks very much to Rob Wilcox for writing me such a nice letter and 
  108. informing me of problems with 65Loader and SCSI Hard Discs. This bug
  109. has now been fixed.
  110. All versions that have been released before this one have been very unstable
  111. and classifying them as 'bug-free' would have been an understatement.
  112. This (Release 3, Version 1.00) is a completely new version (65Loader has
  113. been completely re-written) and as such may contain some small bugs which
  114. my testing has not highlighted or my system will not create.
  115.  
  116. Communication!
  117. ==============
  118. If my documentation has proved very complex,baffling or annoying please write
  119. and tell me! On the other-hand if you have modified any part of this
  120. application then write and tell me (it is illegal to distribute a modified
  121. version of this application without prior written permission from Armour
  122. Software). If you have the mind but not the skill then please write and
  123. inform me of any ideas you have as to the future of this application!
  124. If you do modify !65Loader then it may be wise to write to me first to
  125. ensure that you have the latest version yourself (it is not much good
  126. correcting an old already corrected bug - is it?)
  127. Please enclose a stamped addressed envelope to guarantee a reply.
  128.  
  129. To obtain the latest version of 65Loader and receive some other applications,
  130. please write to the address below including a suitable envelope; suitable
  131. postage and a blank formatted disc (High or double density)
  132.  
  133. In general,please write to me!
  134.  
  135. My address is  : Derek Dawson
  136.                  Armour Software,
  137.                  Hillsview,
  138.                  Station Road,
  139.                  Rothienorman,
  140.                  INVERURIE,
  141.                  Aberdeenshire,
  142.                  AB51 8YE.
  143. My phone no. is: (0651) 81251 : Please phone after 6.00pm Mon-Fri or any
  144.                                 reasonable time at the weekend!
  145.  
  146. Standard disclaimer details are available on request from Armour Software -
  147. quote ref: 'AS- Disclaimer'
  148.  
  149. This application is Public Domain Software. As such it may be distributed
  150. by everybody for free. However, I (the author) will make no hesitation at
  151. turning down huge cheques,massive sums of money or gifts from any rich
  152. millionaire who wishes to be very kind and share his or her fortune.
  153.  
  154.