BLDoc : documentation Javadoc-like pour AS2
Par -Alexandre LEGOUT aka LAlex- le vendredi, septembre 3 2004, 17:31 - Liens - Lien permanent
Je n'aime pas reprendre les nouvelles, mais ce n'est pas sans une certaine fébrilité que j'ai appris sur le site de Chafic Kazoun et Samuel Neff (et en français chez petepx) que la béta public de BLDoc 1.0 était enfin disponible.
Depuis les prémices de ce projet, il s'est annoncé comme étant le logiciel le plus prometteur en la matière. Quelques échanges de mails avec Samuel Neff m'avaient fait entrevoir les possibilités énormes du soft, et les avantages qu'il représentait pour la documentation des développements AS2. Un problème juridique concernant mon propre développement d'un parseur de doc en PHP m'ayant empêché de participer à l'alpha privée, je vais enfin pouvoir l'essayer, et ainsi reprendre le développement de ma version, afin qu'elle soit compatible avec BLDoc ! ![]()
Foncez donc, l'inscription à la beta publique c'est chez B-Line Express ![]()
Commentaires
Je viens de tester la syntaxe ASDoc ce matin avec SEPY ... et maintenant je viens de tester BLDOC sur mon package.... c'est bluffant !

Je continue à pas trop aimer la syntaxe de ASDoc ... mais cela fait gagner un temps fou c'est clair
bye
Dommage que la documentation des événements pour la sortie "FLASH" ne fonctionne pas
Je retourne à la mise en place des ASDoc dans mes classes, j'ai du boulot lol
Sinon à l'usage c'est blufffant les possibilités de cette application
Ca marche très bien chez moi, ça crée même automatiquement un exemple dans la doc Flash générée.
Exemple :
/*** @summary Broadcasted to listeners when instance is graphically rendered.<br>
* @see com.bourre.visual.abstract.VisualGridObjectEvent
* @see com.bourre.visual.abstract.VisualGridObject#renderView
*/
[Event("onRender")]
public static var onRenderEVENT:Event = new Event("onRender");
Donne :
Broadcasted to listeners when instance is graphically rendered
Usage 1:
on(onRender){
// your code here
}
Usage 2:
listener = new Object();
listener.onRender = function(eventObject){
// your code here
}
visualGridObject.addEventListener("onRender", listener)
Description
Event;
See Also
VisualGridObjectEvent Class, VisualGridObject.renderView()
ok en fait j'ai mal lu alors


Car en lisant comme je le fais d'habitude à motié lol j'ai juste lu :
Bon je vais essayer calmement tous les tags qui sont définis comme cela je dirai moins de bêtise
Sinon si c'est pas indiscret là je vois que tu utilises une classe Event ? C'est une classe à toi ? ou une classe en rapport avec la metabalise au dessus que je ne connais pas dans FLASH ?
bye
Oui.
très sympa !
j'espère qu'il sera pas trop cher, parce 5000 lignes ... ahem !
J'en ai un peu marre d'essayer plusieurs générateurs de doc, il faut changer les commentaires à chaque fois pour que ca marche ...
Pour l'instant, aucun n'est finalisé (parmi ceux que j'trouve bien) ...
Quand il y en aura un, toutes les classes qu'il faudra recommenter ... lol ca me fatigue déjà
Dans la lignée des documentateur as2, celui qui est utilisé par as2lib paraît super, il marche bien et on peut même le tester... l'avantage est qu'il implémente beaucoup de tag javadoc, donc c'est assez simple, clair et sympa je trouve
http://visiblearea.com/visdoc/
Si je devais un choisir un, ça serait celui-là... par contre, c'est juste le fait de devoir payer qui me dérange :s
il parait bien mais ce n'est que pour Mac OS X
dommage oui
Fil des commentaires de ce billet