home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 17 / amigaformatcd17.iso / -in_the_mag- / emulation / 68xx_crossasm / amigarelease.doc next >
Text File  |  1997-07-01  |  8KB  |  161 lines
  1.                                RELEASE NOTES
  2.                     MOTOROLA FREE WARE CROSS ASSEMBLERS
  3.                                 ver TER_2.0
  4.  
  5. o These assemblers are based upon and compatible with the original Motorola
  6. free ware cross assemblers.
  7.  
  8. o The following archive files contain:
  9.  
  10. Archive file                       Contents
  11.  
  12. Assembler.arc                      Assemblers AS0,1,4,5,9,11
  13.                                    NewMan.doc (manual)
  14.                                    Assign (script) - Amiga only (directories)
  15.                                    Main.asm, Glob_Dat.i, D_Output.asm - examples
  16.                                    Example (script) - Amiga only (click to
  17.                                                               see assembly)
  18. Assembl9.arc etc.                  as above but with only one assembler as
  19.                                    as indicated (AS9 here). About 1/3 down
  20.                                    load time. (Examples for AS11 only)
  21.  
  22. Source.arc                         *.c  cross assembler source code
  23.                                    *.h  cross assembler data files
  24.  
  25.  
  26. o The MAC assembler update is delayed until I find a MAC expert with a good
  27. C compiler.
  28.  
  29. o Changes from the original
  30.  
  31.           - nested include files
  32.           - nested conditional assembly
  33.           - redefinable symbols
  34.           - segment (CODE, DATA etc.) statements
  35.           - new manual with examples
  36.           - ';' acceptable for comments
  37.           - ';' comments acceptable any where in line fixing comment after
  38.                 label bug
  39.           - '=' is now equivalent for EQU
  40.           - automatic paging of listing
  41.           - Amiga & MAC accept source code from MS-DOS
  42.           - continuous include file line numbering option
  43.           - MS-DOS (CR,LF EOL) compatible S record output for Amiga and MAC
  44.  
  45.  
  46. o Apology
  47.  
  48. The author is not engaged as a software engineer on a full time basis
  49. (system engineer).  Some features may need enhancement and the assemblers
  50. could still need further testing although original code having to do with
  51. the micro-processors themselves was not altered and so should be "as good
  52. as new."  I used AS11 ver TER_2.09 to assemble about 8k bytes of existing
  53. code after modifying it to use most of the new features with no problems.
  54. I also modified the 68HC11 floating point code on the Motorola BBS to work
  55. with the other uC/uPs, assembled them and checked the listing against the
  56. Motorola 8 bit documentation (OK).  Much new code was tested as a finite
  57. state machine.  Comments may be forwarded through Motorola or directly to
  58. my home address (with SASE if reply is requested).  Please do not call my
  59. business telephone.  These assemblers were completed at home without my
  60. employer's equipment or time so that they would be the property of
  61. Motorola.
  62.  
  63. My interest in the assemblers themselves is the study of software,
  64. operating systems and software development systems.  I also make use of
  65. Motorola 68HC11s as embedded processors in my work.  This project was
  66. completed because I had never coded anything in "C" and I wanted to know
  67. the language well.  I remain interested in this project for itself and will
  68. further upgrade them as time is available.  If others are interested on
  69. this same basis, we might cooperate.  A full linking macro assembler with
  70. local variables seems like the next logical step.  My goal is to develop
  71. the source code so that it is transportable, adding most system specific
  72. controls as drivers or shells (viz the Amiga/UNIX scripts in this release)
  73. and to keep the memory requirements within the bounds of MS-DOS.
  74.  
  75. Compilers used are Amiga Lattice C and MicroSoft MS-DOS Quick C.  The MS-
  76. DOS version has not been tested with maximum number of symbols.  The Quick
  77. C options were for size and speed.  This means that other things may
  78. suffer, like data size, but I'm not sure.  At the very least, there is
  79. likely to be a drastic reduction in speed using Intel processors and MS-DOS
  80. beyond a critical number of symbols.  The MAC and Amiga 68000, 68020 and
  81. 68030 systems do not have these problems.  No options were used to compile
  82. the Amiga version.  An Amiga 2500 using AS11, ~120k of source code in 10
  83. files and an 8k byte output takes about 50 seconds to complete assembly.
  84. These assemblers are about 10% slower than the originals on large files.
  85.  
  86. Documentation without extension .doc are in Electronic Arts Interchange
  87. File Format (Amiga Standard) and should be readable by most if not all MAC
  88. and Amiga word processors.  There is no MS-DOS word processor documentation
  89. because there are no standards to use.  Some example files may have shorter
  90. names than mentioned in documentation so as to permit handling by (ugh) MS-
  91. DOS and MS-DOS compatible archive programs.
  92.  
  93. o Files
  94.  
  95. Files ending in .info are Amiga only.  There are separate MS-DOS and Amiga
  96. .arc files because the EOL symbol is different on each system (and the
  97. assemblers are different).  System specific files such as Trashcan are on
  98. disk distribution only (not available through Motorola).  Add the extension
  99. s shown below to make icons visible i.e. rename NewMan.doc.i
  100. NewMan.doc.info (MS-DOS again, ugh!).  Some source code .info files did not
  101. make the archive at all because of length.  This will make no difference in
  102. editing or compiling.  Copy other info files over e.g. copy AS11.C.info to
  103. TABLE11.H.info to make TABLE11.H visible at Amiga WorkBench.
  104.  
  105.  
  106.    Trashcan (dir)
  107.    Assemblers (dir)
  108.        .info                            as0
  109.        as0.info                         as1
  110.        as1.info                         as11
  111.        as11.info                        as4
  112.        as4.info                         as5
  113.        as5.info                         as9
  114.        as9.info                         Assign
  115.        Assign.info                      D_Output.asm
  116.        D_Output.as(m.info)              Example
  117.        Example.info
  118.        Glob_Dat.i                       Glob_Dat.i.i(nfo)
  119.        Main.asm                         Main.asm.inf(o)
  120.                                         More
  121.        More.info                        NewMan.doc
  122.        NewMan.doc.i(nfo) 
  123.      Extras (dir)
  124.        .info                            Design.doc
  125.        Design.doc.info                  NewMan
  126.        NewMan.info                      Release
  127.        Release.info
  128.      Source Code (dir)
  129.        .info                            AS.C
  130.        AS.C.info                        AS.H
  131.        AS.H.info                        as0.c
  132.        as0.c.info                       as1.c
  133.        as1.c.info                       as11.c
  134.        as11.c.info                      as4.c
  135.        as4.c.info                       as5.c
  136.        as5.c.info                       as9.c
  137.        as9.c.info                       do0.c
  138.        do0.c.info                       do1.c
  139.        do1.c.info                       DO11.C
  140.        DO11.C.info                      do4.c
  141.        do4.c.info                       DO5.C
  142.        DO5.C.info                       do9.c
  143.        do9.c.info                       EVAL.C
  144.        EVAL.C.info                      FFWD.C
  145.        FFWD.C.info                      IFD.C
  146.        IFD.C.info                       OUTPUT.C
  147.        OUTPUT.C.info                    PSEUDO.C
  148.        PSEUDO.C.info                    SYMTAB.C
  149.        SYMTAB.C.info                    table0.h
  150.        table0.h.info                    table1.h
  151.        table1.h.info                    TABLE11.H
  152.        TABLE11.H.info                   table4.h
  153.        table4.h.info                    TABLE5.H
  154.        TABLE5.H.info                    table9.h
  155.        table9.h.info                    UTIL.C
  156.        UTIL.C.info
  157.      Empty (dir)
  158.        .info
  159.  
  160.  
  161.