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 / JSAGE / ZSUS / PROGPACK / ZXLATE14.LBR / ZXLATE14.WZ / ZXLATE13.WS%a0
Text File  |  2000-06-30  |  7KB  |  136 lines
  1. .he   ZXLATE - 8080 TO Z80 SOURCE CODE TRANSLATOR                            #
  2.  
  3.  
  4.                 ZXLATE - AN 8080 TO Z80 SOURCE CODE TRANSLATOR
  5.                      Copyright (c) 1986 by G. Benson Grey
  6.                         All Rights Reserved, Worldwide
  7.  
  8. ááááZXLAT┼á i≤á aε 808░ t∩ Z8░ Sourcσ Codσ Translato≥ iε thσá traditioεá oµ ì
  9. ááááRicharΣá Conn'≤á ZXLATE▓ anΣ Franδ Zerilli'≤ XLATE10┤ anΣ i≤á ßá direc⌠ ì
  10. áááádescendan⌠á froφá thσ tw∩ programs«á Thi≤ versioε ha≤ beeεá labeleΣá a≤ ì
  11. ááááVersioεá 1¼á Revisioε ▒ sincσ i⌠ wa≤ completel∙ re-writteε iε Z8░ code« ì
  12. ááááIε addition¼ i⌠ i≤ designeΣ t∩ operatσ oε system≤ whicΦ utilizσ RicharΣ ì
  13. ááááConn'≤ exceptiona∞ commanΣ processo≥ replacement¼á ZCPR3« ZXLAT┼ relie≤ ì
  14. ááááoε ZCPR3'≤ SYSLIB3¼á VLI┬ anΣ Z3LI┬ relocatablσ libraries«á I⌠ mus⌠á bσ ì
  15. ááááassembleΣáá usinτáá M8░á (o≥á equivalent⌐á anΣá linkeΣá witΦá L8░áá (o≥ ì
  16. ááááequivalent).
  17.  
  18. ááááZXLAT┼á i≤ largel∙ ß completσ re-writσ oµ Franδá Zerilli'≤á XLATE«á Thσ ì
  19. áááádefaul⌠ location≤ werσ removeΣ froφ thσ fron⌠ oµ thσ prograφ a≤ eacΦ oµ ì
  20. ááááthσá option≤ ha≤ ß manua∞ overridσ froφ thσ commanΣ line«á ZXLAT┼ ha≤ ß ì
  21. áááávariet∙á oµá option≤á whicΦá arσ useΣ t∩á contro∞á thσá translatioεá oµ ì
  22. ááááprograms.
  23.  
  24. ááááThσá option≤ definσ sucΦ thing≤ a≤ whethe≥ multiplσ command≤á separateΣ ì
  25. ááááb∙á Digita∞ Research'≤ íá separato≥ shoulΣ bσ outpu⌠ oε separatσá line≤ ì
  26. áááá(default⌐á o≥á lef⌠ intact╗á iµ opcode≤ shoulΣ bσ followeΣ b∙á ßá spacσ ì
  27. áááá(20H⌐ o≥ ß taΓ (09╚ default)╗á wha⌠ columε t∩ aligε comment≤ iε (4▒á i≤ ì
  28. ááááthσá default)╗á anΣá whethe≥á t∩á translatσá specia∞á TD╠á opcode≤á (n∩ ì
  29. áááátranslatσá default)╗á translatσ D┬ anΣ EQ╒ (n∩ translatσ default)╗á anΣ ì
  30. ááááwhethe≥á t∩á translatσá thσ "standarΣ Z80.LIBó macro≤á t∩á Z8░á opcode≤ ì
  31. áááá(default).
  32.  
  33. ááááThe standard command line syntax for invoking ZXLATE is:
  34.  
  35.             ZXLATE [du:]filename.typ [du:filename.typ] / [options]
  36.  
  37. ááááItem≤á enclosσ iε squarσ bracket≤ arσ optional«á Thσ spacσ betweeεá thσ ì
  38. ááááfilename.ty≡á anΣ separato≥ anΣ betweeε thσ separato≥ anΣá thσá option≤ ì
  39. ááááarσá required«á Thσ du║á refe≥ t∩ thσ standarΣ ZCP╥ systeφ oµ disδá anΣ ì
  40. ááááuse≥á specification≤ followeΣ b∙ ß colon«á Thσ onl∙ iteφ whicΦ mus⌠á bσ ì
  41. ááááspecifieΣ i≤ thσ sourcσ filename«á Thσ filetype¼ iµ omitted¼ i≤ assumeΣ ì
  42. áááát∩á bσ .ASM«á Iµ thσ destinatioε filename.ty≡ i≤ no⌠ specified«á ZXLAT┼ ì
  43. ááááwil∞ creatσ aε outpu⌠ filσ oµ du:filename.Z80¼ wherσ du:filenamσ i≤ thσ ì
  44. áááásamσ a≤ thσ sourcσ file« Iµ thσ destinatioε filσ i≤ specified¼ an∙ par⌠ ì
  45. ááááof the filename specification may be given. A typical example is:
  46.  
  47.                 ZXLATE B1:SOURCE.ASM A0:DESTIN.MAC / E U M C=33
  48.  
  49. ááááwherσá B1:SOURCE.AS═á i≤ thσ inpu⌠ file╗á A0:DESTIN.MA├ i≤á thσá outpu⌠ ì
  50. ááááfile╗á TD╠ extendeΣ mneumonic≤ wil∞ bσ translated╗á labels¼ opcode≤ anΣ ì
  51. ááááoperand≤á wil∞ bσ translateΣ t∩ uppe≥ case╗á .Z8░ anΣá ASE╟á statement≤ ì
  52. ááááwil∞á bσá outpu⌠á t∩á thσ beginninτá oµá A0:DESTIN.MA├á file╗á multiplσ ì
  53. áááácommand≤ oε onσ linσ wil∞ bσ translateΣ t∩ command≤ oε separatσá lines╗ ì
  54. ááááand comments will be aligned in column 33.
  55. .cp 4è
  56. ááááThσá sourcσá anΣ destinatioε file≤ ma∙ bσ oε an∙á lega∞á Disk/User«á N∩ ì
  57. áááácheck≤á arσ donσ b∙ ZXLAT┼ a≤ t∩ thσ validit∙ oµ thesσá specifications« ì
  58. ááááHowever¼á iµ improperl∙ specified¼ ß Disk/Use≥ Erro≥ wil∞ bσ issueΣ anΣ ì
  59. ááááthe program will be terminated.
  60.  
  61. ááááInvokinτá ZXLAT┼á witΦá n∩á parameter≤ o≥ a≤ ZXLAT┼ /»á wil∞á causσá aε ì
  62. ááááinterna∞ hel≡ filσ t∩ bσ displayeΣ oε thσ console« Thσ followinτ singlσ ì
  63. áááácharacter≤á ma∙ bσ useΣ t∩ changσ thσ defaul⌠ value≤ a⌠ ruεá time«á Thσ ì
  64. áááásquare brackets are not part of the specification.
  65.  
  66. ááááááááá[A]áááááááOutpu⌠á .Z8░ anΣ ASE╟ assemble≥ pseudo-op≤á t∩ ì
  67. áááááááááááááááááááthσ destinatioε filσ fo≥ M80.
  68.  
  69. ááááááááá[C=nn]ááááAligεá comment≤á iε columε nn«á (C=4▒á i≤á thσ ì
  70. ááááááááááááááááááádefault.⌐á Note║á therσ mus⌠ bσ n∩ interveninτ ì
  71. áááááááááááááááááááspace≤ betweeε thσ ├ anΣ thσ ╜ o≥ betweeεá thσ ì
  72. ááááááááááááááááááá╜ anΣ thσ columε number« ZXLAT┼ doe≤ no⌠ checδ ì
  73. áááááááááááááááááááthσá columεá numbe≥á a≤ beinτ valiΣá anΣá wil∞ ì
  74. áááááááááááááááááááattemp⌠áá t∩á aligεá t∩á whateve≥á columεáá i≤ ì
  75. áááááááááááááááááááspecifieΣ iµ i⌠ i≤ possible.
  76.  
  77. ááááááááá[D]áááááááTranslatσáá D┬áá anΣáá EQ╒áá statements«áá (N∩ ì
  78. ááááááááááááááááááátranslatioε i≤ thσ default.)
  79.  
  80. ááááááááá[E]áááááááTranslatσá TD╠á pseudo-op≤ int∩á standarΣá Z8░ ì
  81. ááááááááááááááááááámnemonics.
  82.  
  83. ááááááááá[L]áááááááTranslatσá labels¼á opcode≤á anΣá operand≤á t∩ ì
  84. ááááááááááááááááááálowe≥á case«áá (N∩á casσá translatioεá i≤á thσ ì
  85. ááááááááááááááááááádefault.)
  86.  
  87. ááááááááá[M]áááááááPu⌠áá instruction≤áá separateΣá b∙áá DRI'≤áá í ì
  88. áááááááááááááááááááseparato≥á int∩á singlσ lines«á Removσá thσá í ì
  89. áááááááááááááááááááseparato≥ (default).
  90.  
  91. ááááááááá[S]áááááááSeparate opcode from operand by a space (20H).
  92.  
  93. ááááááááá[T]áááááááSeparatσá opcodσ froφ operanΣ b∙ ßá taΓá (09H⌐ ì
  94. ááááááááááááááááááá(default).
  95.  
  96. ááááááááá[Z]áááááááTranslatσáá Z80.LI┬áá macr∩á pseudo-op≤áá int∩ ì
  97. ááááááááááááááááááástandarΣ Z8░ mnemonic≤ (default).
  98.  
  99. ááááAn∙á oµ thσ abovσ option≤ ma∙ bσ specifieΣ oε thσá commanΣá line«á The∙ ì
  100. áááámus⌠á bσá preceedeΣ b∙ thσ » separato≥ t∩ bσ recognizeΣ b∙á ZXLATE«á N∩ ì
  101. ááááothe≥ synta° check≤ arσ donσ oε thσ sourcσ file« ZXLAT┼ wil∞ ignorσ an∙ ì
  102. ááááinstructions (opcodes) which are not defined it its internal tables.
  103.  
  104. ááááZXLAT┼ wil∞ recognizσ thσ M8░ .COMMEN╘ pseudo-op« An∙ text appearinτ iε ì
  105. ááááthi≤á typσá oµ statement¼á wil∞ bσ copieΣ verbatiφ t∩á thσá destinatioε ì
  106. ááááfile.
  107. .cp 4è
  108. ááááThσ "standarΣ Z80.LIBó filσ ha≤ ha≤ severa∞ ne≈ addition≤ sincσ i⌠á wa≤ ì
  109. ááááfirs⌠á released«á Thσ majorit∙ oµ thσ addition≤ arσ onl∙ t∩ renamσ somσ ì
  110. ááááoµá thσ Jum≡ (JP⌐ anΣ Jum≡ Relativσ (JR⌐ instructions«á Thσá ne≈á code≤ ì
  111. ááááhavσáá beeεá addeΣá t∩á ZXLATE'≤á table≤á witΦá thσá correspondinτá Z8░ ì
  112. ááááinstructioεá beinτá generated«áá Thesσá firs⌠á appeareΣá iεá J«á Sage'≤ ì
  113. ááááexperimenta∞ ZCPR31┤ anΣ RCP14╡ whicΦ havσ no⌠ beeε releaseΣ t∩á publiπ ì
  114. áááádomain.
  115.  
  116. ááááI⌠á i≤ m∙ desirσ t∩ contributσ t∩ thσ realφ oµ publiπ domaiεá software« ì
  117. ááááThi≤á i≤ jus⌠ onσ oµ ß serie≤ oµ program≤ whicΦ wil∞ bσá developeΣá fo≥ ì
  118. ááááuse by serious microcomputer users.
  119. ì
  120. ááááThi≤á prograφ i≤ registereΣ witΦ thσ U╙ Governmen⌠ anΣ i≤ copyrigh⌠ (c⌐ ì
  121. áááá1986 by G. Benson Grey and Virtual Micro Systems International.
  122.  
  123. ááááAn∙á comment≤ anΣ o≥ suggestion≤ regardinτ thσ prograφ ma∙ bσ addresseΣ ì
  124. ááááto:
  125.  
  126. áááá          G. Benson Grey, Sysop         [503] 641-6101 Voice
  127. áááá          Portland  ZNODE #24           [503] 644-4621 Data 1200
  128. áááá          12275 NW Cornell Rd, Ste 5
  129. áááá          Portland, OR 97229-5611   
  130.  
  131.  
  132. ááááThσá ZNOD┼á systeφ datß phonσ i≤ availablσ froφá 22.0░á - 06.0░á daily« ì
  133. ááááVoicσá phonσá call≤ wil∞ bσ accepteΣ froφ 06.0░ - 220░á daily«á Collec⌠ ì
  134. áááácall≤ wil∞ no⌠ bσ accepteΣ unde≥ an∙ circumstances.
  135.  
  136.