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