home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d141 / smallc.lha / SmallC / 1stRead.MeS < prev    next >
Text File  |  1988-05-15  |  4KB  |  70 lines
  1.  
  2.   Copyright (C) 1988 by Willi Kusche.
  3.  
  4.   This Small-C compiler system is NOT in the public domain.  However,
  5. permission is given to freely distribute this system provided that no fee is
  6. charged and that this documentation file is included with the system.
  7.  
  8.   A Small-C compiler, capable of compiling itself, was written by Ron Cain
  9. and appeared in Dr. Dobb's Journal in about 1980.  This Amiga version, of
  10. Cain's compiler, was 'ported to the Amiga by Willi Kusche, SYSOP of the KMMM
  11. Pascal BBS.  This BBS operates 24 hours a day, 7 days a week and can be reached
  12. at (609) 232-0773.  Maximum baud rate is 9600 (USRobotics HST).
  13.  
  14.   This archive consists of the following files:
  15.     1. 1stRead.Me - what you are reading now
  16.     2. Small-C source files for the compiler
  17.          A. CCDEFS.C - define statements
  18.          B. AMIGA.H - system specific define statements
  19.          C. CCGLOBAL.C - global variables
  20.          D. CC12.C - first two parts of compiler logic
  21.          E. CC34.C - second two parts of compiler logic
  22.          F. CCEXPR.C - logic for expression parser
  23.          G. CC78.C - last two parts of compiler logic
  24.     3. Small-C files that include the pieces described above
  25.          A. CC1.C
  26.          B. CC2.C
  27.          C. CC3.C
  28.          D. CC4.C
  29.     4. SMCLIB.ASM - Assembly language source file for the run time package
  30.     5. BUILDSMC - 'EXECUTE' this file to re-generate the Small-C compiler
  31.  
  32.   The following files are NOT supplied as part of this archive and are
  33. needed to compile, assemble and link the assembly language files generated by
  34. the Small-C compiler.
  35.     1. The Small-C compiler itself  (SMCEAMI.ARC)
  36.     2. An assembler                 (A68K.ARC)
  37.     3. A linkage editor             (BLINK67.ARC)
  38.     4. A jump table map             (SMALLLIB.ARC)
  39.  
  40.   If you are into writing assembly language programs for the Amiga, you
  41. probably already have items 2, 3 and 4.  If not, they can be obtained from
  42. the KMMM Pascal BBS, using the names in parentheses, from the paragraph
  43. above.
  44.  
  45.   There are two non-commercial assemblers and a bunch of commercial assemblers
  46. available for the Amiga.  Of all these assemblers, the one written by Charlie
  47. Gibbs is the only one that has been proven capable of assembling the assembly
  48. language source files generated by this Small-C compiler.
  49.  
  50.   The linker, named BLINK, is the one used during the development of this
  51. Small-C compiler.  However, the linker named ALINK should also work
  52. satisfactorily.
  53.  
  54.   The jump table map file used during the development of this Small-C compiler
  55. is named SMALL.LIB.  This file is a distillation of the information contained
  56. in the file named AMIGA.LIB.  SMALL.LIB was found by the author, on a BBS named
  57. Deep Thought, at (919) 471-6436.  BLINK is also available on Deep Thought.
  58.  
  59.   To rebuild the Small-C compiler, enter the command 'EXECUTE BUILDSMC' from
  60. the CLI command prompt.  At the first prompt from the compiler, respond with
  61. 'Y'.  If an error does occur during compilation of the compiler itself, it
  62. indicates that the source files have been corrupted and you will want to stop.
  63. At the second prompt, respond with 'N'.  At the third prompt, respond with 'Y'.
  64. At the fourth, sixth, eighth and tenth prompts, respond with 'CC1.C', 'CC2.C',
  65. 'CC3.C' and 'CC4.C', respectively.  At the fifth, seventh, ninth and eleventh
  66. prompts, respond with 'CC1.ASM', 'CC2.ASM', 'CC3.ASM' and 'CC4.ASM',
  67. respectively.  At the last prompt from the compiler, just hit the return key.
  68. The remaining assembly and link steps will run automatically, under the
  69. control of the CLI 'execute' logic.
  70.