home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / CASSM.SFX / assm.readme < prev    next >
Encoding:
Text File  |  1992-11-27  |  2.0 KB  |  106 lines
  1. 08/15/85
  2.  
  3. ╘HE ├-┴╙╙═ ASSEMBLER IS BUILT AS FOLLOWS:
  4.  
  5. 1.  ╘HERE ARE 9 SOURCE ELEMENTS, NAMED
  6.     AS FOLLOWS:
  7.  
  8.     A. ASSM.D1 - GLOBAL #DEFINES
  9.  
  10.     B. ASSM.D2 - EXTERNAL DEFINITIONS
  11.  
  12.     C. ASSM0.C - GLOBAL DATA
  13.  
  14.     D. ASSM1.C - MAIN PROGRAM
  15.  
  16.     E. ASSM2.C - OPCODE/SYMBOL ROUTINES
  17.  
  18.     F. ASSM3.C - INSTRUCTION, PSEUDO-OP
  19.                  PROCESSORS
  20.  
  21.     G. ASSM4.C - EXPRESSION EVALUATOR
  22.  
  23.     H. ASSM5.C - RELOCATABLE OBJECT
  24.                  FORMATTER
  25.  
  26.     I. OPENFILE.C - FILENAME EXTENSIONS
  27.  
  28.     ├OMPILE ELEMENTS C THROUGH I.
  29.  
  30. 2.  ╠INK THE ASSEMBLER.  ╘HIS MUST BE
  31.     DONE WITH AN INTERMEDIATE LIBRARY
  32.     SEARCH DUE TO THE NUMBER OF XREFS
  33.     CONTAINED IN THE OBJECT MODULES:
  34.  
  35.     $ LINK
  36.     > ASSM0.O
  37.     > ASSM1.O
  38.     > ASSM2.O
  39.     > ^
  40.     > ASSM3.O
  41.     > ASSM4.O
  42.     > ASSM5.O
  43.     > OPENFILE.O
  44.     > ^
  45.     >
  46.       OUTPUT TO: ASSM.SH
  47.     $
  48.  
  49.  
  50. 3.  ╘EST THE ASSEMBLER BY FIRST 
  51.     ASSEMBLING THE GENERAL PURPOSE
  52.     TEST SOURCE, ASSMTEST.A:
  53.  
  54.     $ ASSM -FIS ASSMTEST.A >>
  55.  
  56.     ┼XAMINE THE LISTING FOR ERRORS
  57.     AND CORRECT CODE GENERATION.  ╘HERE
  58.     SHOULD BE NO ERRORS.
  59.  
  60.     ╘HE NEXT PROGRAM TESTS THE EXTERNAL
  61.     DEFINITION / EXTERNAL REFERENCE
  62.     CAPABILITIES:
  63.  
  64.     $ ASSM -FIS CHRTEST1.A CHRTEST2.A
  65.     $ LINK 
  66.     > CHRTEST1.O
  67.     > CHRTEST2.O    
  68.     >
  69.       OUTPUT TO: CHRTEST.SH
  70.     $ CHRTEST
  71.     ┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌
  72.     $
  73.  
  74.     ╘HE PRINTOUT OF THE ALPHABET IS
  75.     PERFORMED BY CHRTEST2, WHICH IS
  76.     CALLED FROM CHRTEST1.  ╘HE STRING
  77.     CONTAINING THE ALPHABET IS DEFINED
  78.     IN CHRTEST1.  ╘HUS, BOTH MODULES
  79.     MUTUALLY REFERENCE EACH OTHER FOR
  80.     SYMBOL RESOLUTION.
  81.  
  82.  
  83. 4.  ═ORE COMPLETE TEST OF RELOCATABLITY
  84.     AND EXTERNAL REFERENCE CAPACITY:
  85.  
  86.     $ CC -FS ATEST1.A ATEST2.A
  87.     $ LINK
  88.  
  89.     > ATEST1.O
  90.     > ATEST2.O
  91.     OUTPUT TO: ATEST.SH
  92.  
  93.     ╘HE PROGRAM PRINTS:
  94.  
  95.     ╚ELLO, WORLD!
  96.     ╘HIS IS AN EXTERNAL MESSAGE
  97.     ╟OODBYE!
  98.  
  99. 5.  ╘HE FILE CONDTEST.A TESTS THE
  100.     CONDITIONAL ASSEMBLY FEATURES.
  101.  
  102.     ASSM -F CONDTEST.A
  103.  
  104.     ├HECK THE LISTING TO SEE THAT THE
  105.     PROPER LINES GENERATE CODE.
  106.