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 / ENTERPRS / CPM / UTILS / S / XLTZ804.LBR / XLTZ804.DZC / XLTZ804.DOC
Text File  |  2000-06-30  |  4KB  |  107 lines
  1. ************************************************************************
  2.  
  3.                   XLTZ80
  4.  
  5.         Translates Intel 8080 assembly language source code
  6.            to Zilog Z80 assembly language source code.
  7.  
  8. 11/12/84                                          Frank J. Zerilli
  9.  
  10. ************************************************************************
  11. Last revision: 02/13/86 by Murray Simsolo
  12.  
  13.  
  14.      This is a modified version of Richard Conn's XLATE2 with several
  15. improvements.  It does not split long unrecognized macro names.  It uses
  16. larger buffers so that it operates much faster.  Compare the result of
  17. translating the file TEST1B.ASM with the results of other translators.
  18.  
  19.      It processes lines with the exclamation point statement separator
  20. correctly.  It strips trailing blanks or tabs from lines.  It replaces
  21. initial asterisks in lines with semicolons.  It gives you several
  22. options to format the output file for best appearance.
  23.  
  24.      This program gives the choice of converting the case of instructions
  25. to upper or lower case or of trying to preserve the case of instructions.
  26.  
  27.      The latest version translates all 8080 instructions to the
  28. "official" Zilog Z80 mnemonics.  Files translated using XLTZ80 should
  29. be compatible with any Z80 assembler.  It is 100% compatible with
  30. the Microsoft M80 assembler when the M80 flag is set.
  31.  
  32.      An activity dot is printed on the console for every 100 lines of
  33. input processed.  The dots are printed in groups of 10 with 5 groups per
  34. console line.
  35.  
  36.      This version of XLTZ80 does not modify colons terminating labels,
  37. i.e., it neither strips colons from nor adds them to labels.  Further,
  38. it preserves double colons terminating labels.  However, if the M80 flag
  39. (location 105h) is set, colons will be stripped from names defined by
  40. the EQU, SET, and MACRO pseudo-ops and colons will be added to all other
  41. labels which don't already have one.
  42.  
  43.      In general, this program leaves alone things which it does not
  44. recognize.
  45.  
  46.      Note that this program runs only on a Z80.
  47.  
  48.  
  49. Command line:
  50.  
  51.     XLTZ80 [d:]srcfile[.typ] [d:destfile.typ]
  52.  
  53.      All parameters in brackets are optional, and, if omitted, the
  54. default values are:
  55.  
  56.    Source file-type      -- ASM
  57.    Destination file-type -- Z80
  58.    Destination file-name -- same as the source file-name
  59.    Drive                 -- current drive
  60.  
  61.  
  62.  
  63. Examples:
  64.  
  65.     XLTZ80              {    prints help message        }
  66.  
  67.     XLTZ80 FILE1                  {translates FILE1.ASM to FILE1.Z80}
  68.  
  69.     XLTZ80 FILE1 FILE2            {translates FILE1.ASM to FILE2.Z80}
  70.  
  71.     XLTZ80 FILE1.TXT FILE2.MAC    {translates FILE1.TXT to FILE2.MAC}
  72.  
  73.     XLTZ80 FILE1 B:          {translates FILE1.ASM to B:FILE1.Z80}
  74.  
  75.  
  76.  
  77. FLAG LOCATIONS:
  78.  
  79. 103H -- Change to non-zero value to suppress translation of several
  80.         non-standard opcodes:
  81.         REQ, RNE, RLT, RGE, CEQ, CNE, CLT, CGE, JEQ, JNE, JLT, JGE,
  82.         ENT, NAM, RAM, ROG, IFC, ICL, LST, MAC
  83.  
  84. 104H -- If non-zero (default) XLTZ80 converts lines with multiple
  85.         statements separated by DR's '!' separator into separate lines.
  86.         Change to zero for output on a single line with the translated
  87.         statements separated by '!'.
  88.  
  89. 105H -- Change to non-zero to output the header lines
  90.                 .Z80
  91.                 ASEG
  92.         for the M80 assembler.  Default is not to output these lines.
  93.     02/13/86: If this flag is set, colons will be stripped from
  94.     labels on the same line with the EQU, SET, and MACRO pseudo-ops
  95.     and colons will    be added to all other labels if not already
  96.     present.
  97.  
  98.  
  99. BUFFERS:
  100.  
  101. The program uses 2K input and output buffers.  This may be changed by
  102. changing the equate MEMSIZ, which is currently set to 4, to twice the
  103. desired size of the i/o buffers and re-assembling the program.  If you
  104. want 16K input and output buffers, set MEMSIZ to 32.  The translation
  105. will not be significantly faster with 16K buffers rather than 2K
  106. buffers but disk activity will decrease.
  107.