Une sorte d'equivalent de javadoc mais pour les classes des tags...  
Quelqu'un a une idee ? Merci d'avance.

ben pq pas la javadoc?

 
Parce que le resultat est bof... Disons pour etre plus exact que la documentation que je desire obtenir doit plutot etre le reflet de la TLD. Voila. Si quelqu'un a une idee...

ben rien ne t'empeche d'écrire la doc des attributs dans la javadoc...
c'est le "style" javadoc que t'aimes pas, parce que c'est pas très lisible pour qqun qui connait pas, peut etre?

--greg-- a écrit a écrit : ben rien ne t'empeche d'écrire la doc des attributs dans la javadoc... c'est le "style" javadoc que t'aimes pas, parce que c'est pas très lisible pour qqun qui connait pas, peut etre?

 
Hmm disons que pour la personne qui utilise la librairie, c'est effectivement interessant de voir les attributs qui correspondent a des parametres du tag. Sauf que avec "javadoc -private", il a aussi des informations sur des attributs qui ne le concernent absolument pas.

ben tu lui generes pas le -private tiens.
ou sinon, un traitement de texte, c pas mal aussi

 
Bah l'usage veut que les attributs qui correspondent a des parametres soient private, non ? Et sinon le traitement de texte, bah birk ! Quoiqu'il en soit, merci.

ben oui mais je te dis pas de commenter les attributs de classe, mais les attributs du tag, c-a-d dans la doc de la classes du genre

 
genre ça quoi...

 
Oui, et t'as les setters (et eventuellement les getters, mais y'en a pas trop besoin la) en public. En fait faudrait parser le .tld et génerer la doc a partir de la. Ca doit sans doute exister mais je connais pas.

 
Voila. C'est exactement ce que je voulais entendre modulo la derniere phrase.

bah tu dois quand meme décrire les attributs du tag quelquepart, de toutes façons, ça se fait pas dans le tld.

 
C'est en partie ce que je fais mais c'est tres laid.

 
NetBeans permet de le faire, faut que je regarde ou il stocke ces infos.

oui, et comment il genere la doc...

ne tiens qu'a toi de changer le stylesheet et le doclet utilisé par javadoc pour generer la doc...

 
Effectivement. D'ailleurs, je n'ai jamais compris pourquoi dans la DTD, ce n'est pas :
<!ELEMENT attribute (name, required? , rtexprvalue?, info?)>

Bon, en fait y'a moyen de mettre une description du tag et un exemple, mais pas directement au niveau attribut.

 
A l'instar de tous les bons informaticiens, je suis un gros faineant

bah euh parce que c'est pas prévu comme ça
c'est vrai que ça pourrait je crois, mais le tld est là pour informer ton jsp container, pas pour autre chose à priori, mais bon pourrait dire la meme chose des sources java alors.mmmh.

bah ouais, en commentaires <!-- truc --> ?  pour faire ça, jprefere franchement le foutre en javadoc, perso. à moins qu'il y ait un standard pour documenter ça.

Ce que tu peux toujours faire c'est mettre un commentaire en premier fils de l'element xml, le parseur te permet de le recuperer. Mais bon, ca reste pas terrible.

nan mais en fait, au niveau du tag, dans la tld, y'a un element "<description>", nan? bon ben tu met tout la dedans, c cool.
(j'avais oublié ça...)

 
Bah oui mais pourquoi ils n'ont pas mis un champ du meme style pour les attributs ? De toute façon, je ne sais toujours pas si il existe un outil pour generer de la doc a partir de la TLD...

ben t'as quand meme pas TANT QUE CA à documenter pour chaque attribut. tu met tout au niveau du tag, et basta.

Vous avez trouvé un truc pour génerer une doc a partir des description & exemple du tld finalement ? Parce que j'en ai besoin tout d'un coup et j'ai pas envie de me faire ma propre moulinette  

bon, ben visiblement y'a ca :  
http://sourceforge.net/forum/forum.php?forum_id=191075

lorill a écrit a écrit : Vous avez trouvé un truc pour génerer une doc a partir des description & exemple du tld finalement ? Parce que j'en ai besoin tout d'un coup et j'ai pas envie de me faire ma propre moulinette

ben t'avais pas dit que netbeans....?

ben il me permet de la saisir ou de l'ouvrir dans une petite fenetre, mais tout le monde n'utilise pas netbeans et je voudrais bien avoir un export html propre de ce que j'ai tapé dans ma petite fenetre.

ha ok