processing : Un "Javadoc" ou "Doxygen" pour Processing ?

EricRG · 2012-05-02 13:03:18

Bonjour,

J'aimerais bien trouver un système pour me faciliter le travail de documentation sur mes programmes Processing mais je ne sais pas comment faire.
Je n'ai franchement pas le temps de me mettre à programmer en Java proprement dit (avec NetBeans ou Eclipse...) sans compter que j'aimerais plus utiliser la version JS...

Merchi bôcoup

cgiles · 2012-05-02 14:52:51

Ben tu peux créer un programme processing qui lit tes fichiers source et repere une balise titre, et une déscription, comme doxygen

EricRG · 2012-05-02 15:14:36

Je ne m'attendais pas à cette réponse !!!

Oui, je crois que je vais me fabriquer quelque chose moi même !!!!

... quand j'aurai suffisamment avancé dans la nouvelle Bibliothèque de classes que je commence pour gérer des widgets (boutons, menus, et tout ça et tout ça... + l'écriture et la lecture de tables de données... ça marchera pour processing java ET processing JS),
NB c'est cette bibliothèque là que je mettrai en opensource en utilisant la petite expérience que j'ai acquise grâce à mes jeux vidéos.
J'en reparlerai prochainement ici

mais je vais réfléchir séparément à cette question de documentation

P.S. je n'y avais pas encore pensé mais, c'est vrai, on est jamais aussi bien servi que par soi-même lol

emoc · 2012-05-02 17:48:09

Salut,

Le principe est d'utiliser certaines balises dans les commentaires pour générer automatiquement de la doc, cf. http://fr.wikipedia.org/wiki/Javadoc
Tu n'as peut-être pas besoin de le construire toi-même mais juste d'adopter le style d'écriture des commentaires.

cgiles · 2012-05-02 19:37:48

En tout cas c'est cool que tu penses a la doc, car souvent c'est ce qui fait défaut...

EricRG · 2012-05-03 17:01:22

Bon !

Je suis arrivé à installer Doxygen et à le faire marcher chez des amis (je n'ai plus internet à la maison : galère !) et ça marche bien en indiquant comme fichier source le fichier java généré par Processing lors d'une exportation.

Je commence donc à regarder les tags de doxygen.

Je vais essayer aussi javadoc... je suppose qu'il faut juste écrire : javadoc nomdufichier.java (j'ai le jdk de oracle et l'open sur mon disque) !
heeeelp (je m'y perd complètement dans le site de oracle !!!) est-ce que quelqu'un peut me donner quelques arguments à mettre sur la ligne de commande ? Je voudrais juste générer une doc toute simple à partir d'un seul fichier blabla.java ! (une version html avec frame et arbre + une version dans un fichier .rtf comme ce que propose doxygen serait super

merciiiiiiiiiiiiiiiiiiiiiiiiii

P.S. Je vais vous montrer ma première doc (un peu pourrie car mes commentaires ne sont pas complètement ok avec doxygen) sur mon t out tout debut de bibliothèque (y a pas grand chose encore, je veux règler cette histoire de doc avant de m'y mettre vraiment)

Dernière modification par EricRG (2012-05-03 17:14:18)

EricRG · 2012-05-03 17:21:51

C'est là lol

http://legaou.net/a/processing

cgiles · 2012-05-03 20:02:39

ça roxxx. C'est bien cool de voir ça^^

EricRG · 2012-05-04 11:20:16

http://legaou.net/a/processing/javadoc- … index.html

J'ai refait tout ça avec javadoc

Ca marche impec donc (à part un petit problème d'accents mais c'est un détail, de toute façon j'ai tout mis en anglais maintenant dans mon fichier original).

Donc, je travaille dessus et je vous en reparle au fur et à mesure que j'ai des petites démos

Ensuite je publierai tout ça pour qu'on puisse m'aider un peu (à mon avis, ça peut être utile pour pas mal de monde !).

22_ · 2012-05-04 16:18:27

javadoc est aussi très utile quand tu développes sur un IDE comme Eclipse, dès que tu charges une librairie tu as accès à toute la doc juste en survolant une fonction ou un objet.

EricRG · 2012-05-05 14:40:24

en effet !

Ce petit mot pour indiquer la création du sujet Blocks dans le forum ProcessingJS ici : http://codelab.fr/3361#p17782

cgiles · 2012-05-05 15:39:03

Faudrait que je me mette a eclipse.
Quelqu'un sait si c'est faute de moyen ou un choit editoriale la non evolution de l'ide provessing ?

22_ · 2012-05-05 17:59:26

je ne sais pas vraiment... ce qu'il faudrait c'est une version d'Eclipse spéciale développeur processing. je ne conçois plus trop de développer du java / processing sans eclipse, mais c'est vrai que l'interface peut perdre / rebuter un développeur processing

22_ · 2012-05-05 18:00:44

ah... du coup je découvre un plug-in processing pour Eclipse : http://wiki.processing.org/w/Eclipse_Plug_In
quelqu'un a déjà jeté un coup d'oeil ?

22_ · 2012-05-05 18:02:27

et il y a ce truc aussi : http://code.google.com/p/proclipsing/

Annonce

#1 2012-05-02 13:03:18 Un "Javadoc" ou "Doxygen" pour Processing ?

Un "Javadoc" ou "Doxygen" pour Processing ?

#2 2012-05-02 14:52:51 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#3 2012-05-02 15:14:36 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#4 2012-05-02 17:48:09 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#5 2012-05-02 19:37:48 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#6 2012-05-03 17:01:22 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#7 2012-05-03 17:21:51 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#8 2012-05-03 20:02:39 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#9 2012-05-04 11:20:16 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#10 2012-05-04 16:18:27 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#11 2012-05-05 14:40:24 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#12 2012-05-05 15:39:03 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#13 2012-05-05 17:59:26 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#14 2012-05-05 18:00:44 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

#15 2012-05-05 18:02:27 Re : Un "Javadoc" ou "Doxygen" pour Processing ?

Re: Un "Javadoc" ou "Doxygen" pour Processing ?

Pied de page des forums