home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / DISASM / DZ-NOV86.LBR / DZ-FIXES.DZC / DZ-FIXES.DOC
Text File  |  2000-06-30  |  9KB  |  213 lines
  1. DZ-FIXES.DOC                                            29 Nov 86
  2.  
  3. This file includes a brief comparison with the previous version 
  4. of DazzleStar.
  5.  
  6. Since the last major issue of DazzleStar (DZ-FEB86.LBR), there 
  7. have been two small sets of patches (Apr86 & Jun86).  This new 
  8. issue entirely supercedes those versions, and even the old files 
  9. of the same names should not be mixed with the new.  In some 
  10. cases there are checks to warn you if a mixture is attempted, but 
  11. there are other cases that will give unpredictable results, SO 
  12. DON'T MIX ELEMENTS FROM DIFFERENT VERSIONS.  The .DZ symbol files 
  13. you may have generated with the previous version are compatible 
  14. with the new one (but the reverse is not true, so don't use Feb86
  15. once you've started creating .DZ files with the new version).
  16.  
  17.  
  18. DZINSTAL changes
  19. ----------------
  20.  
  21. DZINSTAL has been reworked to be more menu oriented.  It should 
  22. be easier for the novice to use.  However, if you tell DZINSTAL
  23. that you're an expert, you gain access to a mish-mash of extra
  24. options (don't try this until you've had DazzleStar running fine
  25. for a few days and feel it's time to ruin it!).
  26.  
  27. If you find your first installation difficult then I'd be 
  28. grateful if you'd take the time to jot some notes describing your
  29. experiences and send them to me.  I never have any trouble at all
  30. doing the installation, but there could be a good reason for that!
  31.  
  32. New terminals have been added to the extensive list supported. 
  33. Cross references have been added.  For example, you'll find a Lear
  34. Siegler ADM terminal regardless of whether you search under 'L' or
  35. 'A', and Apple users will find a reference to 'S' for Soroc. 
  36. Again, if you find difficulties during installation, it's really
  37. important to feed back to me -- I'm very well aware that
  38. difficulties during installation can be enough to make me give up
  39. trying a program.
  40.  
  41. One thing that's unlikely to be fixed in DZINSTAL is its sluggish 
  42. reading of terminal definitions.  Since you won't instal 
  43. different terminals very often (more than once?) I don't consider 
  44. that a serious drawback.
  45.  
  46. In case you're not certain which terminal your machine emulates, 
  47. or you have to resort to typing individual screen control codes, 
  48. DZINSTAL now offers you a quick check of cursor positioning and 
  49. highlighting.  This is under development, so don't trust it 
  50. completely -- the proof of the DazzleStar pudding is in the 
  51. executing (of DZ itself).  But I hope it will help you spot 
  52. obvious problems (like getting the column/row order the wrong way 
  53. round) and test your ideas more quickly than before.
  54.  
  55. I had expected to extend DZINSTAL to be able to look at your 
  56. configured copy of VDE, Turbo Paslog, dBase 72 or whatever, and
  57. figure out how to drive your screen by itself.  However, there
  58. seems so little interest in this idea that I've not yet pursued
  59. it.
  60.  
  61.  
  62. DZ changes
  63. ----------
  64.  
  65. The old BA and SA commands have been dropped.  Instead there's a 
  66. new SA command, more interactive than before.  If you're prepared 
  67. to put in some work to get a thorough disassembly, the new SA is 
  68. well worth a try (I've been using it myself for several months --
  69. if you can show me something better I'll get quite excited!).  It
  70. even lets you handle calls followed by inline parameters (see the
  71. new family of P commands).
  72.  
  73. Support has been included for reading .BRK files from Ken 
  74. Gielow's Z80DIS21.  Try the KG command (untested).  Ken, if 
  75. you're reading this -- did you ever get my airmail letter?  I no 
  76. longer have any reason for this command, so it will be dropped in 
  77. the next version unless I get requests.
  78.  
  79. The .PHASE directive (the BO command) is now supported as fully 
  80. as possible.  Multiple .PHASEs are permitted, and the code can 
  81. even be shuffled.  Of course, two chunks of code in the same 
  82. place are a headache -- the chunk that is later in the file 
  83. becomes hidden.  To avoid making DazzleStar too gross, .PHASEs 
  84. cannot be deleted (if you need to do this, exit and use your 
  85. favorite text editor on the .DZ file).
  86.  
  87. The format of the .DZ file is slightly different for BO inform-
  88. ation.  However, the old format is also recognized.  Support for
  89. the old format will probably be dropped in future.
  90.  
  91. SY now only removes fake symbols.  Anything more seems too 
  92. dangerous.
  93.  
  94. BY removes redundant breaks (useful after SA sessions).  BY is 
  95. incredibly slow, but speeding it up would make DazzleStar fatter.
  96.  
  97. Internally there are many changes.  In particular, the symbol
  98. table, which used to be searched linearly, is now searched using
  99. binary chop.  Screen display is much faster as a result.
  100.  
  101.  
  102.  
  103. Probable bugs
  104. -------------
  105.  
  106. Minor comments (command /) are still in much the same state as
  107. they were in Feb86.  You may find entering such comments causes
  108. the screen to be updated as if a symbol or break has disappeared. 
  109. Almost certainly nothing is lost.  Try forcing a redisplay of the
  110. screen (e.g. QE0).  During testing I even found rare situations
  111. where the symbol table got out of order, and only KX, restarting,
  112. and KR got things back again (KR reads a .DZ file without needing
  113. the addresses to be in any order).  But I think I've fixed this
  114. (however, the circumstances are complicated, so it's hard to be
  115. sure I've caught them all).
  116.  
  117. Regions of words, triples or quads, used to be displayed as
  118. garbage if you didn't start the screen on the "right" address. 
  119. DazzleStar is now smarter, and backs up a few bytes in these
  120. situations.  However, I once saw something which looked as though
  121. this was being done elsewhere, perhaps just after displaying a
  122. region of triples.
  123.  
  124. Much as I dislike sending out something with known or suspected
  125. bugs, these don't seem serious enough to justify delaying this
  126. release.
  127.  
  128. There shouldn't be any circumstances where you get a little
  129. message "Error" followed by a letter and four hex digits.  If it
  130. happens, I'd like to know.
  131.  
  132.  
  133. Commodore C-128
  134. ---------------
  135.  
  136. Many thanks to Chris Bailey (a visitor to England from Texas) for 
  137. his help in confirming that a pre-release of these versions of 
  138. DZINSTAL and DZ run on his C-128.  And no thanks whatsoever to 
  139. John Collins of Commodore who volunteered to do this checkout, 
  140. took away a couple of my disks and refuses to give them back 
  141. despite dozens of calls.
  142.  
  143.  
  144. Distribution
  145. ------------
  146.  
  147. If this version is now more than a year old, try looking for a 
  148. later version.  Regrettably I can't force the withdrawal of out 
  149. of date versions.
  150.  
  151. BULLETIN BOARDS:
  152.      Going on past experience, many bulletin boards will carry 
  153.      future versions of DazzleStar.  The first are likely to be:
  154.  
  155. Northern England:
  156.      MBBS Leconfield, sysop Martin Taylor, 0401 50745  300 & 
  157.      1200/75 baud.  In my (admittedly limited) survey of UK boards,
  158.      this one strikes me as the best I've found for "techies",
  159.      with a sysop who doesn't offer bullshit on the rare occasions
  160.      when he's stumped for an answer.  Many thanks, Martin.
  161.  
  162. Southern England:
  163.      London West, sysop John Bolton, 0895 420164  300 & 1200/75 
  164.  
  165. North America:
  166.      MWUG-1, Winnipeg, sysop Terry Smythe, (204) 832-4593
  167.      Thanks again for all the megabytes, Terry!
  168.  
  169. Australia:
  170.      No details yet, but this month I had a phone call from
  171.      someone in Salisbury Heights with a really ancient
  172.      DazzleStar.  I hope this will soon lead to contact with an
  173.      Aussie sysop.
  174.  
  175. Ireland:
  176.      I suspect the Irish have too much sense to run bulletin
  177.      boards (phone bills there come in units of crocks of gold). 
  178.      My Irish friend Rory O'Farrell has been a DazzleStar guinea
  179.      pig since the start, and unstinting with his time and ideas. 
  180.      If you're one of the many acquainted with Rory, I recommend
  181.      you carry a disk in your knapsack when passing his front door
  182.      in Co. Wicklow.
  183.  
  184. Off-Earth:
  185.      No contacts with alien sysops yet made.  Does this mean the
  186.      Zilog instruction set is not galactic state-of-the-art?
  187.  
  188.  
  189. DISKS:
  190.      Disks can be obtained in almost any format from:
  191.  
  192.           PD SIG, 138 Holtye Rd, East Grinstead, Sussex RH19 3EA
  193.           Telephone  0342 313883
  194.  
  195.      Rod Smith and his mates at PD Sig are offering excellent
  196.      service at modest prices (once you've bitten the annual
  197.      subscription bullet).
  198.  
  199.  
  200. Several correspondents have suggested I submit DazzleStar to the
  201. library of the UK CP/M User's Group.  The group has a wide
  202. selection of software and a volunteer librarian who does a
  203. sterling job copying to many different formats, turning around
  204. orders efficiently.  I tried submitting a program to this library
  205. in 1985.  After more than six months it was still not released, so
  206. I asked for it to be withdrawn (by then I'd brought out another
  207. version).  Perhaps I was unlucky, but once bitten, twice shy.  I'd
  208. be glad to hear better news, and reconsider.  Their magazine is a
  209. delight, and so much in it I find my bath-water is stone cold as I
  210. turn the final page.  Thoroughly recommended.
  211.  
  212. ine is a
  213. del