home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / GameSmith2-Hisoft-Tutorial.DMS / in.adf / DICE_GS.lha / DICE_GS / README < prev    next >
Encoding:
Text File  |  1994-11-19  |  4.5 KB  |  120 lines
  1.  
  2.                 THE DICE SYSTEM
  3.                   V2.06.37
  4.  
  5.  
  6.     DICE (c)Copyright 1990-1991 by Matthew Dillon, All Rights Reserved
  7.     DICE (c)Copyright 1993-1994 by Obvious Implementations Corp, All Rights
  8.             Reserved
  9.  
  10.  
  11.     DICE is a complete C compiler system for the Commodore Amiga line
  12.     of computers.  You have recived a limited, but still functional
  13.     version of DICE.  Should you desire more power or features, an easy
  14.     to use manual, and a friendly installation script, a full commercial
  15.     version is also available.
  16.  
  17.     Please read COPYRIGHT.DOC for info on all copyrights, trademarks, and
  18.     other items refered to and included in the DICE distribution.
  19.  
  20.  
  21.     DICE consists of a frontend, preprocessor, C compiler, assembler, and
  22.     linker, and support libraries.  A generated (non-commodore) 2.0 amiga.lib
  23.     is included with this distribution.  Note that you may compile 1.3
  24.     programs with the 2.0 amiga.lib as long as you avoid 2.0-specific calls.
  25.  
  26.     Source to the DICE binaries is not included (Most sources, except
  27.     for the compiler, linker, and assembler are included in the
  28.     commercial version).
  29.  
  30.  
  31. ------------------------------  SETTING UP DICE  --------------------------
  32.  
  33.     DICE requires a few things to be set up properly.  There are two
  34.     principle assignments:
  35.  
  36.     DINCLUDE:       assign to DICE's include directory
  37.     DLIB:       assign to DICE's dlib directory
  38.  
  39.     and there is one enviroment variable
  40.  
  41.     ENV:DCCOPTS     DCC core compiler options
  42.  
  43.     Specifically, you want one of the following in your startup-sequence
  44.     to set up the DCCOPTS enviroment variable.  Since only the 2.0 amiga.lib
  45.     is included you must specify the -2.0 option or DICE will be unable to
  46.     link.
  47.  
  48.     1> setenv DCCOPTS "-2.0"
  49.     1> setenv DCCOPTS "-2.0 -f"
  50.  
  51.     You can use "-f" ONLY if you are running the standard commodore shell,
  52.     this speeds up execution of RESIDENT DICE executables as well as hacks
  53.     in ^C handling under 1.3.  The -f option has no effect under 2.0
  54.  
  55.     DICE uses the -1.3/-2.0 option to define it's search path for the
  56.     includes and amiga.lib.  If -1.3 is selected, DINCLUDE:AMIGA13 is added
  57.     to the includes search path and DLIB:AMIGAS13.LIB is used for the
  58.     amiga.lib.  If -2.0 is selected, DINCLUDE:AMIGA20 is adde to the
  59.     includes search path and DLIB:AMIGAS20.LIB is used for the amiga.lib ..
  60.     This release of DICE GS cannot include these commodore includes.
  61.  
  62.     If you have obtained the amiga includes, you want to set them up as
  63.     follows (example for the 1.3 includes):
  64.  
  65.     DINCLUDE:           (ANSI DICE and other DICE includes)
  66.     DINCLUDE:AMIGA13/       where the 1.3 includes go
  67.     DINCLUDE:AMIGA13/EXEC/*.H          .
  68.     DINCLUDE:AMIGA13/LIBRARIES/*.H         .
  69.         etc...
  70.  
  71.     Basically you Copy Includes1.3: DINCLUDE:AMIGA13 CLONE ALL
  72.     (or similar copy for the 2.0 includes if you have them)
  73.  
  74.     If you obtain the 1.3 amiga.lib from commodore you may create DICE
  75.     compatible amiga.lib's by:
  76.  
  77.     copy amiga.lib dlib:
  78.     cd dlib:
  79.     rename amiga.lib amigal13.lib       ; convert to DICE nomenclature
  80.     libtos amigal13.lib amigas13.lib    ; generate small-data version
  81.  
  82.     If you obtain and setup the commodore 1.3 includes/amiga.lib you will
  83.     want to change your DCCOPTS '-2.0' option to '-1.3' so DICE can find
  84.     them.  If, on the otherhand, you obtain the commodore 2.0
  85.     includes/amiga.lib you will want to leave DCCOPTS set to '-2.0'.
  86.  
  87. ----------------------------------------------------------------------------
  88.  
  89.     Please read DOC/COMPILER.DOC for further installation instructions
  90.  
  91.     The documents you want to read first are:
  92.  
  93.     DOC/BEGINNER_README.DOC For Beginners
  94.     DOC/COMPILER.DOC    SETUP and features (overview)
  95.     DOC/KnownBugs       Things not implemented yet and known bugs
  96.     DOC/DCC.DOC     operation
  97.     DOC/*           other documentation
  98.  
  99.     DISABLED IN THE GS VERSION OF DICE,
  100.     BUT EXISTS IN THE COMMERCIAL VERSION OF DICE
  101.  
  102.     * regargs
  103.     * floating point
  104.     * bit fields
  105.     * Visual make environment
  106.     * Online help
  107.     * Installation script
  108.     * Source Line debugger
  109.     * manual pages for c.lib
  110.     * source to the entire c.lib and other libraries
  111.     * several type qualifier extensions (see EXTENSIONS.DOC)
  112.     * source to many of the utilities (as examples)
  113.     * Many additional utilities exist in the commercial version
  114.     * the commodore includes are not include aare in the Commercial version
  115.  
  116.     DICE stands for:
  117.  
  118.     Dillon's Integrated C Enviroment (name by Dan Wallach)
  119.  
  120.