Discussion :

[batbaille]

Bonjour à tous,

Je travaille actuellement sous VisualC++ et je recherche un outil gratuit pour générer de la documentation à partir de code c++.

Suite à une petite recherche, j'en ai trouvés de nombreux mais certains ont retenu mon attention :
- Doxygen (bien sure)
- Doc++
mais aussi :
- ScanDoc
- SDoc
- ccdoc

Pouvez-vous me faire partager vos suggestions sur les logiciels si dessus ou tout autres que vous aurez appréciés. Sachez néanmoins que je souhaite que le logiciel sous gratuit et génère une documentation HTML et pourquoi pas PDF.

Merci à tous

Batbaille

[tut]

j'utilise Doxygen : rapide, configurable, simple.
Bref, c'est de la balle.

[Aurelien.Regat-Barrel]

Je n'ai testé que doxygen, et n'ai pas eu l'idée de chercher autre chose car il est très complet. Y'a un plugin pour l'intégrer à VC++ aussi:
Tu peux générer du LaTeX aussi, donc sortir du PDF ne doit pas être trop dur.
C'est un peu galère à configurer tellement y'a d'options, mais une fois réglé c'est tip top. 8)
J'ai pas encore testé DoxyS qui est basé sur doxygen, et qui semble générer une doc plus jolie.
http://www.doxys.dk

[tut]

pour configurer Doxygen j'utilise un logiciel qui s'appelle Doxywizzard, qui semble utiliser Qt, c'est simple à utiliser, et ça affranchit de la ligne de commande grande comme ça.
8)

[Charlemagne]

J'utilise DocJet

Il est nettement mieux que doxygen, mais il est payant.

Par contre une version gratuite permet de faire jusqu'à 300 commentaires, sans aucune autre restriction, ce qui est suffisant pour des projets de taille non démesurée.

Par exemple mon projet, nécessite un peu moins de 300 commentaires pour l'instant:
http://www.ient.rwth-aachen.de/team/laurent/genial/genial.html
Clicker sur manuel online.

[bigboomshakala]

j'ai commencé à utiliser Cppdoc hier. pas utilisé Doxygen, donc je peux pas comparer, mais on m'a dit que le résultat était très proche. (et il me semble que les mots-clés utilisés sont les mêmes, donc on peut interchanger)

j'ai configuré que dalle, le chose de base me convient (style javadoc)

[Luc Hermitte]

Sympa doxys. Il semble avoir une bien meilleure gestion des templates que doxygen.
Dommage qu'ils ne soit pas à 100% compatible avec doxygen (divers mots clés, groupes...), plus lent, et légèrement instable. :-(

[batbaille]

Aurélien,

Tu m'a parlé d'un plugin Doxygen pour Visual C++,

Serait il possible que tu me dises ou je puisse trouver ce plugin ?

Je t'en remercie

[Aurelien.Regat-Barrel]

http://www.codeproject.com/macro/KingsTools.asp
Marche pas pour VC++ 6 je crois.