home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff384.lzh / NorthC / NorthC1.LZH / CONTENTS < prev    next >
Text File  |  1990-09-09  |  5KB  |  180 lines
  1. (c) 1990 S.Hawtin.
  2.  
  3.   NorthC 1.2 provides an selection of programs, documentation and 
  4. examples, if your version does not contain all the following you should 
  5. complain to the person you got it from.
  6.  
  7.   This release has been spread across two disks, this gives me enough space 
  8. to include a larger set of examples.  The "NorthC:" disk contains the 
  9. essential programs, the "NorthC Examples:" disk contains some examples and 
  10. some of the source code for the programs.
  11.  
  12.  
  13. "NorthC:" disk
  14.  
  15.  
  16. setup-NorthC  Single-make  Dual-Disk  Hard-Disk
  17.  
  18.   These script files set up the NorthC environment, you should edit the 
  19. "setup-NorthC" file to call the setup file that is needed for your system.
  20.  
  21.  
  22. README
  23.  
  24.   A quick introduction to the astounding bonuses of using one of the best 
  25. value for money 'C' compilers on the Amiga.
  26.  
  27.  
  28. CONTENTS
  29.  
  30.     A list of the contents of the "NorthC:" disk, this file in fact.
  31.  
  32.  
  33. CHANGES
  34.  
  35.   This file lists the changes that have been made to NorthC in each release, 
  36. it will be of most use if you are updating an old NorthC disk.
  37.  
  38.  
  39. CONTRIBUTORS
  40.  
  41.   This file lists some of the people that have helped make NorthC possible.
  42.  
  43.  
  44. tools
  45.  
  46.   The source files for the ar and cc programs, the command "make" will 
  47. recompile these files for you.  These are here mainly as examples that are 
  48. garenteed to compile with NorthC.  Also cc.c is a good program to hack 
  49. about a bit if you want to change your top level interface.
  50.  
  51.  
  52. clibs
  53.  
  54.   The 'C' library files, this directory contains the files NorthC requires
  55. for the standard library and the startup routines.  These files include 
  56. documentation of the 'C' library, source for the startup routines and the 
  57. 'C' library itself.
  58.  
  59.  
  60. bin
  61.  
  62.   This directory contains the actual tools, the compiler, assembler, linker, 
  63. optimiser, make program and front end for NorthC, these mostly come from 
  64. other people see the documentation for the originators.
  65.  
  66.  
  67. bin/NorthC  bin/NorthC.doc
  68.  
  69.   The compiler, this will translate 'C' source into assembler files.  
  70. Read the file "bugs.doc" to find details of the current release.
  71.  
  72.  
  73. bin/a68k  bin/A68k.doc
  74.  
  75.   The assembler from Charlie Gibbs, again the doc file gives more details.
  76. This translates assembler files into object files.
  77.  
  78.  
  79. bin/Blink   bin/Blink.doc
  80.  
  81.   The linker from "The Software Distillary", see the doc file for details.
  82. This combines object files and libraries to produce executable programs.
  83.  
  84.  
  85. bin/Bugs.doc
  86.  
  87.   A list of known bugs in this version of NorthC, this includes work 
  88. arounds for many of the bugs.  It is important to read this document when 
  89. you find your program not behaving as it should.
  90.  
  91.  
  92. bin/make bin/make.doc
  93.  
  94.   The make program, I have supported the basic elements of "make" but some 
  95. elements, such as variables, are missing.
  96.  
  97.  
  98. bin/cc  bin/cc.doc
  99.  
  100.   The front end, this will control the compiler assembler and linker.  This
  101. program loosly follows the normal UNIX conventions, however it needs to be
  102. hacked before it does everything you will need.
  103.  
  104.  
  105. bin/ar
  106.  
  107.   The library creator, note this takes a very simple view of creating 
  108. libraries, it just concatenates files together.  See the tools directory
  109. to examine the source.
  110.  
  111.  
  112. bin/top  bin/top.doc
  113.  
  114.   The optimiser, this program will make assembler code more efficient.
  115.  
  116.  
  117. include
  118.  
  119.   This directory contains the "include" files, the compiler automatically 
  120. looks in the ":include" directory for the include files, if you want it to 
  121. look elsewhere change the "INCLUDE" environment variable.  All the standard 
  122. header files are in this directory.
  123.  
  124.  
  125. Texts
  126.  
  127.   This directory contains various texts that I thought people would be 
  128. interested in reading.
  129.  
  130.  
  131. "NorthC Examples:" disk
  132.  
  133.  
  134. hello
  135.  
  136.   This is a bare directory to create the "hello.c" program in, it contains 
  137. a file "hello.doc" that explains how to create a simple 'C' program.
  138.  
  139.  
  140. CRender
  141.  
  142.   This directory contains an example program, this program draws three 
  143. dimensional solid models, it also calls intuition and some graphics 
  144. routines.
  145.  
  146.  
  147. clibs/UNIX
  148.  
  149.   This directory contains an example 'C' library, this one implements some 
  150. UNIX like file handling routines.
  151.  
  152.  
  153. disass
  154.  
  155.   This example program was sent in by Martin Combs, it disassembles object 
  156. files, printing them out as machine instructions.
  157.  
  158.  
  159. fortune
  160.  
  161.   A simple "fortune" type program, this prints out sayings from a file 
  162. in the directory.
  163.  
  164.  
  165. mini-hello
  166.  
  167.   This directory shows what you can do by manipulating the startup routines 
  168. in your NorthC programs.
  169.  
  170.  
  171. top  make
  172.  
  173.   The source code for some of the tools in the "NorthC:bin" directory.
  174.  
  175.  
  176. translate
  177.  
  178.   A utility program to perform simple text substitutions, for example to 
  179. translate ASCII files into a format that a word processor understands.
  180.