Doxygen

Accrochez-vous, voici la présentation d’un outil d’aide au développement extraordinaire, utilisé par de nombreuses équipes de développement, comme celles de KDE, IBM et Mozilla.

Tout d’abord qu’est-ce que Doxygen ? Bon, ceux qui ne développent pas ne trouveront sûrement pas cela fantastique, mais c’est un logiciel qui permet de générer une documentation du code source à partir de ses commentaires, donc dans le style de javadoc, mais en beaucoup plus puissant !

Voyons maintenant ses fonctionnalités.

Tout d’abord Doxygen est compatible avec de nombreux languages : C++, C, PHP, Perl, HTML, alors que javadoc lui se cantonne au Java.

Son fonctionnement est d’une grande simplicité : vous programmez normalement mais commentez votre code de manière un peu spéciale (mais pas trop) : par exemple le commentaire d’une fonction serait :



/**

 * Description courte.

 * Description loooooooooooooooooooooooogue.

 * @param param1 le paremetre 1.

 * @return le retour de la fonction.

 */

Ensuite vous configurez Doxygen. Grâce à une interface graphique des plus sympathiques vous pouvez par exemple :

Choisir le format de sortie (HTML, rtf, LaTeX, XML et même man pour les puristes !).
Configurer finement le format de sortie (par exemple HTML sans ou avec frames, avec telle feuille de style CSS...).
Générer automatiquement des diagrammes UML et même utiliser GraphViz pour faire des diagrammes encore plus beaux.
Intégralement compatible avec les tags javadoc, donc rien à changer si vous utilisiez cet outil.

Et hop, vous n’avez plus qu’à cliquer sur start et voilà un belle documentation qui ravira tous les développeurs qui rejoindrons le projet en cours de route.

Site officiel et téléchargement

Le site du projet Doxygen

Tags:
Ajouter des tags (séparés par des virgules ou des espaces) : Attention: tous les caractères spéciaux sont interdits (sauf le .). Les tags n'apparaîtront qu'au prochain rafraichissement du cache (dans plusieurs heures).

<< Mettre à jour >>
:: lien mort :: orthographe :: nouveauté :: mise à jour ::

Vous souhaitez mettre à jour la notice ? La première chose à faire est de déterminer s'il s'agit d'une mise à jour mineure ou d'une mise à jour majeure .

Mineure : un lien mort, des fautes d'orthographe, un lien à ajouter ou encore une petite précision.

Veuillez renseigner les champs ci dessous :

Votre nom ou pseudo

Paragraphe

Type de modification

Les modifications à apporter*
Majeure : une nouvelle version avec des nouveautés, des changements majeurs.

En cochant cette case, vous allez créer une page sur le wiki afin de mettre à jour la notice.

Mettre la notice de Doxygen sur le wiki

<< Poster un message >>
:: question :: précision :: avis :: commentaire :: bug ::

Doxygen , le 26 février 2007 par Archron (0 rép.)

Je fais partie d’une équipe de développeur C/C++/C# et nous avnons décidé d’utiliser DOxygne pour générer la documentation utilisateur de tout nos développement. Je dois avoué que j’ai été bluffé par le résultat de la doc HTML. J’ai par contre quelques réserve pour ce qui est du RTF... Il nécessite une reprise systématique... ou alors on a pas tout compris au niveau du paramétrage. Pour les autres formats, je ne peux rien dire. Bref, si on doit se forcer à respecter certains format au niveau des commentaires, on s’y fait très vite et cela devient un réflex, le tout pour un résultat très très pratique !

J’adore :o)

Répondre à ce message

À la une !

3/4 novembre : Formation "Réaliser un thème graphique avec Drupal" à l’Espace 13.1

La trahison de la
Commission européenne ?

L'actualité du libre :

Autres logiciels

Framasoft needs you !

Vous trouverez ici une liste de logiciels qui ont fait acte de candidature et qui n’attendent que vous pour réussir avec brio l’examen d’entrée dans notre annuaire.