home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / diceconfig-2.0.lha / DiceConfig / DiceConfig2.0FR.doc < prev    next >
Encoding:
Text File  |  1993-11-28  |  16.9 KB  |  347 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 Attention : DiceConfig 2.0 s'utilise uniquement du workbench &
  11.        ›0;33;1m¯T¯›0m ~~~~~~~~~  nécessite le KS 2.0+ & la ReqTools.library 38+.
  12.  
  13.  ›0;4;1mRemarques :›0m
  14.  
  15.      DiceConfig 2.0 est un SHAREWARE, dont la version d'évaluation peut
  16.     etre copier selon les termes suivant :
  17.      CE QUI SUIT NE S'APPLIQUE QU'A LA VERSION D'ÉVALUATION CAR LA VERSION
  18.     ENREGISTRÉE NE PEUT PAS ETRE DISTRIBUÉE.
  19.  
  20.      - Toutes les composantes de cette distribution NE DOIVENT ETRE CHANGEES
  21.     EN AUCCUNES CIRCONSTANCES. Sont autorisées seulement l'utilisation des
  22.     crunchers ( PowerPacker, TurboImploder ), archiveurs ( Lha,... ) ou
  23.     encoder (uuencode,... ). J'ai inclus le fichier .cd servant à la création
  24.     des 'catalogs', mais rappellez-vous que je ne suis l'auteur que de l'
  25.     anglais ( défaut ) & du français. D'autre langages sont les bien-venus
  26.     mais n'oublié pas de m'emvoyer une copie.
  27.  
  28.     - DiceConfig ne peut pas etre inclus dans des productions commerciales,
  29.  
  30.     - Le prix du disque où est inclus DiceConfig ne peut etre suppérieur a
  31.     celui d'un Fred Fish,
  32.  
  33.     - La distribution est autorisé dans les librairies Fred Fish & CAM.
  34.  
  35.  
  36.  ›0;4;1mPour s'enregistrer :›0m
  37.  
  38.     Le prix de la version enregistrée est de seulement 100 FF ou $20 ( ou
  39.    équivalent ). En plus de la version sans requester de DiceConfig 2.0, vous
  40.    aurrez droit a une remise a niveau gratuite.
  41.    Mon adresse est :
  42.  
  43.                 Laurent Faillie
  44.                  "Les Vuardes"
  45.                 74930 Pers-Jussy
  46.                     FRANCE
  47.  
  48.     N'oubliez pas votre nom & votre adresse complette ...
  49.  
  50.  
  51.  ›0;4;1mPrincipes :›0m
  52.  
  53.     Le but de ce programme est d'offrir une interface graphique ( GUI ) pour
  54.    l'utilisation du compilateur C Dice de M.Dillon. Le compilateur peut etre
  55.    localisé ( WB 2.1 + ). Il invoque Dcc en utilisant la fonction System()
  56.    ou peut envoyer une commande Arexx ( a Csh par exemple ). Et ça marche
  57.    même si Arexx n'est pas lancé !! La GUI est sensible a la fonte utilisée
  58.    & peut etre iconifiée en utilisant le gadget de zoom.
  59.     DiceConfig utilise un fichier de configuration & les 'Tools Types' de
  60.    son icon. Comme dans les version 1.x, jusqu'a 16 bibliotheques externes
  61.    peuvent etre utilisées.
  62.  
  63.     A la différence de la majorité des versions d'évaluations, auccune option
  64.    n'est supprimée, mais un requester particulierement énervant apparait
  65.    toutes les 2 minutes.
  66.  
  67.  ›0;4;1mLes arguments ( ToolsType de l'icone ) :›0m
  68.  
  69.     MODE = EXECUTE (defaut) Utilise la fonction System() pour lancer le
  70.                             compilateur.
  71.     MODE = AREXX            Envoie un message a un port AREXX.
  72.                             (fonctionne même si ARexx n'est pas lancé !).
  73.  
  74.     AREXX_PORT = nom        Spécifie le nom du port AREXX ( defaut = rexx_csh ).
  75.  
  76.     START_CMD = commande    Spécifie une commande a lancer en même temps que
  77.                             DiceConfig. (exemple lancer un CSH en attente de
  78.                             commande).
  79.                             defaut = rien.
  80.  
  81.     RX_END_CMD  = commande  Spécifie une commande a envoyer a la fin de la
  82.                             connection.
  83.                             defaut = bye.
  84.  
  85.     CMD = ligne de cmds     Spécifie la ligne de commande a envoyer pour
  86.                             compiler. Dans cette ligne %f sera remplacer par
  87.                             un fichier qui contient le nom des fichiers
  88.                             composant le projet ( voire @ de Dice ). %r sera
  89.                             remplacer par le nom du fichier resultant ( option
  90.                             -o de Dice ).
  91.                             Defaut : Dcc @%f -o%r
  92.  
  93.     CMD_AFF = commande      Commande pour afficher les messages d'erreur.
  94.                             Defaut : More
  95.  
  96.     CMD_ED  = commande      Editeur a utiliser. ( defaut ED ).
  97.  
  98.     DBG_LIB = lib           Indique quelle librairies est a linker en cas de
  99.                             debuggage (ex debug.lib )
  100.                             Defaut : Auccune.
  101. NOTE: D'autres options peuvent etre ajoutées apres le nom de la bibliotheque :
  102.         DBG_LIB=Debug.lib -lDDebug.lib -d1
  103.       Link avec la debug.lib, la ddebug.lib & ajout un 'hunk' DEBUG de niveau 1
  104.  
  105.     CC_STACK = nbre         Défini la pile alouer au compilateur
  106.                             defaut & minimum : 10000
  107.  
  108.     CMD_STACK = commande    Defini la commande a envoyer en mode Arexx pour
  109.                             redéfinir la pile. ex: stack %d
  110.                             defaut : Rien
  111.  
  112.     TOOLS_STACK = nbre      Défini la pile pour CMD_AFF & CMD_ED.
  113.  
  114.          Note : Le mode n'affecte que le lancement du compilateur. CMD_AFF &
  115.          CMD_ED sont toujours lancer grace a System().
  116.  
  117.  ›0;4;1mLe fichier de configuration :›0m
  118.  
  119.      DiceConfig a besoin d'un fichier de configuration nommé
  120.     dcc:config/DiceConfig.cfg
  121.  
  122.                (0)  ›42m TST0 fch de test ›0m
  123.                (1)  ›42m -2.0 -ms -//     ›0m
  124.                (2)  ›42m Math             ›0m
  125.                (3)  ›42m -lm              ›0m
  126.                     ›42m                  ›0m
  127.  
  128.      La 1ere ligne (0) contient la version du fichier. Elle est compossée des
  129.     4 premiers caracteres de la ligne. Le reste est ignoré.
  130.      La 2eme ligne (1) contient toutes les options toujours présentes (-2.0
  131.     pour l'utilisation des includes et bibliothèques du 2.0, ... ).
  132.      Les lignes suivantes indiquent, par groupes de 2, les librairies que l'
  133.     on peut linker, la première ligne (2) contenant le nom et la seconde (3)
  134.     les actions à faire. Ici, le tableau des libarairies, il n'y a que 'Math'.
  135.     Si on l'active, l'option -lm ( qui indique de linker m.lib ) sera rajouté
  136.     au commande de Dcc. Il est possible de mettre des commentaires: Si le
  137.     premier caractere d'une ligne est un # alors la ligne est ignorée.
  138.  
  139.      Remarque : La version 1.x de DiceConfig est toujours utilisable car
  140.     son propre fichier de configuration se trouve en
  141.             Dlib:DiceConfig.cfg
  142.  
  143.  
  144.  ›0;4;1mLa fenetre de dialogue:›0m
  145.  
  146.      Pour l'utilisateur DiceConfig V2.0ß se presente sous la forme d'une
  147.     fenetre: Sa taille est variable suivant la fonte utilisée & elle contient
  148.     plusieurs gadgets:
  149.        ______________________________________________________________›0m
  150.     ›42m[F]›43m ›32mDiceConfig V2.0›31m                                              ›42m[I][P]›0m
  151. ›40m    |  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯     |›0m
  152.     |                              Files List         Project ›42m[¯¯¯¯›33m1›31m¯¯¯¯]›40m |›0m
  153.     |  Stat›42m[][¯¯¯¯›33m4›31m¯¯¯¯]›40m  +------------------------+  ›42m[›33m2›31m]›40m Dir ›42m[¯¯¯¯›33m3›31m¯¯¯¯]›40m |›0m
  154.     |Output›42m[][¯¯¯¯›33m5›31m¯¯¯¯]›40m  | ›42m                     ›41m ›40m |                      |›0m
  155.     |  Regs›42m[][¯¯¯¯›33m6›31m¯¯¯¯]›40m  | ›42m                     ›41m ›40m |      Libraries       |›0m
  156.     |                     | ›42m                     ›41m ›40m |                      |›0m
  157.     |›42m[][¯¯›33m7›31m¯¯][][¯¯¯›33m8›31m¯¯]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  158.     |›42m[][¯¯›33m9›31m¯¯][][¯¯›33m10›31m¯¯]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  159.     |   Code     Datas    | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯›43m¯¯¯]›42m[¯¯›43m¯¯¯¯¯›42m¯]›40m|›0m
  160.     |    ›33m11›31m         ›33m12›31m    | ›42m       ›33m2 1›31m           ›41m ›40m |  ›42m[¯¯¯¯›43m¯›42m¯¯¯›43m]›42m[¯›43m¯›42m¯¯¯¯›43m¯›42m¯]›40m|›0m
  161.     |   New›42m[]›40m ›33m   ›31m Unix›42m[]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯¯¯›43m]›42m[¯¯¯¯¯¯›43m¯›42m¯]›40m|›0m
  162.     |     ›33m13›31m Prototype›42m[]›40m  | ›42m                     ›41m ›40m |  ›42m[¯¯¯¯¯¯›43m¯¯›42m][¯¯¯¯›43m¯¯›42m¯¯]›40m|›0m
  163.     |  ›33m14›31mIn line calls›42m[]›40m  | ›42m                     ›30;41m^›31;40m |  ›42m[¯¯¯¯¯›43m¯›42m¯¯][¯¯¯›43m¯›42m¯¯¯¯]›40m|›0m
  164.     |  ›33m15›31mDynamic stack›42m[]›40m  | ›42m                     ›30;41mv›31;40m |  ›42m[¯¯¯›43m¯¯¯¯¯]›42m[¯›43m¯¯¯¯¯¯›42m¯]›40m|›0m
  165.     |                     +------------------------+  ›42m[¯¯¯¯¯¯¯¯][¯¯¯¯¯¯¯¯]›40m|›0m
  166.     |  Debug›42m[#¯¯›33m16›31m¯¯¯][]›40m  ›42m[¯¯Add¯¯][¯Edit¯][Remove]›40m        ›42m[ Compile ]›40m    |›0m
  167.     +---------------------------------------------------------------------+›0m
  168.                              ›33m17›31m       ›33m18›31m     ›33m19›31m               ›33m20›0m
  169.  
  170.     F,I,P sont les gadgets standard des fenetres du 2.0 (respectivement fermer,
  171.     iconifier & profondeur).
  172.  
  173.     1: Le nom du projet ( celui de l'éxécutable ),
  174.     2 & 3: Le repertoire où il sera crée,
  175.     4: Le niveau de statistiques ( profiling ),
  176.     5: Le type du fichier de sortie ( Executable, Pure, assembleur ou objet ),
  177. NOTE: Si OBJET est selectionné, le nom du projet & son répertoire sont ignorés,
  178. & les fichiers résultant sont stoqués dans le répertoire courrent,avec le nom
  179. du sources + .o
  180.     6: Le passage des arguments ( pile ou registres ),
  181.     7: Le processeur ( 68000,020 ou 030 ),
  182. NOTE: Mettre 68000 pour un 68010.
  183.     8: Le copro-mathématique ( 68881 ou 882 ),
  184.     9: Le model pour le code,
  185.    10: Le model pour les données,
  186.    11: Utilisation de l'option -new,
  187.    12: compatibilité avec Unix,
  188.    13: Respect des prototypes,
  189.    14: Utilisation des #pragmas,
  190.    15: Pile dynamique,
  191.    16: Niveau de debugage,
  192.    17: Ajoute un fichier dans la liste,
  193.    18: Edite le fichier sélectionné,
  194.    19: Supprime le fichier selectionné de la liste,
  195.    20: Compile,
  196.    21: Liste des fichiers sources ( .c,.a, ou .o mais auccun .h ),
  197.    22: Bibliotheques à lier.
  198.  
  199.     Les menus permettent de charger ou de sauver un projet. Quant vous chargez
  200.    un projet, les options sont remise dans l'état où elles ont été sauvegardées,
  201.    sauf pour Debug qui est remis a 0.
  202.     Un Debug different de 0 produit un #define DEBUG=niveau & l'inclusion du
  203.    Hunk de symbols. Un Debug nul ne defini auccun DEBUG.
  204.  
  205.  ›0;4;1mBugs (connus) & astuces:›0m
  206.  
  207.     * La version 2.07.54R de Dice comporte une erreur de conception qui fait
  208.     que Dcc supprime les fichiers objets si la compilation a été un succés. L'
  209.     option -new devient donc inutilisable. Dans cette distribution, vous
  210.     trouverez un scripts CSH nomé Multi_Dcc_F.sh & qui permet de résoudre ce
  211.     probleme. Pour l'utiliser, il faut mettre DiceConfig en mode Arexx, lancer
  212.     un shell CSH client ( ce que fait Start_Csh ) & mettre dans l'icon
  213.         CMD=Multi_Dcc_F %f %r
  214.     Une autre solution est de modifier directement Dcc. Ligne 1125, modifier
  215.     le source comme suit :
  216.  
  217.     /*
  218.      * Delete temporary objects
  219.      */
  220.  
  221.     if(!NewOpt){
  222.         NameNode *nn;
  223.  
  224.         for (nn = GetHead(&FList); nn; nn = GetSucc(&nn->n_Node)) {
  225.             if (nn->n_IsType & IS_TMP)
  226.                 remove(nn->n_In);
  227.         }
  228.     }
  229.  
  230.     * Si Dice n'est pas rendu resident, DiceConfig ne peut pas le trouver si
  231.     son path n'est pas mis dans le shell de démarage ( user-startup ). C'est
  232.     du au fait que depuis le 2.0 les paths des shells sont locaux. Pour ceux
  233.     qui n'ont pas beaucoup de mémoire, 2 solutions:
  234.         - Mettre DiceConfig en mode Arexx & le shell, a sont démarage , crée
  235.         les paths ( cf Start_CSH ).
  236.         - Csh 5.31+ permet de mettre un path global ( path -g).
  237.  
  238.     * En mode Arexx, si vous interrompez la compilation par des CTRL C, CTRL D
  239.     d'autres compilations risquent de ne produire que des ^C - La fenetre
  240.     shell a mémorisé les CTRLs -. La solution  est  de quitter DiceConfig et
  241.     de  le  relancer ce qui  ouvrira  un nouveau shell. De plus le 1er Shell
  242.     risque de ne pas se fermer automatiquement, utiliser le gadget de
  243.     fermeture.
  244.  
  245.     * Il se peut que DiceConfig affiche une compilation réussie alors que rien
  246.     n'a été compilé. La cause est probablement une des option de Dcc qui est
  247.     fausse. Se mettre en mode ARexx, sur un port CSH, Dcc affichera la cause
  248.     de l'erreur...
  249.  
  250.     * L'utilisation d'une fonte pas tres large cause une fenetre où les gadgets
  251.     se chevauchent. C'est causé par la GadTools.library dont certains gadgets
  252.     ont des tailles fixes.
  253.  
  254.     * Si vous utilisez la possibilité d'auto-ouverture des bibliotheques,
  255.     n'oubliez pas que Dice ne teste pas la version ( Pendant le Betha-teste,
  256.     une preversion de DiceConfig provoquait des Gurus seulement sur un 3000.
  257.     Apres plusieurs heures de recherche où cette Amiga fut traitée de tous les
  258.     noms - même de PCs !! -, j'ai trouvé que la ReqTools.library de ce systeme
  259.     était trops vielle - V37.xxx au lieu de V38.xxx - ).
  260.  
  261.     * Note pour les versions ancienne de Dice : DiceConfig 2.0 a été créé pour
  262.     l'utilisation de la version 2.07.54R ou plus de Dice, mais marche avec les
  263.     version plus ancienne. Attention a ne pas activer les options non
  264.     supportées. Dans un premier temps, essaillez en mode Arexx pour voire si
  265.     les options ne choquent pas Dcc.
  266.     Remarque : J'ai testé jusqu'a la derniere version FreeWare de Dice parue
  267.     sur Fred Fish. Ça marche parfaitement mais Dcc semble ne pas gerer l'
  268.     option -E correctement : Toujours utiliser le mode Arexx.
  269.  
  270.  ›0;4;1mCe qui reste a faire:›0m
  271.   Peut-etre present dans les versions futures :
  272.     - Gadgets pour changer la version du systeme,
  273.     - Création d'icone pour les fichiers de projet,
  274.     - AppIcon & AppWindow,
  275.     - Utilisation d'un help mode ( mais j'ai actuelement des problemes avec
  276.     l'AmigaGuide.library),
  277.     - Utilisation de Dmake au lieu de Dcc pour une meilleur gestion des
  278.     dépendances ( Dcc ne verifie pas les changements des fichiers .h ),
  279.     - Support réel d' Arexx ( pas seulement pour commander Csh ).
  280.  
  281.  ›0;4;1mCopyRight & autres:›0m
  282.  
  283.     DiceConfig V2.0 a été dévellopé sur un Amiga 1000 6Mo de Rams, 52 Mo de
  284.     disque dur, WB 2.1, KS 37.210, & un 68010 avec Dice V2.07.54R,
  285.     Csh 5.19 & 5.31 . Il ne provoque auccun hit de MungWall ou enforcer.
  286.     La compilation complete prend un peu moins de 3 minutes pour 70 ko de
  287.     sources ...
  288.      Il a été testé avec succes sur :
  289.      - B2000, 68000, KS 3.1, WB 3.0, 3Mo ( 1Mo chips ),
  290.      - A1000, 68010, KS 2.0, WB 2.1, 6Mo ( 512Ko chips ),
  291.      - A1200, 68020, KS 3.0, WB 3.0, 2Mo ( 2Mo chips ),
  292.      - A3000, 68030, KS 2.0, WB 2.1, 6Mo ( 2Mo chips ),
  293.      - A4000, 68040, KS 3.1, WB 3.1, ??Mo (2Mo chips ),
  294.  
  295.     La GUI a été genérée par GadToolsBox V2.0b © 1991-1993 Jaba Development.
  296.     Dice et CSH sont © M.Dillon. (Csh 5.19 est programmé par U.Dominik Mueller,
  297.     5.31 par Andreas M. Kirchwitz)
  298.     La routine qui envoie les messages Arexx provient des sources de CSH 5.19.
  299.     La ReqTools.library est © Nico François.
  300.  
  301.      Installer et l'icone de projet d'Installer est
  302.      (c) Copyright 1991-93 Commodore-Amiga, Inc.  All Rights Reserved.
  303.      Reproduit sous license de Commodore.
  304.  
  305.      Installer peut etre trouvé dans le disque d'installation du WB 2.0+.
  306.  
  307.      INSTALLER ET DICECONFIG 2.0 EST DISTRIBUÉ "AS-IS". UTILISÉ LE A VOS
  308.      PROPRE RISQUE.  AUCCUNE RESPONSABILITÉ N'EST ASSUMÉE.
  309.  
  310.     Remerciements:
  311.         * Seb. BOUCHEX pour le ß test,
  312.         * Frank GEIDER pour m'avoir fourni plein d'utilitaires DPs dont
  313.         GadToolsBox ...
  314.         * Bruno Anthoine pour le teste sur 1200,
  315.         * Animage production pour le teste sur le 3000 avec enforcer,
  316.         * Matt Dillon pour Dice, Dmouse, & pleins d'utilitaires de mon systeme,
  317.         * SomeWare pour importer Dice en France,
  318.         * Fred Fish pour sa librairies
  319.  
  320.  
  321.  ›0;4;1mHistorique :›0m
  322.  
  323.   1.0   02-09-1992  L.Faillie   Premiere version FreeWare.
  324.   1.1   26-06-1993  L.Faillie   Quelques modifs d'ordre esthétiques...
  325.  
  326.   2.0ß8 02-10-1993  L.Faillie   Premiere version fonctionnelle & sans GURU...
  327.   2.0ß9 06-10-1993  L.Faillie   Ajout de la version du fichier de config & d'
  328.                                 une clef au fichier de projet. A Notez que les
  329.                                 fichiers de config & de projet sont
  330.                                 incompatibles avec les versions precédentes ...
  331. Note : L'icons des ßversions précédentes créait une erreur si pas de CMD car
  332. dcc -@... est une option illegal ( dcc @... )
  333.   2.0ß9 12-10-1993  L.Faillie   Le numéro n'a pas changer car le précédent n'a
  334.                                 pas été distribué.
  335.                                 Ajout des testes, & de l'option CMD_STACK.
  336.                                 Suppression des hits de MungWall & d'un bug
  337.                                 qui faisait que debug n'était pas remis a 0
  338.                                 lors d'un chargement.
  339.   Ne PAS UTILISER LE MODE EXECUTE CAR DCC CORROMPRERA LA MÉMOIRE avec les ß
  340.   inferieur a 10.
  341.  
  342.  2.0ß10 19-10-1993  L.Faillie   Ajout du code de la Locale.library. Création
  343.                                 du catalog français, ajout du requester.
  344.  
  345.     2.0 06-11-1993  L.Faillie   Distibution de DiceConfig 2.0. Fixe le bug
  346.                                 qui provoquait un Guru si ReqTools < 38.
  347.