home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / bbc / progs / riscos2 / isheet / !ISheet / Instrucs < prev    next >
Encoding:
Text File  |  1993-04-12  |  12.2 KB  |  272 lines
  1.  
  2.                 ======================================
  3.                 Intersheet from the Archimedes Desktop 
  4.                 ======================================
  5.  
  6.                Version 4.3 - For RiscOS 3 - October 1992
  7.  
  8.                       Copyright D.J.Holden 1989
  9.  
  10.  
  11. This application will enable you to run the BBC ROM versions of
  12. Intersheet from the Archimedes desktop and will make it respond to
  13. 'file clicking' in the proper RiscOS manner.
  14.  
  15. As well as this program there are similar utilities for InterWord,
  16. (Archimedes disc version), View, ViewSheet, ViewStore and WordWise
  17. Plus (Archimedes disc version). If you have one of these programs then
  18. contact me to ask for details. If you have any other BBC ROMs that you
  19. wish to use on the Archimedes then if you send me a disc with a copy of
  20. the ROM (and an SAE please) I will try to help.
  21.  
  22. Please note that in order to make this application work I have been
  23. forced to use some 'crude and dirty' programming methods. Normally this
  24. is transparent to the user and doesn't cause any difficulty.
  25.  
  26. I offer no warranty for the operation of this program, nor will I 
  27. accept any responsibility for its operation or suitability for any
  28. purpose or for any damage or loss of data caused by its use.
  29.  
  30. Although Intersheet will take over the whole screen when running it
  31. otherwise behaves like any other RiscOS application and when you
  32. return to the Desktop any other programs you are running will continue
  33. as before. The only problem is that you can't leave Intersheet to
  34. return to the Desktop temporarily. If you do this without saving your
  35. Interword file your data will (probably) be lost.
  36.  
  37. You will also find that the function keys work correctly. That is they
  38. are in the same PLACE as they are on the BBC computer ie. one NUMBER
  39. higher. You no longer need to press the Print key for F0. You will also
  40. find that the pound key works correctly and the "`" key (the key below
  41. the ESC key) now produces the "'" character so you can transfer files
  42. back to a BBC computer.
  43.  
  44. Note that this program has so far only been briefly tested with version
  45. 1.06 of the Intersheet ROM. I don't normally use Intersheet and don't
  46. have a copy of the Manual so I haven't been able to test it properly. If
  47. you do have problems or have a different version and the program doesn't
  48. work properly then send me a disc with a copy of your version of the
  49. Intersheet ROM (and an SAE please) and I will try to help.
  50.  
  51.  
  52.      Setting up the Application
  53.      ~~~~~~~~~~~~~~~~~~~~~~~~~~
  54.  
  55. TO START:
  56.   Add the 65Tube program which is found on this disc into this directory
  57.  
  58.  
  59. 1.   You must get a copy of your Intersheet ROM onto an Archimedes disc
  60.      and copy it to the !ISheet directory.  For obvious copyright reasons
  61.      I can't supply this. Make sure that it is called SHEET and rename it
  62.      if necessary. If you do have any difficulty then contact me and I
  63.      may be able to help.
  64.  
  65. 2.   Open the !ISheet directory and double-click on the !Convert icon.
  66.      You should now find that a new file 'ISheetMod' has appeared in
  67.      the !ISheet directory. Once you have done this and tested the
  68.      program the ROM image SHEET and the !Convert directory is no longer
  69.      required and can be deleted from your 'working' copy of the program.
  70.  
  71. 3.   You will need a copy of the 6502 Emulator 65Tube in the !ISheet
  72.      directory. This may or may not be included. It is sometimes removed
  73.      to save space. If it isn't there then copy it from the RiscOS
  74.      applications disc. Hard disc users may prefer not to have the 
  75.      emulator in the application directory. In this case just change the
  76.      line in the !Run file which loads the emulator. Note that unlike
  77.      Interword Intersheet will NOT work with 65Arthur.
  78.  
  79.  
  80.      Running !ISheet
  81.      ~~~~~~~~~~~~~~~
  82. Double-click on the !ISheet application icon and it will install itself
  83. on the icon bar. If you click MENU (the middle mouse button) on this
  84. icon a menu will appear with the two normal 'Info' and 'Quit' items.
  85. If you click SELECT (the left mouse button) you will start up
  86. Intersheet at the Main Menu with no file loaded.
  87.  
  88.  
  89.      Loading Files
  90.      ~~~~~~~~~~~~~
  91. If the file is an Intersheet file which has it's filetype set to &D81
  92. it can be loaded by 'double-clicking' on the file icon. If RiscOs has
  93. 'seen' the !ISheet application then double-clicking on an Intersheet
  94. file will start up !ISheet and load the file.
  95.  
  96. To run ISheet by clicking on an Intersheet file without RiscOS seeing
  97. the !ISheet icon insert the following line in your system !Boot file,
  98. where <path> is the full path of the !ISheet application.
  99.  
  100.      SetAlias$@RunType_D81  Run <path>.!ISheet.!Run *%0
  101.  
  102. If the file does not have the correct filetype you can load it by
  103. dragging the file icon to the ISheet icon on the icon bar. Note that if
  104. you do this no checks are made to see that it actually an Intersheet
  105. file. I assume that you know what you are doing. If it is not actually
  106. an Intersheet file you could crash the program.
  107.  
  108. In either case the Currently Selected Directory (CSD) will be set to the
  109. directory the file is in so that you can save the file from the normal
  110. Intersheet menu.
  111.  
  112. If you drag a directory icon to the ISheet icon the CSD will be set to
  113. that directory. Interword will then be started up at the 'Load File'
  114. prompt so you can enter the name of any file in the directory.
  115.  
  116. You can of course load files from the Intersheet Load File prompt in the
  117. normal way.
  118.  
  119.  
  120.      Setting Filetypes
  121.      ~~~~~~~~~~~~~~~~~
  122. The version of Intersheet that I have does not set the filetype of files
  123. that are saved although there is an official filetype for them (D81)
  124. although I believe that the Archimedes version of Intersheet does do
  125. this. Similarly any files transferred from a BBC micro will not have a
  126. filetype set. To make it easier to identify files and to enable the
  127. filetype of a BBC file to be easily set I have included a facility to
  128. set the filetypes of these. This will also set the filetypes of
  129. Interword files. I have assigned the 'master' file of an Interword
  130. multi-file document a filetype of D7F and the 'leaf' files a filetype of
  131. D7E and included sprites for these.
  132.  
  133. To set the filetype of these or a BBC Interword or Intersheet file drag
  134. the file icon to the ISheet icon while holding down the SHIFT key. A
  135. menu will appear with the choice of Intersheet, Normal IWord,
  136. Multi-Master or Multi-Leaf. Simply click on the required one to set the
  137. type of the file.
  138.  
  139. At present no checks are made to ensure that the file is actually of the
  140. type you have selected.
  141.  
  142. Once you have set the type of a file in this way double-clicking on it
  143. will start ISheet and load the file. Unfortunately once a file has been
  144. loaded into Intersheet and saved it will lose it's filetype again so I'm
  145. afraid you will need to re set it each time.
  146.  
  147.  
  148.      Screen Blanking
  149.      ~~~~~~~~~~~~~~~
  150. When ISheet is started by dragging or clicking on a file there is an
  151. annoying sequence where you jump from the Desktop to the main Interword
  152. menu, wait while the file is loaded and then jump to the edit screen. To
  153. avoid this eyeball-searing flicking between screens a command *ISBLANK
  154. is provided which will blank the screen while this is going on.
  155.  
  156. This command is normally followed by the time in 1/100ths of a second
  157. during which you wish the screen to be blanked. Normally the command
  158. will be placed in the !Run file but it can be entered from the keyboard
  159. if required. Entering *ISBLANK without a following number will show the
  160. current setting.
  161.  
  162. By default it is set to 150 (one and a half seconds) which seems to be
  163. about right if you are loading files from floppies. You may need to make
  164. this shorter if you are loading files from a hard disc or have an ARM 3
  165. or longer if you are using 640K floppies or long files. If you don't
  166. want to use the blanking feature then just use *ISBLANK 0
  167.  
  168.  
  169.      Cumputer 'hangs' with blank screen
  170.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  171. An unfortunate consequence of the screen blanking is that any error
  172. messages during this sequence may not be displayed and everything
  173. will appear to stop displaying a blank screen. This normally means
  174. that you have forgotten to insert the right disc or something similar.
  175.  
  176. In theory it shouldn't happen because the program checks that the file
  177. actually exists and can be read before leaving the desktop, so if you
  178. have just forgotten to put the correct disc in the drive you will get
  179. the usual Filing System error message.
  180.  
  181. However under certain circumstances it is possible for an error to occur
  182. while the screen is disabled.
  183.  
  184. DON'T PANIC. Just press ESCAPE and you will return to the desktop where
  185. you can try to find out what went wrong. The most likely cause of this
  186. type of error is a corrupted file. To check this try to load it into
  187. Edit by dragging the file icon to the Edit icon on the icon bar.
  188.  
  189.  
  190.      Leaving Intersheet
  191.      ~~~~~~~~~~~~~~~~~~
  192. When you have finished with Intersheet DON'T PRESS RESET. Remember that
  193. although you are running a program under the 6502 emulator you are still
  194. in the Desktop, you just can't see it. Just type *QUIT (or *Q.) at the
  195. Intersheet command line and you will return to the Desktop which should
  196. be just the way you left it.
  197.  
  198.  
  199.      Known Bugs
  200.      ~~~~~~~~~~
  201. There are two problems that I know of with this program at present. 
  202.  
  203.  
  204. There is a minor problem (with RiscOS 3 only) when Interword switches
  205. from the Menu to the Load/Save screens. In theory the screen should be
  206. blanked during this transition but under RiscOS 3 the blanking method
  207. used by Interword doesn't seem to work. This is not too serious however,
  208. and since curing the problem would involve altering the Interword code,
  209. which I have so far avoided doing, I shall ignore it for the present.
  210.  
  211.  
  212. Another problem exists if you press RESET while !IWord is loaded or
  213. running. This will remove the desktop 'front end' program but leave the
  214. two modules intact. In theory this shouldn't cause any problems but
  215. sometimes it can if you then run !IWord again. In theory everything
  216. should be OK but sometimes it isn't and strange 'Address Exception' and
  217. 'Bad String' errors can occur. I don't know why this happens but it
  218. isn't unique to !IWord as I have observed the same type of errors with
  219. other programs which operate as a combination of 'front end' and Module.
  220.  
  221. The cure is obviously to always 'kill' the modules 'IWordDrivers' and
  222. IWordMod' whenever you 'quit' the program. If you select 'Quit' in the
  223. ususal way this will be done, but obvioulsly pressing RESET bypasses
  224. this action.
  225.  
  226. To save you the trouble of pressing F12 and typing the commands I have
  227. included a file called 'KillMod' in the Application directory. If in
  228. doubt just open the !IWord directory and double-click on the KillMod
  229. icon and this will make sure that the modules are removed.
  230.  
  231.  
  232.      Licence to Use and Copy
  233.      ~~~~~~~~~~~~~~~~~~~~~~~
  234. This program is not Public Domain. The program and all associated
  235. material including this file are all Copyright D.J.Holden. Anyone may
  236. make personal use of it without restriction. You may only copy and/or
  237. distribute the program subject to the following conditions.
  238.  
  239. 1.   You must copy the compete !ISheet application with all it's
  240.      auxiliary files, !Run, !Boot, ReadMe, ISheet, !Sprites, Templates
  241.      and the !Convert application.
  242.  
  243. 2.   You must not make any alteration to any of these files     
  244.      although you may modify the !Boot and !Run files if necessary to
  245.      suit your distribution discs.
  246.  
  247. 3.   You must ensure that you do not copy an ISheetMod file as this will
  248.      contain code which is copyright Computer Concepts and must be
  249.      provided by the user.
  250.  
  251. 4.   You must not make any charge for the program or for any additional
  252.      material that you might supply. You may make a charge to cover
  253.      media, postage, overheads, etc.
  254.  
  255. 5.   If you are running a P.D. library or are otherwise making any
  256.      charge for copying this program, whether in fee or in  kind, even
  257.      if this fee is donated to charity, you are obliged to notify me
  258.      that you are distributing !ISheet. I would appreciate a disc with a
  259.      selection from your Library and I will respond by sending you the
  260.      latest version and a selection of others.
  261.  
  262.  
  263. In the event of any problems or if you have any suggestions for
  264. improvements please contact me.
  265.  
  266.                         David Holden
  267.                         39 Knighton Park Road
  268.                         Sydenham
  269.                         London SE26 5RN
  270.  
  271.                         081 778 2659 
  272.