home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / z80dis.lbr / READ.MZ / READ.ME
Encoding:
Text File  |  1993-10-25  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.         This is the READ.ME file from the Z80DIS.LBR package
  5.         ----------------------------------------------------
  6.  
  7.  
  8.         Z80DI╙á i≤á aε entirel∙ ne≈ disassemble≥ fo≥ Z8░ baseΣ CP/═á sys-ì
  9.         tems«á  Z80DI╙á i≤ writteε iε TURB╧ PASCAL«á Z80DI╙ generate≤ Z8░ ì
  10.         mnemonic≤á anΣá prepare≤á aε assembl∙á languagσá filσá witΦá man∙ ì
  11.         specia∞á feature≤á fo≥á easσ oµ understandinτ thσ inten⌠á oµá thσ ì
  12.         code.
  13. ì
  14.         Thi≤á codσ wa≤ compileΣ fo≥ ß 50╦ TPA╗á thσ to≡ addres≤ i≤á C7FF« ì
  15.         Thi≤ slightl∙ smal∞ sizσ wa≤ donσ fo≥ compatibilit∙ witΦ CP/═ 3.░ ì
  16.         and ZCPR3.ì
  17.  
  18.         Thσá followinτ file≤ wil∞ bσ founΣ oε Z80DIS.LB╥ fo≥ thi≤ prograφ ì
  19.         distributioε librar∙ package:
  20.  
  21.              Z80DIS.COM    - thσ disassembler program
  22.              Z80DIS.000    - overla∙ file fo≥ Z80DI╙  
  23.              Z80DIS.00▒    - overlay file for Z80DIS
  24.  
  25.              ZDINSTAL.CO═  - a terminal command installatioε program
  26.              ZDINSTAL.MSG  - contain≤ tex⌠ oµ ZDINSTA╠ message≤ 
  27.              ZDINSTAL.DTA  - contain≤ termina∞ characteristic≤ data
  28.  
  29.              Z80DIS.DOC    - the user manual in ready to print format
  30.  
  31.         Thσá Z80DI╙ binar∙ i≤ iε threσ file≤ (seσ SECTIO╬ │ oµá thσá use≥ ì
  32.         manua∞á fo≥ use.⌐ Thσ ZDINSTA╠ file≤ wil∞ tailo≥ thσá interactivσ ì
  33.         display≤ t∩ you≥ termina∞ (seσ SECTIO╬ ┤ fo≥ use.⌐
  34.  
  35.         Thσá prograφ i≤ eas∙ t∩ usσ witΦ interactivσ display≤á fo≥á para-ì
  36.         mete≥ specification«á Al∞ contro∞ parameter≤ havσ default≤ prese⌠ ì
  37.         t∩ thσ mos⌠ likel∙ values«á Thσ DO├ filσ i≤ thσ tex⌠ fo≥ thσ use≥ ì
  38.         manua∞ whicΦ explain≤ al∞ messages¼ default≤ anΣ limitations« Thσ ì
  39.         fort∙á pagσ manua∞ give≤ extensivσ example≤ anΣ use≤á disassembl∙ ì
  40.         oµ thσ publiπ domaiε prograφ D.CO═ a≤ aε example.
  41.  
  42.  
  43.                                FEATURES OF Z80DIS
  44.                                ------------------
  45.  
  46.         ┴á majo≥ featurσ oµ Z80DI╙ i≤ aε extensivσ analysi≤ oµ thσ memor∙ ì
  47.         usage by the program under investigation. Thi≤ take≤ oε tw∩ forms:
  48.  
  49.              Thσá firs⌠ i≤ aε addres≤ listinτ  whicΦ distinguishe≤á type≤ ì
  50.         oµ labe∞ references¼á mark≤ subroutine≤ anΣ jump≤ anΣ produce≤ aε ì
  51.         full∙á annotateΣ cross-referencσ oµ al∞ label≤á referenced«á Thi≤ ì
  52.         listinτ show≤ thσ exac⌠ modσ oµ usagσ fo≥ ever∙á reference║á Jum≡ ì
  53.         absolute¼á Jum≡ relative¼á Call¼á Restart¼ LoaΣ 16-bit¼ Storσ 16-ì
  54.         bit¼ Immediatσ 16-bit¼ LoaΣ 8-bit¼ Storσ 8-bit.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.              Thσá othe≥á forφ oµ addres≤ mappinτ i≤ aεá addres≤á labelinτ ì
  71.         conventioεá whicΦá assist≤ greatl∙ iε understandinτ thσá assembl∙ ì
  72.         codσá generated«á EacΦá labe∞ generateΣ oε thσá assembl∙á listinτ ì
  73.         indicates¼á b∙á format¼á no⌠ onl∙ thσ generiπ typσá (Jump¼á Call¼ ì
  74.         Data¼á Other⌐ oµ an∙ references¼á bu⌠ als∩ thσ singularit∙ oµ thσ ì
  75.         reference.
  76.  
  77.                   Fo≥á example¼á J#02E│ useΣ a⌠ addres≤ 02E│á indi-ì
  78.         áááááááááácate≤ tha⌠ onl∙ onσ referencσ wa≤ madσ t∩ addres≤ ì
  79.         áááááááááá02E│ anΣ tha⌠ tha⌠ referencσ wa≤ ß JUMP.
  80.  
  81.                                    - O -
  82.  
  83.              Anothe≥á featurσá oµá thi≤á disassemble≥á i≤á thσá stylσá oµ ì
  84.         presentatioεá oµ thσ disassembeΣ code«á Thσ disassembleΣ codσá i≤ ì
  85.         outpu⌠á iε tw∩ forms║á BotΦ thσ usua∞ *.MA├ filσ anΣá a¼á printe≥ ì
  86.         formatted¼ *.PR╬ file.
  87.  
  88.              Thσ *.PR╬ filσ i≤ ß majo≥ aiΣ t∩ understandinτ thσ inten⌠ oµ ì
  89.         thσá code«á Thσá filσ look≤ likσ thσ outpu⌠ oµ aε assemble≥á witΦ ì
  90.         botΦáá thσáá instruction≤á anΣáá assembleΣáá byte≤áá shown«áá Thσ ì
  91.         juxtapositioε oµ thσ hexadecima∞ byte≤ anΣ thσ assembl∙ mnemonic≤ ì
  92.         allow≤á thσá use≥á t∩ recognizσ error≤ causeΣ b∙á aεá incorrectl∙ ì
  93.         defineΣ breaδ table« 
  94.  
  95.              Iε addition¼á separatioε commen⌠ line≤ arσ useΣ t∩ assis⌠ iε ì
  96.         visualizinτá thσá flo≈ oµ thσ program«á ┴ blanδ commen⌠á linσá i≤ ì
  97.         inserteΣá afte≥ ever∙ CAL╠ o≥ CONDITIONA╠ JUMP«á ┴á bar-of-dashe≤ ì
  98.         commen⌠ linσ i≤ inserteΣ afte≥ ever∙ UNCONDITIONA╠ JUMP« Al∞ CAL╠ ì
  99.         instruction≤á arσá indenteΣá onσ spacσá t∩á highligh⌠á them«
  100.  
  101.              Al∞á subroutine≤á arσá markeΣ witΦ ßá heade≥á commen⌠á whicΦ ì
  102.         separate≤ theφ froφ thσ othe≥ codσ anΣ allow≤ yo⌡ t∩ annotatσ thσ ì
  103.         purposσ oµ thσ subroutine«á Al∞ immediatσ 8-bi⌠ datß i≤ showεá iε ì
  104.         botΦ he° anΣ decima∞ o≥ ASCII.
  105.  
  106.  
  107.                                       - O -
  108.  
  109.         A personal note:
  110.  
  111.              ╔á wrotσ thi≤ disassemble≥ becausσ ╔ coulΣ no⌠ finΣá anothe≥ ì
  112.         tha⌠á woulΣá real∙á opeε u≡ ßá foreigεá prograφá fo≥á inspection« ì
  113.         RESOURC┼á anΣá it≤ spin-off≤ givσ yo⌡ onl∙ ß pin-holσ looδá a⌠á ß ì
  114.         prograφá withou⌠ indicatinτ thσ importan⌠ interaction≤ witΦ othe≥ ì
  115.         part≤ oµ thσ code«á Z80DI╙ attempt≤ t∩ rectif∙ tha⌠ lacδ vißá thσ ì
  116.         cross-referencσ anΣ disassembl∙ comments.
  117.  
  118.              I hope that you will find it as useful as I have. 
  119.  
  120.                                       Kenneth Gielow
  121.                                          07/24/85
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.