home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / new / dev / c / hce / readme.doc < prev    next >
Text File  |  1992-09-02  |  15KB  |  336 lines
  1. ***************************************************************************
  2. *                                                                         *
  3. *                           HCE version 1.0                               *
  4. *                 C Compiler envirenment for the Amiga                    *
  5. *                           by Jason Petty.                               *
  6. *                                                                         *
  7. ***************************************************************************
  8.  
  9. /* Original Compiler Copyright.
  10.  * HCC:
  11.  *
  12.  * Copyright (c) 1988,1989,1991 by Sozobon, Limited.  Author: Johann Ruegg
  13.  *
  14.  * Permission is granted to anyone to use this software for any purpose
  15.  * on any computer system, and to redistribute it freely, with the
  16.  * following restrictions:
  17.  * 1) No charge may be made other than reasonable charges for reproduction.
  18.  * 2) Modified versions must be clearly marked as such.
  19.  * 3) The authors are not responsible for any harmful consequences
  20.  *    of using this software, even if they result from defects in it.
  21.  */
  22.  
  23. /* Original Optimizer Copyright.
  24.  * TOP:
  25.  *
  26.  * Copyright (c) 1988,1989,1991 by Sozobon, Limited.  Author: Tony Andrews
  27.  *
  28.  * Permission is granted to anyone to use this software for any purpose
  29.  * on any computer system, and to redistribute it freely, with the
  30.  * following restrictions:
  31.  * 1) No charge may be made other than reasonable charges for reproduction.
  32.  * 2) Modified versions must be clearly marked as such.
  33.  * 3) The authors are not responsible for any harmful consequences
  34.  *    of using this software, even if they result from defects in it.
  35.  */
  36.  
  37. /* Detlef Wuerkners original Copyright:
  38.  *
  39.  * HCC 2.0 Amiga version 1.1 and TOP 2.0 Amiga version 1.1. I declare the 
  40.  * work done by me as Public Domain. Detlef Wuerkner.
  41.  *
  42.  */
  43.  
  44. /* My Copyright.
  45.  * HCE:
  46.  *
  47.  * Copyright (c) 1994. Author: Jason Petty.
  48.  *
  49.  * Permission is granted to anyone to use this software for any purpose
  50.  * on any computer system, and to redistribute it freely, with the
  51.  * following restrictions:
  52.  * 1) No charge may be made other than reasonable charges for reproduction.
  53.  * 2) Modified versions must be clearly marked as such.
  54.  * 3) The authors are not responsible for any harmful consequences
  55.  *    of using this software, even if they result from defects in it.
  56.  */
  57.  
  58. **************************************************************************
  59. *                      REQUIREMENTS-INSTALLATION                         *
  60. **************************************************************************
  61.  
  62. 1) KickStart Release 2.0 or Higher. (A500+ ,A600 ,A1200, ....)
  63. 2) 2MB ram.
  64. 3) or 1MB ram.(This is the absolute minimum and will limit what you can do)
  65.  
  66. note: Two disk drives or a hard drive are required for any serious work, but
  67.       for anyone just wanting to try HCE, a single drive is ok.
  68.  
  69. Installing HCE:
  70. ---------------
  71. To use HCE from the (HCE:) disk it comes on, do the following:
  72.  
  73.    1) Load Workbench
  74.    2) Place the HCE disk into the Internal drive.
  75.    3) Click on its Icon.
  76.    4) Then click on either the HCE_1MB Icon or the HCE_2MB Icon, 
  77.       (don't click the 2MB Icon if your machine only has 1MB!).
  78.    5) If you have 2 disk drives, place the workbench disk into the external
  79.       drive and the HCE disk into the internal drive.
  80.  
  81. To Install HCE to other disks, See the 'Hce.doc' (on the docs and examples
  82.  disk) for details.
  83.  
  84. HCE was developed on an A1200 with two external disk drives, and has not 
  85. been fully tested on any other Amiga.
  86. If HCE fails to load on your machine, please write to me explaining
  87. the reason why. I will try and fix the problem ready for the next release
  88. of HCE.
  89.  
  90. **************************************************************************
  91. *                          CONTENTS                                      *
  92. **************************************************************************
  93.  
  94. HCE          -   Compiler/Editor with source.
  95. TOP          -   Optimizer with source.
  96. A68K         -   Assembler from Fish disk 508.
  97. Blink        -   Linker from Fish disk 508.
  98. C libraries  -   Standard C libraries from fish disk 314.(with source)(ZC)
  99. Header files -   C library header files also from fish disk 314.
  100. begin.o      -   Startup code also from fish disk 314.
  101. Ami.lib      -   Kickstart release 1.3 to 2.04 Version of Amiga.lib,
  102.                  based upon source from 'PDC' release 3.33.(Fish 351)
  103.  
  104. Required for Amiga specific code but not included:
  105. --------------------------------------------------
  106. The Commodore Include files.
  107.  
  108. On requiring information from commodore as to how much and where to 
  109. obtain the Include files the reply was:
  110.  
  111. To obtain the 1.3 Native Developers disk may I suggest you contact
  112. Sharon Rodrigo at our Maidenhead Office (0628) 770088,
  113. or send a cheque to the amount of £25 to:-
  114.  
  115.        Commodore Business Machines UK Ltd
  116.        Commodore House
  117.        The Switchback
  118.        Gardner Road
  119.        Maidenhead
  120.        Berks
  121.        SL6 7XA
  122.  
  123. The disk contains all the C and Assembler Include files,
  124. the Amiga specific Libraries, Autodocs and much more.
  125.  
  126. note: this letter was received over a year ago, and the price of
  127.       the developer disk could have changed.
  128.       If you decide to obtain the Amiga Include files now, you 
  129.       should ask for Includes which cover Kickstart release 2.04,or Higher.
  130.  
  131. If you do not live in the UK then you should try and contact your
  132. National Commodore office.
  133.  
  134. **************************************************************************
  135. *                           SOURCE                                       *
  136. **************************************************************************
  137.  
  138. Source is provided for HCE,TOP,FD2STUBS and the C libraries in compressed
  139. form. To unpack them format two spare floppies called 'LibSrc:' and 'HceSrc:',
  140. copy the 'LibSource.LZH' file from this disk also the LHARC file from this
  141. disk and the 'HceSource.LZH' from the docs and examples disk to the ram disk.
  142. Then type the following:
  143.  
  144.                 RAM:LHARC -x -a -m x HceSource.LZH HceSrc:
  145.  
  146.                 RAM:LHARC -x -a -m x LibSource.LZH LibSrc:
  147.  
  148.  
  149. ***************************************************************************
  150. *         If you have not programmed in C on the Amiga before:            *
  151. ***************************************************************************
  152.  
  153. The C Manual V2.0 by Anders Bjerin can be found on Fish disk 457.
  154. It describes how to work with Screens, Windows, Graphics, Sprites,
  155. and most other areas of amiga programming.
  156. All the examples provided work with HCE, but some may need minor changes.
  157. note: nearly all the examples require the include files mentioned above.
  158.  
  159.  
  160. Literature I`ve bought and found to be very useful:
  161. --------------------------------------------------
  162.  
  163. Amiga C for Beginners:  
  164.                        A Practical guide to learning and using C,
  165.                        language on your Amiga.
  166.                        Topics include:
  167.                                       Beginner`s overview of C.
  168.                                       Writing your first C program.
  169.                                       Special features of the C language.
  170.                                       Important routines in C libraries.
  171.                                       Input and Output using C.
  172.                                       And much more.
  173.  
  174.                        Abicus books.  Author, Dirk Schaun.(around £18)
  175.  
  176. C By Example:
  177.                        The easiest way to learn how to program.
  178.                        This book teaches at three levels: beginning,
  179.                        intermediate, and advanced.
  180.                        Covers nearly all areas of C programming but is
  181.                        not specifically for the amiga computer, more
  182.                        for PC`s. After saying that, the examples provided
  183.                        (many of) work fine with HCE.
  184.  
  185.                        QUE books. Author, Greg Perry.(around £20)
  186.  
  187. Amiga Rom Kernal Reference Manual - Includes and AutoDocs:
  188.  
  189.                                 (Essential for serious programmers)
  190.  
  191.                        Contains:
  192.                                Summaries of the System library functions.
  193.