A.I.P termine sa mise en place...

Cet espace lui est consacré, et donc le forum d'Advanced Irrlicht Project est un espace qui lui est dédié,
(pour tout ce qui touche Irrlicht à proprement parlé, restez sur le forum qui est prévue à cet effet SVP).

A.I.P étant un projet à vocation communautaire, toutes les bonnes volontés sont les bienvenues bien entendu...


-----------------------------------------------------------------------------------------------------------
Le forum A.I.P s'articule en deux sections distincts.

-la première est une section généraliste, les titre des sous forums parlent d'eux même...
-la seconde est une section dédiée aux principaux chapitres que comprend le moteur.

respectez autant que faire se peux les sections.


-----------------------------------------------------------------------------------------------------------
Comment contribuer ?


Trois possibilités s'offrent à vous:

- la première sous forme de critiques constructives. En d'autres termes, si certaines choses vous chagrinent, ou
encore manque dans Irrlicht, et que vous souhaitez les voir corrigés ou ajoutés au sein de A.I.P, alors faites
en part. Soyez le plus précis possible. N'hésitez pas à donner des exemples pour appuyer vos remarques,
fournissez une amorce de solution technique quand vous le pouvez.

- la seconde, en tant que testeur et utilisateur. La simple utilisation du moteur, et la remonté d'information sur
les soucis que vous rencontrez est en soit une forme de contribution, donc n'hésitez pas fournir vos remarques.

- la troisième, au niveau du code. Avant de chercher à modifier le code du moteur, il est bon que la chose soit avant
tout débattue. Postez votre code, ou le mieux encore, fournissez un exemple (accompagné d'un fichier compressé),
c'est toujours la solution idéale. Si l'intérêt est avéré, alors le code du moteur sera mis à jour.


A.I.P reste un moteur à vocation généraliste, ne venez pas pour de ajout atypiques, pensez que tout ce qui doit
être apporter a A.I.P doit servir au plus grand nombre.


-----------------------------------------------------------------------------------------------------------
L'upload

Pour le moment, la capacité d'upload n'est donnée qu'a quelques membres du forum. En fonction de l'activité des
contributeurs, ainsi que de leur sérieux, cette capacité sera alors étendu.

Pour tout ceux qui ont la possibilité d'uploader, comme à chaque fois dans ce genre d'exercice, vérifiez bien que
vous partez de la dernière version en ligne du moteur et des fichiers qui lui sont associés, avant d'y apporter vos
modifications et de faire votre mise à jour.



-----------------------------------------------------------------------------------------------------------
Règles et tags dans les fichiers sources

Par soucis de lisibilité, il est bon de respecter quelques règles d'écriture au sein des fichiers sources:

-en en-tête:
la première ligne doit toujours avoir cette forme:

revision XXXX étant le numéro de révision du fichier, pour le moment quasiment tous sont tagués revision 0001
Au fil des mises à jours, le changement de revision se fera automatiquement.


-tag au sein du code lui même:
pour permettre de mieux s'y retrouver au niveau des fichiers modifiés, il est bon d'appliquer un tag, cela facilite
grandement les recherches sur des fichiers volumineux, surtout si il y a plein de modif à pas mal d'endroit différents.

Le tag doit donc être composé obligatoirement de: ! -- AIP ---.
Quand c'est possible et que cela ne nuit pas trop à la visibilité, insérez la
date de la modif ainsi que la révision concernée.

Exemple:

ou

ou encore

Pour les nouveaux fichiers, bien entendu pas de tag. Par contre, une fois intégrés au moteur, si ceux-si sont
modifiés, la règle s'applique alors pour eux aussi.

.

tmyke :

-en en-tête:
la première ligne doit toujours avoir cette forme:

Code c++ :

//version 1.0 revXXXX

revXXXX étant le numéro de révision du fichier, pour le moment quasiment tous sont tagués rev0001

J'ai pas compris à quoi ça sert version 1.0 si on utilise rev ?

tmyke :

Si avant de modifier un fichier vous aviez rev0011, alors vous devrez modifier l'entête pour que la valeur
passe à rev0012. Le numéro de version pour le moment n'a pas à changer.

Non surtout pas ! Toute modification manuel de la première ligne doit être fortement répréhensible
Le serveur s'occupe de tout, je vais mettre un genre de mutex pour pas écraser les modifications simultanés, donc il faut surtout pas modifier le numéro de version.

nico :

J'ai pas compris à quoi ça sert version 1.0 si on utilise rev ?

dans certains cas, suite à des changement profond, on ne parle plus de revison mais de changement de version. Ceci dit si cela apporte une
confusion, ou complique ton travail, on peut  très bien partir sur un élément signalétique unique...

nico :

Non surtout pas ! Toute modification manuel de la première ligne doit être fortement répréhensible
Le serveur s'occupe de tout, je vais mettre un genre de mutex pour pas écraser les modifications simultanés, donc il faut surtout pas modifier le numéro de version.

OK, je n'avait pas à l'espris l'automatisation de la choses, je modifierais le message sur ce point dès demain

étant donner que le changement de version est automatique je me demandais, si par la même aucasion, tu puisse marquer les lignes modifier par rapprt a la version présédente (sur le site), par example avec un font orange, histoire de coller avec le disign du site ? de plus dans le tableau des mise a jours, ne serais t'il pas judicieux d'avoir un lien sur le nom du fichier, pour le visionner, plutot que d'aller le cherchés ?

Magun :

ne serais t'il pas judicieux d'avoir un lien sur le nom du fichier, pour le visionner, plutot que d'aller le cherchés ?

+1 ça arrive
pour ce qui est de marquer les lignes modifiés je n'ai pas encore les compétences, j'ai déjà regardé dans les sources de wiki pour voir comment il faisait, et ça m'a lair compliqué, faut créer un snake.
on verra dans une autre vie peut-être...

bon je ne sais pas si cela changeras ta vision de la 'faisabiliter' de la chose par rapport a ton lvl, néhanmoins:

en gros tu fait un dossier temporaire ou tu stoque les anciens fichiés, c'est a dire a chaque upload au lieux de faire un erase, tu remplace le fichier qui est dans tempory par celui qui est 'à jour', et tu mais le nouveaux dans le dossier 'current', de se fait il ne manque qu'un comparateur de fichier,, comme il en éxiste plien sous nux.

bref, par conséquent, on garde également la version infèrieur, qui peut être rétablie au beusoin ... double bénef

t'inquiete pas pour ce qui est des versions tout est conserver, et tout sera restorable, il me manque juste le comparateur de fichier, c'est ça qui est compliquer à moins que je recupere un truc tout fait....

Je ne veux pas faire le chiant, mais avec svn c'est automatique

c'est quoi qui est automatique ?

Tout il garde des sauvegarde des modifs, il gère plusieurs "branches". Il tag les modifs ...
Vas faire un tour chez subversion, même si on ne l'utilise pas tu peux t'en inspirer.

http://subversion.apache.org/features.html

c'est quoi les branches ?

Comme un arbre (d'ou le nom) tu part d'une base et tu sort différentes versions qui évoluent en parallèle.
La plupart du temps on les utilise pour les différentes releases afin de ne pas stopper le développement  des anciennes.
Par example Irrliche à les branches 1.2 1.3 1.4 ... et à l'interieur de chacune, des révisions. C'est ce que disait tmyke plus haut.

Dernière modification par TUpac (24-01-2011 15:51:43)

ok ok, donc j'ai jusqu'à la sortie de la prochaine version pour implémenter ce système ça me laisse un peu de repis.
Mais merci de me décrire les fonctionnalités de svn car j'ai un peu la flemme de chercher et même quand je cherche je ne comprend pas tout...
pour l'instant le seul truc qui me parait impossible à faire c'est de télecharger plusieurs fichiers à la fois pour mettre à jour le code source donc je regroupe tous les fichiers dans un zip.
Mais je me dit que ça doit être faisable de faire un petit script bash pour décompresser automatiquement l'archive dans le bon dossier ? est-ce facilement faisable ?

bien sur en bash tu peux tout faire. Mais je croyais que tu n'avais pas de serveur dédié .... comment exécuter un bash ? via php ?

non mais je parle chez l'utilisateur, pour que quand tu télecharge le zip contenant les fichiers à mettre à jour, on ai pas à décompresser le fichier manuellement dans le repertoire souhaité.

Ok ! Et si on faisait un updater ???
genre.
-télécharge irrlicht-fr/aip/changes.txt
-et pour chaque fichier listé dans le change.txt : wget irrlicht-fr/aip/src/lefichier.cpp

comme ça on passe pas par un zip

Si tu veux je te fait ça ce soir.. (c'est à dire dans 1h ou 2)

le problème c'est que j'utilise la bdd pour gérer tout ça donc ça va pas le faire, faut que je modifie trop de truc....
donc en attendant faut juste trouver un moyen de décompresser le zip automatiquement lorsqu'il est modifié, allez je te met au defi
Après on aura une imitation crédible de la svn.





ou pas :]

Rien ne t'empèche de créer automatiquement le fichier change.txt via php en partant de ta bdd

ps : ça pue un peu ton histoire de zip.

Dernière modification par TUpac (24-01-2011 17:51:37)

c'est ton change.txt qui pue HAHA ! c'est au niveau de la bdd qu'est enregistré le numero de version de chaque membre, donc quand tu te connecte au site ça te dit si il y a une maj ou pas. et quand tu fait la maj, ça update ta table dans la bdd. cherche pas je vais pas tout enumerer, mais tout passe par la bdd. Là même bdd qui n'est pas accessible depuis l'exterieur du ftp...

Ok fait comme tu veux mais il n'est pas d'usage de créer des zip sur site web. Surtout pour les attaques DOS.
C'est pas pour rien que personne ne fait comme ça

Oui mais bon on peut pas faire grand chose contre le DOS.....
après tu dit que personne fait comme ça, mafois je vois pas pourquoi, c'est facile de controlé la génération et de la limité à une par membre, une par maj, si il y a du dos à faire c'est plutot sur la bdd qui sature au bout de 2 connexions mais on a pas eu à se plaindre du ftp pour l'instant.

Je suis vos débat enflammés depuis le début de journée, c'est là que je mesure mon coté inculte sur la prog web.
Même si c'est pas le moment, vite fait, c'est quoi des attaques DOS ?

denial of service, deni de service: tu envoi plein de requete pour faire saturer le serveur.
et y a le Ddos, c'est quand c'est fait à partir de plusieur pc, là on entre carrément dans de la guerre virtuelle.

merci pour l'info

On est clairement deux tmyke ! Je suis loin de tout ça ...
Je n'ai qu'une chose à dire, bon courage ! Soyez fort !