home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 5 / RISCWORLD_VOL5.iso / SOFTWARE / Issue1 / BASIC / Text_BBC / ReadMe1st
Encoding:
Text File  |  2004-04-29  |  3.0 KB  |  67 lines
  1.  
  2. !Text_BBC - Text to BBC Basic Translator © Martin Carradus 2004
  3. ======================================================
  4.  
  5. Using !Text_BBC
  6. =============
  7.  
  8. NB This program will only work on writable media, not CD ROMs!
  9.  
  10. This program is shareware.
  11.  
  12. Having unzipped the compressed file containing the !Text_BBC
  13. application, drag the whole application to the directory that you wish
  14. to keep it in.
  15.  
  16. Double click on the !Text_BBC icon, an icon then appears on the icon
  17. bar, then drag a Text file to the bar icon, or left click on the
  18. bar icon and drag the Text file to the 'SetUp' panel that appears.
  19. This enters the file name into the upper slot on the panel.
  20. Alternatively the file name may be typed manually into this slot.
  21.  
  22. Select the appropriate options on the 'SetUp' panel, then click on the
  23. 'Run' icon on this panel. After a while a BBC Basic file is offered
  24. for saving in the same directory as the Text, but with its name
  25. prefixed with a capital "B".
  26.  
  27. Selecting the 'Help' or 'Description' buttons on the 'SetUp' panel and
  28. clicking on the 'Run' button gives out extra information.
  29.  
  30. Additional Help is available by clicking the middle 'Menu' button over
  31. the bar icon and clicking over the 'Help' entry on the menu that
  32. appears, or by using the Acorn !Help application in the 'Apps'
  33. directory on the icon bar.
  34.  
  35. Other programmers' tools are available from 'www.martinkd.freeuk.com',
  36. or from 'www.melotech.co.uk', in particular, shortly, a GW-BASIC to
  37. BBC Basic Translator.
  38.  
  39. Please read the Text file !ReadMe within this application for conditions
  40. of use. (Hold down 'Shift' and double click over the application icon.)
  41.  
  42. Martin Carradus 2004.
  43.  
  44. NB 1. Compressed BBC Basic programs that have been converted to Text
  45. will only convert back to BBC Basic that is accepted by BBC Basic editors
  46. if the user does not attempt to indent them. Otherwise the message 'Bad BBC
  47. Basic' is returned on the attempt to load into the editor.
  48.  
  49. 2. The message 'Mistake' or 'Syntax Error' on running the converted BBC Basic
  50. can be due to the incorrect coding of key words. The way around this is to
  51. load the converted file into an editor, then save it back again. This will cause
  52. the program to be correctly re-coded over the top of the original (bad) file.
  53.  
  54. 3. !Text_BBC will code PROC and FN names beginning with reserved words
  55. correctly, but the list of identifiers may contain names with only the non-reserved
  56. part of the full name.
  57.  
  58. 4. !Text_BBC has difficulty with the keyword "OR" because of the keyword "ORIGIN".
  59. If the "OR" is immediately followed by a capital "I", then the program assumes that this
  60. sequence of characters will turn into the keyword "ORIGIN". If it doesn't, then !Text_BBC
  61. renders the sequence of characters as a variable name i.e. the "OR" keyword is not coded
  62. correctly, but is left as a character string. This problem arises because !Text_BBC has
  63. only one character of look-ahead. If this happens, see point 2. above to re-code the program.
  64.  
  65. 5. !Text_BBC does not check the syntax of the input Text. If the user supplies bad Text then
  66. it may crash or !Text_BBC will output bad BBC Basic.
  67.