Re: [Orion3d-dev] doxygen

[<nik...@wa...>]

juste pour finir avec la doc : je sais ce que c uml, et je sais a quel point
c relou.
j'ai bien testé doxygen, et ça m'a agreablement surpris : par exemple les
graphes de cooperation, modulo qq modif [fo voir cmt scritpter dot.exe, mais
sous mac, y'a meme un gui, je crois], ça se rapproche pas mal de la
philosophie uml !
a mon avis, tu sous estimes ce qu'on peut faire avec doxygen, enfin, c mon
avis ...
enfin, moi je suis partant pour ecrire la doc des le depart : si vous lisiez
mes mails et alliez jeter un coup d'oeil sur mon site [rebrique "futur"],
vous veriez que j'ai commencé a ecrire un debut de doc sur mon teslateur de
terrain. Ok, y'a pas de graphe uml, mais je les ai fait [vite fait, mais
bien fait] sur du papier, le seul truc, c que je vois pas cmt le rendre
efficacement en html. Peut etre as tu une id.
a mon avis, c pas parcequ'on est des amateurs qu'on doit pas se donner des
gros moyens, et uml en est un, et utiliser doxygen nous permet [surtout pour
ceux qui maîtrise pas a fond uml ...] de plus ou moins s'en passer.
J'ai un peu l'impression que tu consideres que le code que j'ecris est crade
et en permanent remaniement : c'etait le cas avant, mais depuis debut
septembre, ce n'est plus le cas, maintenant orion3d a une structure stable,
pour l'instant plutot simple, mais orienté objet a fond, et qui se prete pft
a une approche telle que celle utilisée ds l'industrie. [cf. le tutorial que
j'ai erit [pas fini] sur un moteur 3d en poo]

Pour finir, doxygen permet d'inserer pleins de trus, de la doc exterieur
[donc des diagrammes uml !!], des images, des formules TeX : donc je pense
qu'on DOIT utiliser un truc du genre, pour 2 raisons :
1- ça nous permet de ratrapper le temps perdu, vu qu'il  y a bcp de code
sans doc dans ce qu'on a ecrit [y compris ce qu'antoche et Rak ont ecrit
...], et si on veut faire de la doc uml, on pourra l'inerer
2-doxygen nous fournit un outil de mise en page multiplateforme, gratos, qui
permet d'integrer pleins de chose [dont les diagrammes uml qu'on va ecrire],
ce qui est loin d'être le cas des gui UML que je connais ...

donc conclusion : Rakan, que tu soit pour ecire de la doc uml [dans ce cas
on l'integrera avec doxygen], ou contre [dans ce cas, doxygen nous fournira
un outil pour enuler -en moins bien of course- cette doc], dans tout les
cas, on est gagant en utilisant doxygen
en +, j'en ai parlé a sanx et antoche, et je pense qu'ils ont tout les 2 été
bien bluffé par les graphes de doxygen [enfin, sanx connaissait, c lui qui
m'a filé le tuyeau ;)]

donne moi un avis définitif, comme ça on en parle plus.

a+

gabriel

ps : si t'as le tps, tu pourrais faire un petit readme pour expliquer ce que
fait exactement chaque ficher de la lib jpeg, si il fo ts les compiler, etc.
Idem pour les differents makefile . Q : tu es sur que la lib est ansi 100% ?

----- Original Message -----
From: Rakan El-Khalil <rf...@co...>
To: Orion3D - Mailling list <ori...@li...>
Sent: Saturday, November 25, 2000 8:24 AM
Subject: Re: [Orion3d-dev] doxygen


>
> > en +, y'a un moteur de recherche intégré, un truc pour faire des graphe
de
> > dependance
> >
[http://www.stack.nl/~dimitri/doxygen/examples/diagrams/html/class_e.html],
>
> c vrai que c joli et tout.  mais ca ca devrais etre fait auparavant.
avant
> meme d'ecrire le code.  bon, je me repete :-p
>
> R.
>
> _______________________________________________
> Orion3d-dev mailing list
> Ori...@li...
> http://lists.sourceforge.net/mailman/listinfo/orion3d-dev