home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / progutils / _moddis / docs / changes12 next >
Encoding:
Text File  |  1991-11-15  |  3.0 KB  |  60 lines
  1. >Changes
  2.  
  3. CHANGES FROM VERSION 1.04
  4. =========================
  5.  
  6. Once I started using version 1.04 of Mod_Dis, it soon became apparent to me
  7. that it was seriously flawed. Firstly, there were several bugs, one of which
  8. was pretty major, namely that the program didn't save the length of a padded
  9. string to the script file, so any script file which referred to a padded
  10. string wouldn't work. Of the 23 sample script files supplied with version
  11. 1.04, 6 wouldn't work properly.
  12.  
  13. A more serious problem, from my point of view, was that the nature of the
  14. script files meant that whenever I changed the program the script files
  15. often became out of date, because the path taken by the program in analysing
  16. the module would change, so all the responses would be wrong. To get around
  17. this, I have totally revised the script file format and simplified its
  18. operation from the users point of view. There is no longer any need to
  19. change the variables readscript% and writescript% in the program. Now the
  20. program always tries to read a script file, creating one if it does not
  21. exist. The new script files contain the offset as well as the response, and
  22. are searched sequentially from the start every time the program gets stuck,
  23. so the order in which the responses are stored is unimportant - if it is
  24. there the program will find it. If the program can't find a response in the
  25. script file it prompts the user for help, and then adds this response to the
  26. script file before proceeding.
  27.  
  28. A useful consequence of this is that if an error happens during execution,
  29. say, because the user inputs a mistake, you can edit the script file using
  30. !Edit or Twin to remove the offending response. Then simply running the
  31. program again will read the script file up to this point and then revert to
  32. asking the user for help again. It is quite safe to just press Escape and
  33. then type 'RUN' - the program will take you back to the point where you
  34. were.
  35.  
  36. The disadvantage of this change is that the script files from version 1.04
  37. are now out-of-date. Also, I feel that the amount of information in the new
  38. script file about a module (which is itself copyright) is so high that they
  39. can no longer safely be distributed as PD files, so there are no script
  40. files accompanying this version, nor will there be with any future versions.
  41.  
  42. The other important changes are:-
  43.  
  44. BICS PC,R14,#mask is now recognised as an end-of-code (like MOV PC,R14)
  45.  
  46. Some modules contain help code instead of a help string. Mod_Dis now
  47. recognises this and acts accordingly
  48.  
  49. There is now some support for out-of-module branches, as used by RiscOS,
  50. UtilityModule and FileSwitch. These aren't translated correctly, because I
  51. ran out of time, but they don't crash the program any more.
  52.  
  53. You can now specify Acorn-type compacted strings as type -4. These strings
  54. were always interpreted correctly when they cropped up in help strings,
  55. etc., but there was no way for the user to specify them in preference to a
  56. plain zero-terminated string.
  57.  
  58. It can now cope with modules with no title string, such as RiscOs, a
  59. 'hidden' module which comes before UtilityModule.
  60.