home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / new / dev / cross / adev11 / readme < prev    next >
Text File  |  1994-09-13  |  17KB  |  333 lines
  1. /*
  2.  * Copyright 1992 Stan Burton
  3.  *
  4.  * Permission to use, copy, modify, distribute, and sell this software
  5.  * and its documentation for any purpose is hereby granted without fee,
  6.  * provided that the above copyright notice appear in all copies and
  7.  * that both that copyright notice and this permission notice appear in
  8.  * supporting documentation, and that the name of Stan Burton not be used
  9.  * in advertising or publicity pertaining to distribution of the software
  10.  * without specific, written prior permission.  I make no representations
  11.  * about the suitability of  this software for any purpose.  It is
  12.  * provided "as is" without express or implied warranty.
  13.  *
  14.  * THE ABOVE-NAMED DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  15.  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO EVENT
  16.  * SHALL STAN BURTON BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  17.  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  18.  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  19.  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  20.  * OF THIS SOFTWARE.
  21.  *
  22.  * Author:
  23.  *        Stan Burton
  24.  *
  25.  *        1978 26 St. SE
  26.  *        Medicine Hat, AB, CANADA
  27.  *              T1A 2G8
  28.  */
  29.  
  30. SOME OF THESE PROGRAMS REQUIRE AMIGADOS 2.0
  31.  
  32. slink requires V2.0, slink1.3 is a slower AmigaDOS V1.3 compatible
  33. replacement for slink.  All other programs are V1.3 and 2.0 compatible.
  34.  
  35.  
  36. INSTALLATION
  37.  
  38. Installation is simple. If you are reading this, and logically you must
  39. be, then step 1 is done.
  40.  2.  The directory containing this file and the other files unpacked from
  41.        the archive should be added to your path (see warning about slink
  42.        below).
  43.  3.  Assign ADev11: to this directory.  This is required mainly for the
  44.        C compiler.
  45.  4.  Read the docs! I know you won't until you run into trouble, but make
  46.        sure you have read them before you come to me for help.
  47.  
  48.  
  49. CONVERTING FROM MOTOROLA STANDARD FORMAT
  50.  
  51. This assembler differs from the Motorola format in a few ways that will
  52. be noticed when you try to assemble such a file.
  53.  
  54. 1. The '*' used to indicate current address is replaced with '.'.
  55. 2. The usage 'sym1 equ *' would translate to 'sym1 equ .' which has a
  56.      bug (see bug list); it should really be just 'sym1'.
  57. 3. String constants are enclosed in double quotes instead of single
  58.      quotes.
  59. 4. The bit operands had a space separating the mask and label (if one),
  60.      This assembler uses a comma to separate these.
  61. 5. The arguments of bit operations such as BRCLR and BRSET must be
  62.      separated by commas; not spaces as in the Motorola format.
  63. 6. Sasm requires a PROCESSOR pseudo-op at the start of the source file.
  64.      Without it there are no instruction mnemonics only pseudo-ops.
  65.  
  66. Other problems, unrelated to the format are;
  67.  
  68. 1. Most Motorola files did not use segments, they must be used here.
  69.  
  70.  
  71. COMMON PROBLEMS
  72.  
  73. slink reports 'Error 600: Invalid command MEM'
  74.         You own SAS/C 6.x and are seeing a name clash.  You will have
  75.           to refer to slink using a path, usually ADev11:slink
  76. slink reports 'unknown hunk type'
  77.     the assembler may have been aborted leaving a partial file
  78.     the assembler source file may have code outside of a segment
  79. sc11 reports a problem in byte_length
  80.     certain errors in the C source file may cause SC11 to emit
  81.       68000 instructions.  For example
  82.         char c, *chr_ptr;
  83.         c = *(char *)*chr_ptr;
  84.     this may be a legitimate bug.  If there is nothing wrong
  85.       with the C source, reduce the source file as much as
  86.       possible and send it to me.
  87.  
  88.  
  89. KNOWN BUGS ---------------------------------
  90. SC11 - see bug_list in C/
  91. SAsm - a DC.l with a symbol can cause assembler to hang
  92. ALL - the docs should have elaborative error message descriptions
  93. SDis - requires at least one non-executable byte after the last executable
  94.   opcode in memory or it will not print out the disassembled data
  95. Slib - the -r option does nothing.
  96. SSim - the PC reg does not change while single stepping
  97. SC11 - direct structure to structure assign with sizeof() > 6 is wrong
  98. SSim - some interrupt peripheral models do not check for interrupts when
  99.   peripheral registers are modified.
  100. SSim - the memory window does not update for changes to the internal registers
  101.   as a result of instruction execution, these changes can be seen by
  102.   activating the Addr gadget and hitting return.
  103.  
  104.  
  105. RELEASE CHANGES
  106.  
  107. 3.0 ----------------------------------------
  108. SAsm - fixed bugs in expression operations /, >>, << and ?: with respect
  109.   to constant expression tracking
  110. SC11 - fixed bug related to operations on a dereferenced value
  111. SC11 - fixed bug related to the size of the result of boolean operations
  112. SSim - Added a monitor display option for SCI simulation
  113. SSim - SSim now accepts the name of a simulation file (.sim) when started
  114.   from the CLI
  115. SSim - SSim now accepts some screen/monitor options when started from
  116.   the CLI
  117. SSim - Improved interrupt checking on standard SCI and all Timer models
  118. SSim - Memory address base now updates memory address
  119. SSim - single chip/expanded mode is now stored in .sim file
  120. SSim - fixed problem with CPY instruction
  121. SC11 - fixed a couple problems associated with the size of parameters passed
  122.   to functions
  123. SSim - interrupts now force the I bit set
  124. SC11 - corrected problem with passing constants as pointer function parameters
  125. SSim - corrected problems with SWI and WAI
  126. SSim - fixed problem with TAB and TBA
  127. SC11 - most structure to structure assignments corrected
  128. SSim - corrected problem with RTI instruction
  129. SSim - corrected problems with BSET and BSR instructions
  130. SAsm - corrected code generation for certain modes of 6805 binary opcodes
  131.   added mul opcode
  132. SAsm - incorrectly computed the relocation address (+1) for BSET/BCLR
  133.   direct mode instructions causing bad direct and memory bytes
  134. SSim - has been added to this release (see docs)
  135. examples - I thought that the Buffalo monitor for F1 was already included,
  136.   now it is.
  137. 2.1 ----------------------------------------
  138. SC11 - The code generator optimization intended for brclr optimizations
  139.   could be used with the wrong address mode.
  140. SC11 - A particular combination of events in a switch statement would
  141.   omit the generation of a compare instruction
  142. SAsm - I have added high level if-else-endif statements.  See the docs.
  143. Docs - There is now an AmigaGuide version of the documents.
  144. Slink - has a new reserved keyword that makes it possible to generate a
  145.   checksum for your rom.  See the docs.
  146. Slink - would leave libraries open and memory unfreed if an error occurred
  147.   during the library scan.
  148. 2.0b ---------------------------------------
  149. SC11 - situations such as a large bodied if statement in a for loop could
  150.   cause a byte_length error message
  151. C_lib.lib - added getch a non-echoed version of getc
  152. C_lib.lib - fixed incorrect handling of default in switch stmt
  153. SC11 - could generate a short branch where a long branch is required
  154.   if there are DC.x statements in between.
  155. C_lib.lib - various problems with stdio functions fixed
  156. C_lib.lib - more functions added (strcpy, strcmp, strcat plus 'n' versions
  157. struct.inc - new file for defining C like structures in assembly
  158. stdio.h - added conditional definition of NULL
  159. SAsm - fixed incorrect generation for read-modify-write ops using direct,
  160.   or either indexed mode
  161. SAsm - enabled SAsm to recognize and ignore STABS and STABN debug info
  162. SC11 - fixed minor peep-hole optimizer bug, not recognizing 'tba'
  163. SC11 - enabled the generation of debugging information
  164. SAsm - improved handling of equated symbols when used in operations
  165.   so that un-needed promotions are not done.
  166. SAsm - improved handling of equated symbols to reduce promotions to
  167.   word addr from byte addr when not required.  For example
  168.     lab   equ   4
  169.           ldaa  lab     <== this was formerly promoted to word addr
  170. SAsm - corrected reversed opcodes for 6805 word addr mode and indexed word
  171.   addr
  172. SC11 - docs now contain a list of C functions but no function descriptions
  173.   especially required for the non ANSI funcitons
  174. 2.0a ---------------------------------------
  175. SC11 - added optimization to reduce if/while/conditional (*ptr & 0x80)
  176.   type expressions to brset/brclr instructions.