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 / ZCPR33 / A-R / CLEAND18.LBR / ASSEMBLY.NOT next >
Text File  |  2000-06-30  |  3KB  |  44 lines
  1. Notes on reassembling CLEAND18:
  2.  
  3. This version was developed and assembled with SLR System's SLR180 Plus--in 
  4. my opinion, the finest assembler package ever made available for Z80-based 
  5. computer systems.
  6.  
  7. I assembled the source with ZAS 2.4, and got 52 (!) assembly errors--mostly 
  8. flagging the 'ext' defined symbols at the beginning of the file as, first 
  9. 'M'ultiply-defined, then as 'U'ndefined, and giving 'V'alue errors for half 
  10. the relative jumps in the program. (Yes, I tried 'extrn' too--no luck).
  11.  
  12. I know David McCord likes to keep Z-system tools in such a form that they are 
  13. able to be assembled by ZAS.  I really did try, but, when ZAS bombed out so 
  14. badly on this source (much of it unchanged from Version 1.4, the version he 
  15. modified explicitly so it WOULD assemble with ZAS), I gave up.  If and when 
  16. ZAS ever grows up into a usable product, I will be glad to support it.  Until 
  17. then, I can't recommend the SLR family of assembler products strongly enough--
  18. and I can't recommend ZAS at all.
  19.  
  20. The problem is probably mostly my lack of knowledge of the idiosyncrasies of 
  21. ZAS.  If you do get this version to assemble with ZAS, I would appreciate a 
  22. message telling me what I did wrong, so I can come closer to ZAS compatibility
  23. in the future.  Leave me a note on ZNode Central or on Seattle's 'downspout',
  24. ZNode #12, at 206-325-1325.
  25.  
  26. Note that this version allocates a smaller-than-usual amount of space for the 
  27. stack--50 bytes.  This should be more than sufficient for most systems, since 
  28. the most that is on the stack at any BIOS entry is 10 bytes (on the call to 
  29. SECTRN; all other BIOS calls have 8 or less bytes on the stack).  Unless your 
  30. BIOS read or write routines take more than 40 bytes of stack space, you should 
  31. have no problem.  If you, do, just change the amount of space for the stack to 
  32. a larger value and reassemble.  Note that this will reduce the amount of space
  33. available for directory entries.
  34.  
  35. HOWEVER, note also that this version was assembled with a custom version of 
  36. SYSLIB that has the COUT routine do its output via a BDOS call rather than a 
  37. BIOS call.  This allows for printer echo of all program output, and also makes 
  38. the amount of stack space available on console output calls irrelevant, since 
  39. BDOS/ZRDOS switches to a local stack.  If you reassemble CLEANDIR and link it 
  40. with the standard SYSLIB, COUT will use direct BIOS console output calls, and 
  41. you will need to make sure you have enough stack space for those also.
  42.  
  43. Steve Dirickson      14 June 1987
  44.