Wormux 0.5
Guide dveloppeur de Wormux (Franais)
---------------------------------

Si vous vous sentez capable de nous aidez, envoyez-nous s'il vous plais
un email  l'adresse :

wormux-dev _AT_ gna.org (N'oubliez pas de replacer "_AT_" par "@")

Ou, contactez-nous sur le canal #wormux sur IRC (irc.freenode.net).

Toutes les contributions sont les bienvenues :
- Code
- Graphiques
- Retours d'expriences (Opinions/Fonctionnalits/etc.)
- Rapports de bogues (voir BUGS)


=========
* Dveloppement
=========

La correction de bogues reprsente une large part du dveloppement de Wormux. Un
certains nombres d'outils peuvent tre utilis pour les trouver...

* Les messages de dbuggages
--------------------

Pour mettre en place un meilleur dbuggage du code source, un certain nombre de
fichiers sources possdent des "debug switches" (boucle de dbuggage) comme :
	#define DEBUG_...

Exemple du fichier obj_physique.cpp :
	#ifdef DEBUG

	//# define DEBUG_CHG_ETAT
	//# define DEBUG_MSG_PHYSIQUE
	[...]
	#endif

En dcommentant "#define DEBUG_CHG_ETAT", les messages de dbugagges seront
crit sur la console. Ils sont vraiment utile si quelque chose ne fonctionne pas
correctement.

* debug.cpp
-----------

Ce fichier est conu pour tre un outil additionnel pour aider les gens 
dbuger Wormux. En particulier, il peut permettre l'affichage d'un grand nombre
d'informations mise  jour en temps-rel. ditez simplement "Debug::Gestion()"
pour afficher les donnes dont vous avez besoin.

* GDB
-----

Au niveau le plus bas, le programme GDB (the GNU Debugger) est disponible. Pour
plus d'informations, voir le site web le concernant.

Pour excuter Wormux dans GDB, tapez "gdb ./wormux" dans le rpertoire contenant
Wormux. Aprs, lancez Wormux dans le dbuggeur en tapant "run".

Quant une partie de Wormux choue (quant elle crash), un signal "ABORT" est
mis et est dtect par gdb.  ce moment, tapez simplement "backtrace" dans gdb
pour voir o le programme  chou.

Si GDB s'arrte sur un signal "SIGTTOU", cela est quasi certainement d au son.
La solution la plus simple pour rsoudre cela est de dsactiver la capture de ce
signal avec :
	
	"handle SIGTTOU noprint nostop"


======
* Graphiques
======

Toutes les images doivent tre au format PNG. Les images doivent tre en 24 
bits/pixel ou en 32 bits/pixel.

Pour afficher les coordonnes dans le jeu, dcommentez
"#define AFFICHE_COORD_SOURIS" dans le fichier debug.cpp, puis recompilez le
programme. Les coordonnes du curseur seront alors affiches sur l'cran.