home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource3 / 131_01 / acrl.doc < prev    next >
Encoding:
Text File  |  1985-03-11  |  2.4 KB  |  105 lines
  1.  
  2.  
  3.         8080/8085  .CRL Assembler   vers 2.0
  4.  
  5.                 User Manual
  6.  
  7.                 7 Nov 1983
  8.  
  9.  
  10.  
  11.  
  12. INTRO
  13.  
  14.     This assembler was written to provide a convenient means for assembly
  15. language functions to be linked into a BDS C program.  The input file may
  16. contain global symbol definitions and up to 64 functions.  One level of
  17. file 'include' is provided.  The assembler generates a .CRL output file
  18. ready for linkage with CLINK.
  19.  
  20.  
  21.  
  22. INVOCATION
  23.  
  24.     The command line format is:
  25.  
  26. A>ACRL <source file>[.<extension>] [-o] [-p] [-v]
  27.  
  28.     If no extension is specified, ".CSM" is appended to the source file
  29. name.  The optional switches are:
  30.  
  31.     -o    do NOT generate an output file
  32.     -p    print a listing on the console
  33.     -v    list every byte generated (verbose)
  34.  
  35. The assembly may be aborted from the console by typing ^C.
  36.  
  37.  
  38.  
  39. SOURCE FILE FORMAT
  40.  
  41.     ACRL basically supports a subset of the standard Intel assembly
  42. language.  The only extension is the function definition:
  43.  
  44.     <name>    FUNCTION  <func1>, <func2> ...
  45.         .
  46.         .
  47.         .
  48.         FEND
  49.  
  50.     <name> is the function name and must be 8 characters or less.
  51. Following the FUNCTION keyword is an optional list of other functions
  52. referenced, separated by commas.
  53.  
  54.  
  55.  
  56.  
  57. ACRL PSEUDO OPS
  58.  
  59. INCLUDE        Include filenames must be enclosed in single quotes.
  60.         Nesting is not allowed.
  61.  
  62. EQU        Symbols defined outside of any function are known to
  63.         all functions.  Symbols defined within a function are
  64.         local and may have the same names as local symbols in
  65.         other functions.
  66.  
  67. SET        A local SET directive will refer to a previously defined
  68.         global.  If not previously defined, it is local.
  69.  
  70. DB        Takes a list of 8 bit expressions.  Strings must be
  71.         enclosed in single quotes.
  72.  
  73. DW        Takes a list of 16 bit expressions, any of which may be
  74.         relocatable.
  75.  
  76. DS        Only one expression allowed.  Storage will be filled
  77.         with zeros.
  78.  
  79. END        As usual.
  80.  
  81.  
  82.  
  83.  
  84. EXPRESSIONS
  85.  
  86.     The following operators are supported (in order of precedence):
  87.  
  88.     -  NOT  HIGH  LOW  ()        (unary)
  89.     *  /  MOD  SHL  SHR
  90.     +  -
  91.     AND
  92.     OR  XOR
  93.  
  94.     Within a function, the dollar sign ($) has the value of the
  95. location counter.  The standard relocation rules apply.
  96.  
  97.  
  98.  
  99.  
  100. EXAMPLES
  101.  
  102.     The file TEST1.CSM contains sample usages of all operators and
  103. pseudo ops.  TEST2.CSM contains every 8080 instruction (in opcode
  104. order).  All the possible errors are generated in TEST3.CSM.
  105.