home *** CD-ROM | disk | FTP | other *** search
/ AMIGA PD 1 / AMIGA-PD-1.iso / Programme_zum_Heft / Programmieren / Kurztests / DiceC / README < prev    next >
Text File  |  1994-02-01  |  9KB  |  222 lines
  1.  
  2.                  DICE SYSTEM
  3.  
  4.                    V2.06.37
  5.                  9 Oct 1991
  6.  
  7.                   Obvious Implementations Corporation
  8.                   P.O. Box 4487
  9.                   Cary, N.C. 27519-4487
  10.                   USA
  11.  
  12.                   USENET: sales@oic.com
  13.  
  14.     DICE (c)Copyright 1990-1991 by Matthew Dillon, All Rights Reserved
  15.     DICE (c)Copyright 1993-1994 by Obvious Implementations Corp, All Rights Reserved
  16.  
  17.     Please read COPYRIGHT.DOC for info on all copyrights, trademarks, and
  18.     other items refered to an included in the DICE distribution.  This file
  19.     exists on both distribution disks.
  20.  
  21.     This is the public distribution release for DICE.  Under no
  22.     circumstances may you redistribute a modified version of the
  23.     distribution.  Period. No exceptions (please?).  I cannot allow this to
  24.     get out of control.  Neither may any redistribution for profit be made
  25.     (you can charge up to $6 beyond your cost for your time)
  26.  
  27.     DICE consists of a frontend, preprocessor, C compiler, assembler, and
  28.     linker, and support libraries all written by myself.  A generated
  29.     (non-commodore) 2.0 amiga.lib is included with this distribution.  Note
  30.     that you may compile 1.3 programs with the 2.0 amiga.lib as long as
  31.     you avoid 2.0-specific calls.
  32.  
  33.     Source to the DICE binaries is not included (Most except the compiler,
  34.     linker, and assembler are included in the commercial version)
  35.  
  36.     Source to C*.LIB and other link libraries is not included for the
  37.     Freeware version ... they are included for the commercial version.
  38.  
  39.     DICE also includes my DMAKE make utility (though it should be noted
  40.     that DMAKE is extremely difficult to learn how to use).  Source is not
  41.     available (it isn't fit to be distributed).  DMAKE works best running
  42.     under 2.0 due to the available of new system calls.
  43.  
  44.     This is the unregistered FreeWare version.    If you find yourself using
  45.     DICE seriously, you should consider the commercial version. Refer to the
  46.     doc/REGISTER.DOC for information on commercial version.
  47.  
  48.     This is the unregistered FreeWare version of DICE, obtained from the
  49.     public nets, and it is missing one vital item:  the AMIGA INCLUDES.
  50.     Most developers will already have these but if you do not you can
  51.     obtain them from the Commodore Amiga Technical Support group:
  52.  
  53.     Commodore
  54.     Dept. C
  55.     1200 Wilson Drive
  56.     West Chester, PA.  19380
  57.     USA
  58.  
  59.     (215)431-9100
  60.  
  61.     *** TO PURCHASE THE AMIGA INCLUDES **
  62.  
  63.     Include a check for $20 and request that you want the AmigaDOS V1.3
  64.     Native Developer Update.  THIS IS A NEW ADDRESS.  THE OLD CATS ADDRESS
  65.     NO LONGER HANDLES SUPPORT MATERIAL PURCHASES.
  66.  
  67.     NOTE THAT THE AMIGA INCLUDES AND LIBRARIES ARE INCLUDED IN THE
  68.     COMMERCIAL VERSION OF DICE, BUT THE AUTODOCS ARE NOT.  THEREFORE,
  69.     IF YOU INTEND TO PURCHASE IT YOU PROBABLY DO *NOT* WANT TO PURCHASE
  70.     THE NATIVE DEVELOPER UPDATE FROM COMMODORE.
  71.  
  72.     ***
  73.  
  74.     NOTE:   The unregistered version of DICE comes with an AMIGAS13.LIB
  75.         library which implements most of the 1.3 AMIGA.LIB, and
  76.         AMIGAS20.LIB which implements most of the 2.0 AMIGA.LIB. Some
  77.         Functions, such as afp(), CreateTask(), and DeleteTask() are
  78.         missing. The utility FDTOLIB was used to generate the library
  79.         from the 1.3 and 2.0 .FD files plus some additional source.
  80.         (part of the commercial distribution)
  81.  
  82.     NOTE:   without the commodore includes you are somewhat limited in
  83.         what you can do with the freeware version.    Note that the
  84.         Commercial version comes with the commodore includes and full
  85.         amiga.lib .  Since the Commodore includes are Commodore's, I
  86.         cannot distribute them freely, only through my license which
  87.         restricts distribution to the Commercial version of DICE.
  88.  
  89.     IF YOU OBTAIN THE COMMODORE AMIGA.LIB, you will want to use it to
  90.     get whatever was left out in the distributed compatible.  To use
  91.     the commodore amiga.lib, you must run it through the LIBTOS program:
  92.  
  93.     1> libtos amiga.lib dlib:amigas13.lib        (1.3 amiga.lib)
  94.     1> libtos amiga.lib dlib:amigas20.lib        (2.0 amiga.lib)
  95.  
  96.     (note that 's' in the destination name -- small-data model version
  97.     of amiga.lib is called amigas.lib).
  98.  
  99.     Since the commodore amiga.lib is more complete than the ones
  100.     distributed here you will want to do this if you have them.
  101.  
  102.     --------------------------    SETTING UP DICE  -------------------------
  103.  
  104.     DICE requires a few things to be set up properly.  There are two
  105.     principle assignments:
  106.  
  107.     DINCLUDE:        assign to DICE's include directory
  108.     DLIB:        assign to DICE's dlib directory
  109.  
  110.     and there is one enviroment variable
  111.  
  112.     ENV:DCCOPTS     DCC core compiler options
  113.  
  114.     Specifically, you want one of the following in your startup-sequence
  115.     to set up the DCCOPTS enviroment variable.    Since only the 2.0 amiga.lib
  116.     is included you must specify the -2.0 option or DICE will be unable to
  117.     link.
  118.  
  119.     1> setenv DCCOPTS "-2.0"
  120.     1> setenv DCCOPTS "-2.0 -f"
  121.  
  122.     You can use "-f" ONLY if you are running the standard commodore shell,
  123.     this speeds up execution of RESIDENT DICE executables as well as hacks
  124.     in ^C handling under 1.3.  The -f option has no effect under 2.0
  125.  
  126.     DICE uses the -1.3/-2.0 option to define it's search path for the
  127.     includes and amiga.lib.  If -1.3 is selected, DINCLUDE:AMIGA13 is added
  128.     to the includes search path and DLIB:AMIGAS13.LIB is used for the
  129.     amiga.lib.    If -2.0 is selected, DINCLUDE:AMIGA20 is adde to the
  130.     includes search path and DLIB:AMIGAS20.LIB is used for the amiga.lib ..
  131.     the freeware release of DICE cannot include these commodore includes.
  132.  
  133.     If you have obtained the amiga includes, you want to set them up as
  134.     follows (example for the 1.3 includes):
  135.  
  136.     DINCLUDE:            (ANSI DICE and other DICE includes)
  137.     DINCLUDE:AMIGA13/        where the 1.3 includes go
  138.     DINCLUDE:AMIGA13/EXEC/*.H           .
  139.     DINCLUDE:AMIGA13/LIBRARIES/*.H           .
  140.         etc...
  141.  
  142.     Basically you Copy Includes1.3: DINCLUDE:AMIGA13 CLONE ALL
  143.     (or similar copy for the 2.0 includes if you have them)
  144.  
  145.     If you obtain the 1.3 amiga.lib from commodore you may create DICE
  146.     compatible amiga.lib's by:
  147.  
  148.     copy amiga.lib dlib:
  149.     cd dlib:
  150.     rename amiga.lib amigal13.lib        ; convert to DICE nomenclature
  151.     libtos amigal13.lib amigas13.lib    ; generate small-data version
  152.  
  153.     If you obtain and setup the commodore 1.3 includes/amiga.lib you will
  154.     want to change your DCCOPTS '-2.0' option to '-1.3' so DICE can find
  155.     them.  If, on the otherhand, you obtain the commodore 2.0
  156.     includes/amiga.lib you will want to leave DCCOPTS set to '-2.0'.
  157.  
  158.  
  159.     --------------------------    DYNAMIC.LIBRARY  -------------------------
  160.  
  161.     The subdirectory 'dynamic' contains a new dynamic object management
  162.     library to go with DICE's new __dynamic keyword.  If you are interested
  163.     in fooling around with it please CD into dynamic and read the
  164.     documentation, and try out some of the test programs in DYNAMIC/BIN/
  165.  
  166.     Note that this may be lharc'd.  To unarchive:
  167.  
  168.     1> lharc -r -x -a x dynamic
  169.  
  170.     dynamic.library may be more of use for machine-global shared variables
  171.     then for machine-global shared subroutines.
  172.  
  173.                     !!
  174.  
  175.     --------------------------         MISC     -------------------------
  176.  
  177.     Please read DOC/COMPILER.DOC for further installation instructions
  178.  
  179.     The documents you want to read first are:
  180.  
  181.     DOC/BEGINNER_README.DOC For Beginners
  182.     DOC/COMPILER.DOC    SETUP and features (overview)
  183.     DOC/KnownBugs        Things not implemented yet and known bugs
  184.     DOC/DCC.DOC        operation
  185.     DOC/*            other documentation
  186.  
  187.     MAN/*            manual pages are available to commercial
  188.                 users.
  189.  
  190.     DISABLED IN THE UNREGISTERED (FREEWARE) VERSION OF DICE,
  191.     BUT EXISTS IN THE COMMERCIAL VERSION OF DICE
  192.  
  193.     * regargs
  194.     * floating point
  195.     * bit fields
  196.     * Visual make environment
  197.     * Source Line debugger
  198.     * manual pages for c.lib
  199.     * source to the entire c.lib and other libraries
  200.     * several type qualifier extensions (see EXTENSIONS.DOC)
  201.     * source to many of the utilities (as examples)
  202.     * Many additional utilities exist in the commercial version
  203.     * the commodore includes are not included in the freeware
  204.       version but are in the Commercial version
  205.  
  206.     DICE stands for:
  207.  
  208.     Dillon's Integrated C Enviroment
  209.  
  210.     (name thought up by Dan Wallach)
  211.  
  212.                 --------------
  213.  
  214.     The unregistered shareware version of DICE may be redistributed only in
  215.     whole.  Do not delete or modify any files.    You may add files according
  216.     to whatever distribution method you use or, for example, to translate
  217.     documentation to another language, but original documentation must
  218.     remain as well.
  219.  
  220.     The commercial version of DICE may NOT be redistributed.
  221.  
  222.