home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / programming / misc / m2_part1.lha / modula / dice / dice.LHA / README < prev    next >
Encoding:
Text File  |  1991-04-29  |  7.0 KB  |  196 lines
  1.  
  2.                  DICE SYSTEM
  3.  
  4.                    V2.06.21
  5.                  29 April 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 $5 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.
  33.  
  34.      Source to the DICE binaries is not included.
  35.  
  36.      Source to C.LIB and other link libraries is not included for the
  37.      Freeware version ... they are included for the registerd 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, please dig into your pockets a bit and register.  DICE
  46.     is as close to commercial quality as shareware gets and I think you
  47.     will appreciate the kick in the rump I give various other commercial
  48.     compilers by so easily beating them at their own game.  Refer to the
  49.     doc/REGISTER.DOC for information on registration.
  50.  
  51.     This is the unregistered ShareWare version of DICE, obtained from the
  52.     public nets, it is missing one vital items:  the AMIGA INCLUDES. Most
  53.     developers will already have these but if you do not you can obtain
  54.     them from the Commodore Amiga Technical Support group:
  55.  
  56.     CATS
  57.     1200 Wilson Drive
  58.     West Chester, PA 19380
  59.     USA
  60.  
  61.     (215)431-9100
  62.  
  63.     Include a check for $20 and request that you want the AmigaDOS V1.3
  64.     Native Developer Update.
  65.  
  66.     NOTE:   The unregistered version of DICE comes with an AMIGAS13.LIB
  67.         library which implements most of the 1.3 AMIGA.LIB, and
  68.         AMIGAS20.LIB which implements most of the 2.0 AMIGA.LIB
  69.         functions, such as afp(), CreateTask(), and DeleteTask() are
  70.         missing. The utility FDTOLIB was used to generate the library
  71.         from the 1.3 .FD files plus some additional source that I wrote
  72.         (FDTOLIB is part of the registered distribution)
  73.  
  74.     NOTE:   without the commodore includes you are somewhat limited in
  75.         what you can do with the freeware version.    Note that the
  76.         registered version comes with the commodore includes and full
  77.         amiga.lib .  Since the commodore includes are commodore's, I
  78.         cannot distribute them freely, only through my license which
  79.         restricts distribution to the registered version of DICE.
  80.  
  81.     IF YOU OBTAIN THE COMMODORE AMIGA.LIB, you will want to use it to
  82.     get whatever was left out in the distributed compatible.  To use
  83.     the commodore amiga.lib, you must run it through the LIBTOS program:
  84.  
  85.     1> libtos amiga.lib dlib:amigas13.lib        (1.3 amiga.lib)
  86.     1> libtos amiga.lib dlib:amigas20.lib        (2.0 amiga.lib)
  87.  
  88.     (note that 's' in the destination name -- small-data model version
  89.     of amiga.lib is called amigas.lib).
  90.  
  91.     Since the commodore amiga.lib is more complete than the ones
  92.     distributed here you will want to do this if you have them.
  93.  
  94.     --------------------------    SETTING UP DICE  -------------------------
  95.  
  96.     DICE requires a few things to be set up properly.  There are two
  97.     principle assignments:
  98.  
  99.     DINCLUDE:        assign to DICE's include directory
  100.     DLIB:        assign to DICE's dlib directory
  101.  
  102.     and there is one enviroment variable
  103.  
  104.     ENV:DCCOPTS     DCC core compiler options
  105.  
  106.     Specifically, you want one of the following in your startup-sequence
  107.     to set up the DCCOPTS enviroment variable:
  108.  
  109.     1> setenv DCCOPTS "-1.3"
  110.     1> setenv DCCOPTS "-1.3 -f"
  111.     1> setenv DCCOPTS "-2.0"
  112.  
  113.     If you are running under 1.3 you must use one of the first two
  114.     enviroment variables.  You can use "-f" ONLY if you are running the
  115.     standard commodore shell, this speeds up execution of RESIDENT
  116.     DICE executables.
  117.  
  118.     If you are running under 2.0 you must use the third variable.
  119.  
  120.     DICE uses the -1.3/-2.0 option to define it's search path for the
  121.     includes and amiga.lib.  If -1.3 is selected, DINCLUDE:AMIGA13 is
  122.     added to the includes search path and DLIB:AMIGAS13.LIB is used for
  123.     the amiga.lib.  If -2.0 is selected, DINCLUDE:AMIGA20 is adde to
  124.     the includes search path and DLIB:AMIGAS20.LIB is used for
  125.     the amiga.lib
  126.  
  127.     If you have obtained the amiga includes, you want to set them up as
  128.     follows (example for the 1.3 includes):
  129.  
  130.     DINCLUDE:            (ANSI DICE and other DICE includes)
  131.     DINCLUDE:AMIGA13/        where the 1.3 includes go
  132.     DINCLUDE:AMIGA13/EXEC/*.H
  133.     DINCLUDE:AMIGA13/LIBRARIES/*.H
  134.         etc...
  135.  
  136.     Basically you Copy Includes1.3: DINCLUDE:AMIGA13 CLONE ALL
  137.  
  138.     --------------------------    DYNAMIC.LIBRARY  -------------------------
  139.  
  140.     The subdirectory 'dynamic' contains a new dynamic object management
  141.     library to go with DICE's new __dynamic keyword.  If you are interested
  142.     in fooling around with it please CD into dynamic and read the
  143.     documentation, and try out some of the test programs in DYNAMIC/BIN/
  144.  
  145.                     !!
  146.  
  147.     --------------------------         MISC     -------------------------
  148.  
  149.     Please read DOC/COMPILER.DOC for further installation instructions
  150.  
  151.     The documents you want to read first are:
  152.  
  153.     DOC/BEGINNER_README.DOC For Beginners
  154.     DOC/COMPILER.DOC    SETUP and features (overview)
  155.     DOC/KnownBugs        Things not implemented yet and known bugs
  156.     DOC/DCC.DOC        operation
  157.     DOC/*            other documentation
  158.  
  159.     MAN/*            manual pages are available to registered
  160.                 users.
  161.  
  162.     DISABLED IN THE UNREGISTERED (FREEWARE) VERSION OF DICE,
  163.     BUT EXISTS IN THE REGISTERED VERSION OF DICE
  164.  
  165.     * regargs
  166.     * floating point
  167.     * bit fields
  168.     * manual pages for c.lib
  169.     * source to the entire c.lib and other libraries
  170.     * several type qualifier extensions (see EXTENSIONS.DOC)
  171.     * source to many of the utilities (as examples)
  172.     * additional utilities exist in the registered version
  173.     * the commodore includes are not included in the freeware
  174.       version but are in the registered version
  175.  
  176.     UNIMPLEMENTED IN EITHER VERSION (WORK IN PROGRESS)
  177.  
  178.     * structure returns are not implemented yet
  179.     * stack aggregate initialization of arrays and structures is not
  180.         implemented yet (an ANSI thing)
  181.  
  182.     DICE stands for:
  183.  
  184.     Dillon's Integrated C Enviroment
  185.  
  186.     (name thought up by Dan Wallach)
  187.  
  188.                 --------------
  189.  
  190.     The unregistered shareware version of DICE may be redistributed only
  191.     in whole.
  192.  
  193.     The registered shareware version of DICE may NOT be redistributed.
  194.     Refer to COPYRIGHT.DOC for the full rights.
  195.  
  196.