home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / diceconfig-2.0.lha / DiceConfig / DiceConfig2.0.doc < prev    next >
Text File  |  1993-11-28  |  14KB  |  308 lines
  1. ›0m
  2.                              ›41m                   ›0m
  3.         ›40m                     ›41m  ›32mDiceConfig V2.0 ›31m ›0m
  4.         ›40m                     ›41m                   ›0m
  5.         ›40m                     ›41m ›32m© ›33mLF›31m ›33mSoft ›32m1992-93›31m ›0m
  6.         ›40m                     ›41m                   ›0m
  7. ›0m
  8.  
  9.        ›0;33;1m ^ ›0m
  10.        ›0;33;1m/›31m!›33m\›0m CAUTION : DiceConfig 2.0 is WORKBENCH ONLY, and need KS 2.0+ &
  11.        ›0;33;1m¯T¯›0m ~~~~~~~~  ReqTools.library 38+.
  12.  
  13.  ›0;4;1mDisclamer :›0m
  14.  
  15.      DiceConfig V2.0 is SHAREWARE, Following is for EVALUTIONs versions only
  16. as REGISTERED version CAN'T be distribued in any ways :
  17.  
  18.      - All part of this distribution MUST NOT be changed in any way ( Except
  19.     for use of archivers ( Lha, ... ) or crunchers ( PowerPacker,
  20.     TurboImploder, ... ). I add the .cd file for making new catalogs.
  21.     Remember I JUST MAKE THE NATIVE ENGLISH AND THE FRENCH CATALOG. Others
  22.     are not mine but New catalogs are wellcome ( feel free for sending a
  23.     copy ).
  24.  
  25.      - DiceConfig mustn't be sold with commercial product.
  26.  
  27.      - The price of DiceConfig disk must be resonable, not higher than a
  28.     Fred Fish disk.
  29.  
  30.      - Distribution is granted for Fred Fish and CAM libraries.
  31.  
  32.      - The registered version MUST NOT be distribued or copied in any way.
  33.  
  34.  ›0;4;1mTo register :›0m
  35.  
  36.      The register fees is only 100 FF, $20 (or equivalent in other currency)
  37.     This give you a free update.
  38.     My address is :
  39.  
  40.                 Laurent Faillie
  41.                  "Les Vuardes"
  42.                 74930 Pers-Jussy
  43.                     FRANCE
  44.  
  45.   ›0;4;1mShort introduction :›0m
  46.  
  47.      DiceConfig is a new frontend for Dice C compiler, with a fine (I hope!)
  48.     GUI based on GadTools.library and feeling of WB 2.0+. Under 2.1+, it can
  49.     be localized. It run Dcc using  System()  or it can send  commands to an
  50.     ARexx port ( to Csh for example ). Work even if Arexx isn't running !
  51.     The GUI is font sensitive and can be iconified using standard zoom gadget.
  52.     DiceConfig can be customized by setting Tools Type in its icon & filling
  53.     a configuration file. As in V1.x, up to  16  externals libraries  can be
  54.     linked using gadgets.
  55.  
  56.      Unlike most of EVALUATION versions, no options dislabed ( you can save,
  57.     load any number of project you want ) but a #?*@ requester come up every
  58.     2 minutes.
  59.  
  60.  ›0;4;1mTools types :›0m
  61.  
  62.      MODE=
  63.         EXECUTE (default) : Use System() for running the compiler.
  64.         AREXX             : Send CMD as an Arexx message.
  65.  
  66.     AREXX_PORT=<name>   : In Arexx mode, the name of an ARexx port.
  67.                          (default :rexx_csh).
  68.  
  69.     START_CMD=<command line>
  70.                         : Command to run at the beginning of DiceConfig.
  71.                         ie: for starting a slave CSH... See Start_CSH script.
  72.                         (default : nothing).
  73.  
  74.     RX_END_CMD=<cmd>    :In Arexx mode,command to send when the user quit
  75.                         DiceConfig2.0. (Default : bye).
  76.  
  77.     CMD=<command line>  :The command for running the compiler. Use a C-like
  78.                         format where %f is swapped w/ a name of a file holding
  79.                         all sources files name ( See @ option of DCC ),
  80.                                      %r is swapped w/ the name of the output
  81.                         file ( the name of the project).
  82.                         (Default : Dcc @%f -o%r)
  83.  
  84.     CMD_AFF=<cmd>       : Command for displaying errors messages.
  85.                         (Default : More)
  86.  
  87.     CMD_ED=<cmd>        : Editor. (Default : Ed)
  88.  
  89.     DBG_LIB=<library>   : A link-library added if DEBUG <> 0. eg debug.lib
  90.                         (default : None)
  91. NOTE: Other debug options may be added after the library name. eg:
  92.         DBG_LIB=Debug.lib -lDDebug.lib -d1
  93.       Link w/ Debug.lib, DDebug.lib and add a debug level 1 hunk.
  94.  
  95.     CC_STACK=<stack size>
  96.                         : The stack for the compiler (default : 10000).
  97.  
  98.     CMD_STACK=<cmd>     : In ARexx mode, the name of stack command.
  99.                         eg for Csh : stack %d. (Default : Nothing)
  100.  
  101.     TOOLS_STACK=<stack size>
  102.                         : The stack for CMD_AFF & CMD_ED.
  103.  
  104.   NOTE : DiceConfig always laught CMD_AFF & CMD_ED using System().
  105.  
  106.  
  107.  ›0;4;1mThe configuration file :›0m
  108.  
  109.      DiceConfig V2.0 need a configuration file named
  110.     dcc:config/DiceConfig.cfg
  111.  
  112.                (0)  ›42m TST0 Test file   ›0m
  113.                (1)  ›42m -2.0 -ms -//     ›0m
  114.                (2)  ›42m Math             ›0m
  115.                (3)  ›42m -lm              ›0m
  116.                     ›42m                  ›0m
  117.  
  118.      Line 0 contain the file version 'TST0'. Only the 4 firsts characteres
  119.     are important,
  120.      Line 1 contain always specified options ( like OS version ),
  121.      Further  couple  of lines contains  libraries to link with. First the
  122.     name diplayed in the gadget ( as line 2 ), and,  secondly , the  dcc's
  123.     options. In this example, only one gadget is used  [Math]  and ,  when
  124.     selected, '-lm' is added in DccOpts.
  125.      All lines starting by '#' is ignored (comments).
  126.  
  127.      Note : You can still use 1.x version of DiceConfig ( for simple file
  128.     project for example ) as configuration file of 1.x is
  129.             Dlib:DiceConfig.cfg
  130.  
  131.  
  132.  ›0;4;1mThe GUI :›0m
  133.  
  134.      DiceConfig V2.0 is basicaly a window:
  135.        ______________________________________________________________›0m
  136.     ›42m[C]›43m ›32mDiceConfig V2.0›31m                                              ›42m[I][D]›0m
  137. ›40m    |  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯     |›0m
  138.     |                              Files List         Project ›42m[¯¯¯¯›33m1›31m¯¯¯¯]›40m |›0m
  139.     |  Stat›42m[][¯¯¯¯›33m4›31m¯¯¯¯]›40m  +------------------------+  ›42m[›33m2›31m]›40m Dir ›42m[¯¯¯¯›33m3›31m¯¯¯¯]›40m |›0m
  140.     |Output›42m[][¯¯¯¯›33m5›31m¯¯¯¯]›40m  | ›42m                     ›41m ›40m |                      |›0m
  141.     |  Regs›42m[][¯¯¯¯›33m6›31m¯¯¯¯]›40m  | ›42m                     ›41m ›40m |      Libraries       |›0m
  142.     |                     | ›42m                     ›41m ›40m |                      |›0m
  143.     |›42m[][¯¯›33m7›31m¯¯][][¯¯¯›33m8›31m¯¯]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  144.     |›42m[][¯¯›33m9›31m¯¯][][¯¯›33m10›31m¯¯]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  145.     |   Code     Datas    | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯›43m¯¯¯]›42m[¯¯›43m¯¯¯¯¯›42m¯]›40m|›0m
  146.     |    ›33m11›31m         ›33m12›31m    | ›42m       ›33m2 1›31m           ›41m ›40m |  ›42m[¯¯¯¯›43m¯›42m¯¯¯›43m]›42m[¯›43m¯›42m¯¯¯¯›43m¯›42m¯]›40m|›0m
  147.     |   New›42m[]›40m ›33m   ›31m Unix›42m[]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯›43m]›42m[¯¯¯¯¯¯›43m¯›42m¯]›40m|›0m
  148.     |     ›33m13›31m Prototype›42m[]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯›43m¯¯›42m][¯¯¯¯›43m¯¯›42m¯¯]›40m|›0m
  149.     |  ›33m14›31mIn line calls›42m[]›40m  | ›42m                     ›30;41m^›31;40m |  ›42m[¯¯¯¯¯›43m¯›42m¯¯][¯¯¯›43m¯›42m¯¯¯¯]›40m|›0m
  150.     |  ›33m15›31mDynamic stack›42m[]›40m  | ›42m                     ›30;41mv›31;40m |  ›42m[¯¯¯›43m¯¯¯¯¯]›42m[¯›43m¯¯¯¯¯¯›42m¯]›40m|›0m
  151.     |                     +------------------------+  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  152.     |  Debug›42m[#¯¯›33m16›31m¯¯¯][]›40m  ›42m[¯¯Add¯¯][¯Edit¯][Remove]›40m        ›42m[ Compile ]›40m    |›0m
  153.     +---------------------------------------------------------------------+›0m
  154.                              ›33m17›31m       ›33m18›31m     ›33m19›31m               ›33m20›0m
  155.  
  156.      C,I,D are the standard WB's gadget ( respectively Close, Iconify and
  157.     Depth),
  158.      1: Enter the name of the project ( executable's name ),
  159.      2 & 3: The directory where the executable is created,
  160.      4: The profiling level ( see dcc doc ),
  161.      5: Select the output file class ( Executable, Pure, asm or object ),
  162. NOTE: If object is selected, project name and destination directory are
  163. ignored, resulting files are stored in the current directory, w/ the source's
  164. name w/ a .o
  165.      6: Registers level ( see -mr -mR ... in Dcc docs ),
  166.      7: The target processor (68000,020,030),
  167. NOTE: 68010 users should use 68000.
  168.      8: The