home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug087.arc / DZ.LBR / DZ--READ.ME next >
Text File  |  1979-12-31  |  11KB  |  271 lines
  1. File DZ--READ.ME     29 Nov 86            DazzleStar Disassembler
  2.                                          (User-supported software)
  3. 1. Is it a bird, is it a...
  4. ---------------------------
  5.  
  6. DazzleStar (DZ) is an interactive disassembler.  It requires a 
  7. Z80 CP/M system, and at least 48K of RAM (preferably more).  
  8. DazzleStar lets you examine an 8080 or Z80 program (a .COM file) 
  9. and decode it into Z80 assembler instructions, showing the result 
  10. on your screen or printer, or producing an assembler source file 
  11. on disk.  Many of the commands are in the style of WordStar (and 
  12. other commonly used microcomputer editors).
  13.  
  14. If you've used a disassembler before, you'll know that recon-
  15. structing and understanding a program (using sensible names for 
  16. the labels, and meaningful comments) is a painful process.  No 
  17. disassembler can be a complete pain killer.  But DazzleStar does 
  18. make the pain more endurable.
  19.  
  20. DazzleStar is big, but doesn't limit the size of the program to 
  21. be disassembled.  This freedom is due to the way in which 
  22. DazzleStar reads the program to be disassembled, using a paging 
  23. technique to ensure that few of the accesses require it to re-
  24. read the disk.
  25.  
  26.  
  27. 2. What you've received
  28. -----------------------
  29.  
  30. You should have a file DZ-NOV86.LBR, which contains the 
  31. following:
  32.  
  33.      -CATALOG.000   CRC values for the following files
  34.      DZ--READ.ME    (This file) Read this first
  35.      DZ-BRIEF.DOC   Print this and paste it on the wall
  36.      DZ-FIXES.DOC   Past and future
  37.      DZ.COM         The interactive disassembler program
  38.      DZENGHLP.OVR   Overlay file (help) for DZ.COM (English version)
  39.      DZENGMNU.OVR   Overlay file (menus)
  40.      DZENGMSG.OVR   Overlay file (messages)
  41.      DZINSTAL.CFA   Data file for DZINSTAL.COM
  42.      DZINSTAL.COM   Installation and customization program
  43.  
  44.  
  45. 3. Licence
  46. ----------
  47.  
  48. This library is NOT public domain.  Copyright is retained by the 
  49. author, John Washington, and all rights are reserved.
  50.  
  51. A licence is granted for free use and re-distribution of this 
  52. library, subject to the following conditions:
  53.  
  54. 1.   Users may not modify any copyright notices, nor suppress the 
  55.      display of any such notices.
  56.  
  57. 2.   Re-distribution may only be made by distributing this 
  58.      library exactly in its present form, with no additions, no 
  59.      deletions, no amendments of ANY kind.
  60.  
  61. 3.   Use and redistribution may only be made without profit, 
  62.      except when prior written agreement has been granted by the 
  63.      author.  This library may not be included in any other 
  64.      package for sale.  Modest charges to cover media copying and 
  65.      distribution are permitted, provided that the author is 
  66.      notified of this intent.
  67.  
  68. Please report any violations to the author.  Thank you.
  69.  
  70.  
  71. 4. WARNING and disclaimer
  72. -------------------------
  73.  
  74. The author will have no liability or responsibility in the event 
  75. of any loss or damage caused or alleged to be caused directly or 
  76. indirectly by this program.
  77.  
  78.  
  79. 5. Getting started
  80. ------------------
  81.  
  82. If you obtained your master disk direct from me, I have probably
  83. included NULU.COM, NULU15.LBR, CRUNCH22.LBR and CRC.COM on the
  84. disk.  If you downloaded from a bulletin board, you can almost
  85. certainly find NULU, CRUNCH and CRC elsewhere on that board (if
  86. you really can't, I suggest you ask the sysop for advice before
  87. contacting me, though I'll be happy to act as longstop).
  88.  
  89. These installation instructions assume you have two disk drives. 
  90. It is possible to install and run DazzleStar with only a single
  91. drive, but I have no experience of doing so.  I have two 800K
  92. drives and therefore have never calculated the disk capacity
  93. required.  I imagine much smaller drives will suffice.
  94.  
  95. You should now have a master disk containing the file DZ-
  96. NOV86.LBR.  We'll call this disk 1A.  You should also have a disk 
  97. containing NULU.COM, UNCR.COM and CRC.COM, which we'll call disk 
  98. 1B (or you could have everything on one disk if there's enough 
  99. room, in which case we'll call it disk 1).
  100.  
  101. Your first task is to use NULU to split up the library into its 
  102. component files, and then use UNCR to expand these files into 
  103. working versions.  Put disk 1B (or 1) into drive A, and press ^C.  
  104. Put an empty (but formatted) disk (call it disk 2) into drive B.  
  105. Type
  106.  
  107.           B:
  108.           A:NULU                   (Start running NULU)
  109.  
  110. Remove disk 1B from drive A, and replace it with disk 1A (unless 
  111. 1A and 1B are the same disk, disk 1).  Then type
  112.  
  113.           -O A:DZ-OCT86            (Open the library file)
  114.           -Q *.*                   (Extract & unsqueeze contents)
  115.           -C                       (Close the library file)
  116.           -X                       (Exit to CP/M)
  117.  
  118. Remove disk 1A from drive A and replace it with disk 1B.
  119. Type
  120.           B:
  121.           A:UNCR *.*               (Uncrunch all files)
  122.           DIR B:
  123.  
  124. Each line is terminated with the <return> key, as usual for CP/M.
  125.  
  126. Disk 2 should now have the files as mentioned in section 2 (above).
  127.  
  128. Your next task is to use CRC.COM to check that you received the 
  129. files ok, and they have been correctly reconstituted.  Put disk 
  130. 1A into drive A, and warm boot (press ctrl-C).  Type
  131.  
  132.           B:<return>
  133.           A:CRC<return>
  134.  
  135. If the CRCs don't all check out, or any files are missing, this 
  136. is very serious -- first check with your sysop.  If his copy is 
  137. also corrupt, please contact me URGENTLY.  Do not try to continue
  138. with a bad copy.
  139.  
  140. I've had reports that the CRC.COM that I use (version 5.0) may 
  141. not work properly on CP/M 3.  Since I only use CP/M 2.2 I'm 
  142. unable to advise on this (and I'd appreciate guidance from a 
  143. knowledgable CP/M 3 user).
  144.  
  145. Now that you have a good version...  Before doing anything 
  146. further, MAKE A COPY, and put your master disk on the shelf out 
  147. of harm's way.  
  148.  
  149. If you have a printer, you may find it useful to print out the
  150. following files
  151.  
  152.      DZ--READ.ME (this file)
  153. *    DZ-BRIEF.DOC
  154.      DZ-FIXES.DOC
  155. *    DZENGHLP.OVR
  156.  
  157. The files marked "*" are in WordStar "document" format, and
  158. therefore are most easily printed by using WordStar.  If you don't
  159. have WordStar, you can still get a reasonable listing by using a
  160. printer (or CP/M BIOS) which ignores the high bit of characters. 
  161. Some printers treat the high bit as a signal to use italics; if
  162. you don't like that maybe there's an escape sequence which turns
  163. off this feature.  Check your printer manual.  For an Epson
  164. printer, try
  165.  
  166.           PIP LST:=CON:<return>
  167.           <escape><hash or pound><ctrl-Z>
  168.  
  169. However, some printers treat the high bit as graphic characters, 
  170. without any means of suppressing them, in which case you won't 
  171. have much joy.  So try, for example,
  172.  
  173.           PIP DZENGHLP.TXT=DZENGHLP.OVR[Z]<return>
  174.  
  175. and print the new file DZENGHLP.TXT that PIP produces.
  176.  
  177.  
  178.  
  179. 6. You've seen the trailer, now watch the film!
  180. -----------------------------------------------
  181.  
  182. DazzleStar must use screen control codes, to achieve its 
  183. impressive display.  As these codes are not the same for every 
  184. computer, you can't run DazzleStar "straight out of the box" 
  185. (unless you use a Hazeltine 1500 terminal).  First you have to 
  186. run DZINSTAL which modifies DZ.COM to run properly on your 
  187. screen.  Put disk 2 in your drive A.  Press ^C.
  188.  
  189. Type
  190.           DZINSTAL<return>
  191.  
  192. DZINSTAL will present you with menu choices.  It is easy to use, 
  193. provided that you resist any temptation to choose the menu option 
  194. that sets you in expert mode.
  195.  
  196. Screen size is assumed to be not more than 25 rows of 80 columns.  
  197. It is expected that most screens will have 24 rows, though 
  198. perhaps 16 would be sufficient (though irritatingly small if you 
  199. also want the menus).  DazzleStar can be used on an Epson Geneva 
  200. PX-8 (only eight rows).  However, you need to be a very 
  201. experienced user because no menu display is possible.  Well, I 
  202. sometimes use it myself on a PX-8, and am really happy with it, 
  203. but I guess I can fairly claim to be a VERY experienced 
  204. DazzleStar user!
  205.  
  206. [Note for users with very low disk capacity:  during installation 
  207. the only files required are DZINSTAL.COM, DZINSTAL.CF1, DZ.COM]
  208.  
  209.  
  210. Having configured DZ.COM, you're ready to start disassembling.  
  211. Choose something fairly small to start with, say, EXAMPLE.COM, 
  212. and type
  213.  
  214.           DZ EXAMPLE<return>
  215.  
  216. [Note for users with very low disk capacity:  DZ.COM is only 
  217. accessed for the initial program load, and can therefore be on a 
  218. different drive.  The overlay files DZ*.OVR should be on the 
  219. default drive (though this can be modified by DZINSTAL).  If a .OVR
  220. file is not found, DZ will operate but will be rather cryptic.]
  221.  
  222.  
  223. 7. Problems
  224. -----------
  225.  
  226. It isn't easy to write installation directions that work well on 
  227. every machine, and for every user.  But I'd like to.  So tell me 
  228. your horror stories, so I can do better next time.  Thanks.
  229.  
  230.  
  231. 8. You've seen the film, now get the book!
  232. ------------------------------------------
  233.  
  234. If you've followed these directions, there's sufficient 
  235. information to allow you to make good use of DazzleStar.  But to 
  236. make full use of it, get the manuals.  There are three manuals:
  237. "Installation & Configuration", "Tutorial", and "Reference".  To
  238. obtain the manuals, send an order form (see DZ-FORMS.DOC) together
  239. with your registration fee.
  240.  
  241. ... That's how it used to be, but life is too hectic at present 
  242. for me to spend time printing and binding.  Look out for another 
  243. library called DZDOCS86.LBR.  This will contain the text of the 
  244. manuals.  In fact, my life is SO hectic at present, that I need 
  245. regular doses of muscle relaxant.  So if you find DazzleStar 
  246. entertaining then I'd appreciate a small contribution for my 
  247. slate in the local.
  248.  
  249. Many thanks to the users who supported earlier versions of
  250. DazzleStar; this new version is a direct result of your
  251. encouragement.
  252.  
  253.  
  254.  
  255. 9. Feedback
  256. -----------
  257.  
  258. I'd like to get your ideas and comments, whether general or
  259. detailed, positive or negative, on anything concerning DazzleStar.
  260.  
  261. Contact:      John Washington
  262.               Washington Electronics and Systems Ltd
  263.               33 Turnoak Avenue, Woking, Surrey, GU22 0AJ, England.
  264.  
  265. If you want a reply, YOU MUST include British postage stamps, or 
  266. a dollar bill, or the smallest note in your local currency.  I am 
  267. a typical generous-hearted Englishman (free advert for the 
  268. English Tourist Board!), but postage costs do make a hole in my 
  269. wallet.
  270.  
  271. enerous-hearted Englishman (free advert for the