Generation de documentation automatique - Programmation
MarshPosté le 05-02-2002 à 21:34:26
Aujour'hui j'ai trouve un soft DOXYGEN qui permet a partir d'un prog en C d'extraire des commentaires et la structure du prog et de sortir une doc en HTML pour le moins. J'aimerais avoir des idees pour minimiser les contraintes du programmeur concernant l'adequation de la sybtaxe des commentaires avec DOXYGEN.
Par exemple, pour une entete de fonction, pour que DOXYGEN comprenne quelque chose il faut ecrire :
Je voudrais simplifier avec des alias par exemple ALIASES = "objet=/par Objet"
En gros, pour resumer, il faudrais que les commentaires du code soit lisible tel quel en plus de la doc HTML.
Sinon je cherche un logiciel gratuit permettant de generer un squelette de programme avec commentaires pre-formatttes a partir d'un seule ligne de commande.
Marsh Posté le 05-02-2002 à 21:34:26
Aujour'hui j'ai trouve un soft DOXYGEN qui permet
a partir d'un prog en C d'extraire des commentaires
et la structure du prog et de sortir une doc en HTML
pour le moins.
J'aimerais avoir des idees pour minimiser les contraintes
du programmeur concernant l'adequation de la sybtaxe des commentaires avec DOXYGEN.
Par exemple, pour une entete de fonction, pour que DOXYGEN comprenne quelque chose il faut ecrire :
/**
* /par Objet:
*
* Cette fonction, BLABLA ....
*
*/
Je voudrais simplifier avec des alias par exemple
ALIASES = "objet=/par Objet"
En gros, pour resumer, il faudrais que les commentaires
du code soit lisible tel quel en plus de la doc HTML.
Sinon je cherche un logiciel gratuit permettant de
generer un squelette de programme avec commentaires pre-formatttes a partir d'un seule ligne de commande.
'ci