Quel g�n�rateur de documentation pour le C++?

Bonjour,

j'ai l'habitude d'utiliser doxygen pour g�n�rer automatiquement la documentation de mes codes mais je me demande si c'est le mieux adapt� au C++. En cherchant un peu sur la toile, je pensais que je ne trouverais pas beaucoup d'alternatives... finalement il y en a beaucoup trop :
http://en.wikipedia.org/wiki/Compari...Output_formats
Ce tableau n'est d'ailleurs pas exhaustif. Je suis par exemple tomb� sur cette solution qui m'a l'air int�ressante :
http://www.doxys.dk/doxys_homepage/S...scription.html

Quelle(s) solution(s) utilisez-vous?

Merci!

Doxygen... C'est presque un standard !
En tout cas, tout le monde � l'habitude de naviguer dans ce type de doc, pas de risque d'�tre perdu. Je trouve �a plut�t simple � �crire. Et j'ai pas l'impression de manquer de fonctionnalit�s.

� part la curiosit�, es-ce que quelque chose te pousse � explorer d'autres solutions ?

Bonjour,

M�me avis que djuju, j'utilise doxygen, simple d'utilisation, on peut faire de tr�s bonnes documentations (cf la doc de la SFML), et il me semble qu'on peut m�me g�n�rer quelques diagrammes avec.

Oui on peut g�n�rer des diagrammes avec GraphViz en compl�ment de Doxygen et c'est vraiment tr�s pratique !

Je regarde plus par curiosit� qu'autre chose. Je n'ai pas la derni�re version, cela s'est peut-�tre am�lior�, mais je me souviens par exemple que l'insertion de commandes Latex dans les commentaires n'�tait pas particuli�rement bien pens�e � l'�poque. J'ai souvenir �galement que d�s que l'on utilise des templates, on obtient des choses difficilement lisibles (graphes avec Graphviz compris). Je pense � ce genre de choses :

Code:

---

template<typename T1,template<typename,size_t> class T2,size_t T3> class Foo : public T2<T1,T3> {};

---

Je vais tout de m�me refaire un test par acquis de conscience.

Doxygen aussi... en attendant qu'un projet b�ti autour de clang ne surgisse (ce qui ne manquera pas AMA)

Citation:

---

Envoy� par Luc Hermitte

Doxygen aussi... en attendant qu'un projet b�ti autour de clang ne surgisse (ce qui ne manquera pas AMA)

---

Vivement que �a marche sous windows...

Bonsoir,

j'ai finalement commenc� � tester la nouvelle version de Doxygen et je maintiens que ce n'est pas terrible, ou alors je l'utilise mal. Par exemple, le traitement des sp�cialisations partielles ne me convient pas du tout puisque la documentation de ces derni�res n'est pas prise en compte, typiquement avec la commande \brief.

Quelqu'un a-t-il r�ussi � contourner le probl�me?

EDIT : au temps pour moi, c'est d� � la pr�sence de templates variadiques qui ne doivent pas �tre encore support�s.