Présentation et installation de DICE

Dice 1

Après avoir passé l'AmigaBasic par le 'Trashcan', à cause de ses nombreux bugs, vous décidez de vous lancer dans le C. Vu le prix astronomique des compilateurs commerciaux, et après une recherche dans le DPs, vous tombez sur la version freeware de DICE...
C'est ainsi que j'ai débuté avec le C il a 2 ou 3 ans. Grâce à lui, j'ai pu réellement attaquer ce langage. A l'époque, mon Amiga n'avait que 512 Ko et 1 seul lecteur, autant dire que faire marcher un compilateur dans ces conditions ne relevait que du masochisme. Je suis donc passé à 1 Mo. A noter que Dice est le seul compilateur, à ma connaissance, utilisable avec seulement 1Mo et 1 lecteur. J'ai aussi essayé avec le Lattice ou l'Aztec, ... Séquence 'grille-pain'. Mais il possède aussi d'autres avantages comme la facilité avec laquelle on peut créer des programmes résidents, et pour les plus bidouilleurs, la possibilité de créer des programmes rommables.

Dans ce premier article, je vous parlerais donc de la façon d'installer DICE avec des petites configurations ( Version freeware ), puis de la version enregistrée. Plus tard nous aborderons les caractéristiques spécifiques de Dice et d'astuces qui nous faciliterons la vie,ainsi que de l'utilisation de bibliothèques externes. A noter que tout ceci ne concernera pas uniquement DICE,mais aussi les autres compilateurs.

Installation de la version FreeWare :

J'ai utilisé le système suivant presque un an avant d'acheter un disque dur et beaucoup d'amis continue à utiliser un environnement semblable sans problèmes. Il faut donc au minimum un ... Amiga ( Non, ... si, si !) avec au moins 1 Mo. Le drive interne suffit. Pour une fois les utilisateurs d'Amiga sous 1.3 seront avantagés car les nouvelles versions du système utilisent plus de mémoire, et la Config des disquette suivantes n'est valable qu'avec les Includes et les Libraries du 1.3, celles du 2.0 étant plus volumineuse. De toute façon, les versions enregistrées du compilateurs, plus récentes, sont plus adaptées à la programmation sous 2.0.
Il nous faut donc 2 disquettes :

Formater la première et installez-la en tant que système ( INSTALL DF0: ). L'environnement de programmation sera le Shell, mais plutôt que d'utiliser celui de Commodore, je vous conseil de prendre Csh : il est moins gourmand en mémoire et surtout, toutes les commandes sont internes, d'où un "bootage" plus rapide - ce qui plus qu'intéressant lorsque l'on programme en C où le Guru a souvent des crises de méditation -.
Pour que tous rentre sur la disquette, une compression s'avère indispensable. Personnellement, j'utilise Turbo-Imploder pour les exécutables, car il compresse aussi les Bibliothèques ,... . Je conseille d'avoir 2 versions de celui-ci : La dernière en date ( v4.0 à l'heure où j'écris ces lignes ) et une plus ancienne ( 3.x ) car les récentes ne permettent plus de compresser les programmes pures. PowerPacker sera utile pour compresser les textes ( Docs, ... ). Même si des utilitaires comme PP permettraient aussi de réduire les includes, je le déconseille à cause du temps ajouté à la compilations. En parlant de textes, il nous faut aussi installer sur cette disquette un éditeur: on va laisser tomber ED qui est tous juste bon pour un PC pour se pencher vers micro-Emacs de la disquette Extra ou vers des DPs. Certains ont été crées uniquement pour la programmation comme Az qui permet de tester les [] et les {}. J'ai laissé tombé Dme ( fournis avec Dice ) car trop compliqué, et surtout trop volumineux.

Passons maintenant à l'installation de Dice, voici donc le contenu de ma première disquette :

dir dice1: examples (dir) c (dir) l (dir) devs (dir) s (dir) doc (dir) libs (dir) bin (dir) dynamic.lzh

On reconnaît les répertoires propres aux disquettes systèmes sur Amiga (s, l, devs, c). Les autres proviennent de l'archive de DICE. Le but étant d'éviter le grille pain, seul les fichiers n'étant chargés qu'une fois ( les exécutables ) et ceux n'étant pas 'importants' comme les docs sont installés. Dans c: très peut de commande AmigaDos mais beaucoup d'utilitaires :

dir dice1:c

	AddBuffers	Assign
	AZ	border
	CD	Date
	decrunch	EndCLI
	Execute	FF
	FixHunk	GetEnv
	gomf1.0	Guru
	Kill'em	loadwb
	MachII	Mount
	NoPalReset	PopUpMenu
	ppmore	READCLOCK
	res1.3	Run
	SetEnv	SetMap
	SetPatch	shell

Remarquez res1.3: il s'agit de la commande resident qui est renommée car CSH contient aussi un resident (A notez qu'avec les versions récente, 5.?? ou +, on peut force l'utilisation d'une commande externe en mettant sa premiere lettre en maguscule Resident); ils ne sont pas compatibles mais nous avons besoin des deux comme nous le verrons plus loin ... Parmi les utilitaires, on reconnais ceux de PowerPacker, Border qui nous donne un shell sans ... bords, Guru qui explique les codes du méditeurs fou, alors que Gomf tente de les éviter ( la version 1.0 est du DP ), NoPalReset pour éviter que l'Amiga ne boot en NTSC, Kill'em ( anti-virus ), Dmouse ou MachIV pour la sélection automatique des fenêtres et le Blanker ; la version FreeWare de Dice ne comportant pas l'attribut _chip, nous devons utiliser un programme pour placer correctement nos données graphiques. J'utilise FixHunk ( programme DP qui était fourni avec mon extension mémoire Spirit).
Pour ceux qui n'ont pas ce programme, voici la procédure à suivre :

Lors des essais, supprimer l'extension mémoire avec un programme du genre noFastMem ( ou plutôt FMC - Dp - qui permet de la réactiver d'un simple clic de souris ).
Pour la version définitive, PowerPacker permet de fixer les données en Chips ( voir le menu HUNKLAB ).

Ajoutez enfin quelques utilitaires qui font partis de votre environnement habituel. Notez que pour ceux qui dispose d'une CPU supérieur au 68000, les utilitaires du genre de Fix68010 ne sont pas nécessaire: Le code généré par Dice est compatible avec TOUTE la famille 68000.

Dir dice1:s
	.login	startup-sequence
	InstallChips	InstallDice
	InstallIncl

La Startup-Sequence est réduite au minimum :

type dice1:s/startup-sequence

	Mount VD0:
	cd VD0:
	Nopalreset
	kill'em
	readclock
	SetPatch
	AddBuffers dice1: 30
	FF  -0 ;speed up Text
	Shell s:startupII

( Je rappel que Shell est l'exécutable de CSH pour les versions inférieur 5.x ) avec le fichier startupII suivant :

type dice1:s/startupII

	border off
	set _except "15 ; abortline"
	cd ram:
	cd vd0:
	alias makedir mkdir
	makedir ram:clipboards
	makedir ram:t
	makedir ram:env
	assign env: ram:env
	resident c:Setenv
	resident c:res1.3
	alias res res1.3
	Setenv DCCOPTS "-1.3 -f"
	echo ""
	echo "[3;33m Compilateur Dice [0m"
	echo "~~~~~~~~~~~~~~~~~~"
	echo "Ceci est la version [33mFREEWARE[0m de Dice"
	echo ""
	echo "Utiliser :"
	echo "          [4mMake[0m pour compiler"
	echo "          [4mMaker[0m pour compiler un programme resident"
	echo ""
	assign t: ram:t
	assign CLIPS: ram:clipboards
	assign DINCLUDE: Dice2:include
	assign DLIB: Dice2:dlib
	assign bin: sys:bin
	set _path "vd0:,ram:,bin:,s:"
	echo " "
	rback c:machII ;sleep 2
	cd bin:
	res das
	res dc1
	resident dcc
	res dcpp
	res dlink
	cd vd0:
	echo
	"============================================================"
	echo "[33mMach[0m is
	installed as a background task."
	echo "To invoke a new CLI,
	hold the [33mleft-Amiga key[0m and press [33mesc[0m."
	echo "The Screen-Saver
	feature of [33mMach[0m will blank the screen"
	echo "if there is no mouse
	or keyboard activity for minutes."
	echo "[33mMach[0m allow to
	use some hotkeys"
	echo
	"============================================================"
	popupmenu
	echo ""
	assign doc: sys:doc
	source s:.login

Deux choses sont à remarquer :

J'ai installé 2 disques ram, le fameux RAM: et vd0: ( ou VDK: ) qui est un ram disk récupérable ( comme rad: ) mais qui a comme avantage de ne pas avoir de taille fixe et de ne pas alerter les anti-virus. C'est ici que j'édite mes sources alors que ram: ne sert qu'aux fichiers temporaires.
Tous les exécutables ne sont pas mis résident de la même manière : Dcc et les utilitaires du Shell utilisent la commande interne de Csh alors que dc1, das et dlink, utilisent la commande Commodore. Nous verrons pourquoi par la suite. Si vous utilisez le 2.0, voir plus loin en se qui concerne la commande resident. Il est très important d'utiliser la bonne commande sinon Dice recherchera ses fichiers sur disque.

Enfin chaque nouveau shell Csh appel s:.login

type dice1:s/.login

	alias as assign
	alias lc ls -s
	alias make "%f dcc -o$f $f.c"
	alias maker "%f dcc -f -r -o$f $f.c"
	alias ren rename
	alias mach run c:machII
	alias gomf run c:gomf1.0
	set _prompt "[7;43mLF[40m_SHELL#[43;7m"$_clinumber" [42;3;7m %p [0;7m>[0m"

Il est évident que tous ces fichiers ne concernent que ma configuration et qu'ils doivent être personnalisés ( par exemple un 'SetMap f' devra être ajouté si vous avez un clavier français, ce qui n'est pas le cas de mon A1000. )

Voici quelques scripts utiles :

InstallIncl : Pour ceux qui ont 2Mo ou plus, ce script installe les INCLUDEs et les librairies dans VD0:, toutes la compilation se fait maintenant en ram. Évidemment, il teste si elles sont déjà présentes .

# source dice1:s/InstallIncl

if -n -m    # à supprimer pour les Amigas avec 2Mb de Chips
	echo "Pas de memoire"
else
	cd vd0:
	if -n -d :include ;mkdir vd0:include ;cp -r -d dice2:include vd0:include ;endif
	if -n -d :dlib ;mkdir vd0:dlib ;cp -r -d dice2:dlib/~*20* vd0:dlib ;endif  # Copie toutes les bibliothèques sauf celles du 2.0
	as DINCLUDE: vd0:include
	as DLIB: vd0:dlib
endif

Installdice : Si vous avez booté sur une autre disquette système, ce script installe dice.

type dice1:s/Installdice

	# Ce Script installe Dice sur un système qui n'a pas Booter sur "Dice1:"
	# ( sur le WB standard par exemple ).
	# Ce script utilise CSH : source Dice1:s/installDice

	cd Dice1:
	resident :c/res1.3
	alias res res1.3
	echo ""
	echo "[3;33m Compilateur Dice [0m"
	echo "~~~~~~~~~~~~~~~~~~"
	echo "Ceci est la version [33mFREEWARE[0m de Dice"
	echo ""
	echo "Utiliser :"
	echo "          [4mMake[0m pour compiler"
	echo "          [4mMaker[0m pour compiler un programme resident"
	echo ""
	alias make "%f dcc -f -o$f $f.c"
	alias maker "%f dcc -f -r -o$f $f.c"
	assign DINCLUDE: Dice2:include
	assign DLIB: Dice2:dlib
	assign bin: :bin
	set _path "vd0:,ram:,bin:"
	echo " "
	cd bin:
	res das
	res dc1
	resident dcc
	res dcpp
	res dlink
	cd vd0:
	Setenv DCCOPTS "-1.3 -f"

enfin le dernier, InstallChips configure le compilateur pour que les données soit stockées en chips :

	# Ce script 'crée' une commande pour compiler un programme
	# en mettant les données en Chip Memory
	if -n -f vd0:
	        echo "VD0: doit etre 'mounter'"
	else
	        if -n -f vd0:fixhunk ;cp -d dice1:c/fixhunk vd0: ; endif
	        alias makef "%f dcc -f -o$f $f.c;vd0:fixhunk $f"
	        echo ""
	        echo "Tapper [4mmakef[0m pour compiller un programme en fixant les donnees en Chips"
	        echo ""
	endif

Derniere remarque : J'utilise des 'alias' pour la compilation

make pour compiler un programme ( ex 'make salut' )
maker pour créer un exécutable pure, makef pour forcer le données en chips.

Sur la seconde disquette, nous allons placer les INCLUDEs de DICE, et de Commodore. Il faut savoir que ces dernières ne sont pas comprises dans la distribution FreeWare de Dice, mais on peut ce les procurer, soit au près de Commodore, soit dans la distribution d'un autre compilateur. Dans ce cas, il ne faut garder que celles dont l'entête est (C) Commodore. Créer un repertoire INCLUDE ( makedir dice2:include ) et copier tout les fichiers de dice. Dans ce directory, créer un sous-répertoire Amiga13 ( pour les includes du 1.3 ) ou/et Amiga20 pour les includes du 2.0. Dice permet en effet de les dissocier mais attention : ce qui ce trouve dans amiga13 n'est pas accessible d'une manière standard si vous développez en 2.0 et vice versa ( voir les flags -1.3 et -2.0). Créer un directory LIB ou l'on placera les librairies du C.
A noter que l'Amiga.lib fournie avec la version freeware ne contient pas toutes les fonctions, mais comme l'indique l'auteur, il nous suffit de prendre celles d'un autre compilateur ou assembleur ( hormis l'Aztec ), d'exécuter un LIBTOS pour disposer d'une bibliothèque parfaitement utilisable.
dir dice2: dlib (dir) cc (dir) include (dir)

La version freeware de Dice se trouve sur une Fred Fish ( je laisse a ed: le soin de trouver laquelle ). Elle est quelque peut "bridées" par rapport à la version commerciale ( pas de _chips, ni de flottant), et elle n'est plus mise à jour depuis un moment . Dcc a donc moins d'options, et dispose de moins d'utilitaires...

Installation de la version enregistrée :

Après 2 ans d'utilisation de la version Freeware, la seule chose qui m'empêchait d'acquérir cette version était la commande au USA: Les conditions de M.Dillon étant trop compliquées.
Heureusement la société SOMEWARE a résolut ce problème. Mise à jour 2000 : SOMEWARE n'existe malheureusement plus depuis un moment, mais la version enregistrée de DICE est disponnible sur Aminet, avec les sources il me semble. Par contre elle n'est plus développée ou soutenue.

Mais pourquoi acquérir cette version ?
Premièrement, du coté éthique, si on utilise très souvent un programme, surtout aussi bon que Dice, autant s'enregistrer pour permettre à son auteur de continuer ...
D'un coté plus pratique, la version enregistrée continue à évoluer, dispose d'un environnement complet et d'options tous à fait intéressantes ( comme la pile dynamique, la gestion des fichiers à l'Unix, ... ).

Bref, j'ai donc commandé cette version. Après quelques jours j'ai reçu un paquet contenant un classeur ( La doc du compilateur et de ses utilitaires le tous en français ), et trois disquettes contenant les exécutables, les docs, les Includes et les bibliothèques du 1.3 et du 2.0 ... Stop, le tous sur 3 disquettes !!! Oui, mais tous y est compressé avec Lharc. Pas de panique, la procédure d'installation est très simple et surtout très puissante.

Séquence installation ... Sous le workbench, seul l'icône du programme d'installation est présent ( sur la première disquette évidement ). Quelques remarques:

Tous d'abord,l'installation des Includes et surtout des bibliothèques du 2.0 est conseillée, même pour les utilisateurs du 1.3. Il faut savoir que la compatibilité est conservée, tant que l'on n'utilise pas des fonctions propre au 2.0 ! Math Dillon a en effet commit une légère erreur dans l'élaboration des bibliothèques de son compilateur. Prenons l'exemple suivant :
#include <stdio.h> #include <stdlib.h> void main() { printf("La variable DccOpts contients :%s\n",getenv("DCCOPTS")); }
Le but étant d'afficher le contenu de la variable DCCOPTS ( config de DICE ). Et bien ce source ne voudra pas ce compiller avec les librairies du 1.3. Regardons la façon dont est programmé getenv():
si intuition < 36 ( WB < 2.0 ) lecture du fichier env:var sinon ( on est sous 2.0) GetVar(var) fin D'un point de vue logique, tous devrait bien marcher : Si on utilise le 2.0 la fonction système GetVar() est appelée, sinon, on va lire le contenue du fichier ( car les variables d'environnement sous AmigaDos sont en fait des fichiers particuliers stockés dans ENV: ). Lors de la compilation, et QUELQUES SOIT LA VERSION du système, DICE vas génèrer le code pour la lecture directe du fichier, MAIS AUSSI POUR L'APPEL DE GetVar() !! Dlink recherchera donc un lien vers _GetVar() ce qui provoque une erreur car l'Amiga13.lib ne contient pas cette fonction ! La solution est donc de linker tous le temps avec les bibliotheques du 2.0, le programme est capable d'appeler le bon code quelque soit la version du KickStart. La version freeware n'a pas ce genre de problème, car les bibliothèques sont beaucoup plus réduites.
Contrairement à la version freeware, je vais me pencher sur un système plus puissant car j'ai "légèrement" upgradé mon A1000 : Il tourne maintenant sous 2.0 ( avec Zkick ), dispose de 6 Mo de Ram , d'un disque dur de 52 Mo et d'un 68010... Le programme d'installation est très bon et surtout très convivial, mais l'opération a quand même pris 3/4 d'heure a cause du désarchivage !! J'ai vraiment apprécié le teste que fait le programme pour indiquer si le drive peut recevoir Dice ( avec le nombre de blocks manquant si l'installation n'est pas possible ). Ne disposant plus que de 5Mo sur le disque, j'ai du faire "le ménage" dans la distribution. Le programme permet de sélectionner facilement ce que l'on veut installer. J'ai donc supprimé les Includes Amiga1.3 avec les libairies correspondantes, Libs qui contient une update des librairies mathématiques du 1.3, dutils,dme,sources,doc car elles sont imprimées dans le classeur,lib,cc et s. Man contient de l'aide sur les bibliothèques. Je les ai converties et compactées pour les utiliser avec Adoc. Bref, le tous fait quand même quelques 4.5 Mo !! Comme pour la version freeware, un coup d'Imploder et de PowerPacker m'a fait gagner 250 Ko ( ce qui est loin d'être négligeable ,le reste étant pris par les Includes et les Bibliothèques ... ).

Deux scripts sont crées pour lancer Dice ( Dice_Path et Dice_Startup ). Utilisant Csh, je les ai remplacés par d'autres, basés sur ceux de la version FreeWare.

Note sur Resident sous 2.0:

La commande du 2.0 est incluse dans la Rom donc inaccessible à CSH. La solution est d'utiliser celle du 1.3, qui est compatible avec le 2.0 et tous rentre dans l'ordre !

La prochaine fois je vous donnerais les sources d'un programme que j'ai réalisé pour configurer Dice car les alias seraient trop nombreux avec la version enregistré. Je parlerai aussi de l'utilisation des librairies partageable de l'Amiga. En attendant, les débutants peuvent jeter un oeil sur l'exemple donné dans la docs de dice ( première compilation ) qui est très intéressant.