Non vraiment ...

Et pour commencer, une ptite musique:

Découvrez Jean Michel Jarre!

Ca vient du dernier album de Jean Michel Jarre, Téo & Téa, et c'est une musique qui me rappelle un peu Geometry of Love, album que j'avais trouvé excellent.


...Doxygen c'est vraiment bien.

Voilà.

Intéressant n'est-il-pas ?

Avec un train de retard, je commente donc enfin mon code en utilisant Doxygen, logiciel qui permet de générer une documentation d'un code C / C++ ... à la manière de la JavaDoc.

C'est relativement simple ... relativement car il y a plein de possibilités et pour tout maitriser, il va falloir un moment ! La documentation générée est claire, on peut facilement faire des liens vers des types, des fonctions, des structures, ... Bref c'est très bien fait. On a même droit à une version Latex qui a de la gueule aussi (avec présence de liens, la classe quoi :p).

Mais, outre le fait que ce soit dispo sur la pingouin, la pomme et la fenêtre, il y a quand même la raison ultime qui fait que nous devons tous adorer ce logiciel (que ceux qui s'attendent à une raison détaillée, intelligente, précise ... vous pouvez arrêter de lire là :p). Et cette raison, c'est cet exemple présent dans la documentation:
/*! \class WindowsNT
* \brief Windows Nice Try.
* \author Bill Gates
* \author Several species of small furry animals gathered together
* in a cave and grooving with a pict.
* \version 4.0
* \date 1996-1998
* \bug It crashes a lot and requires huge amounts of memory.
* \bug The class introduces the more bugs, the longer it is used.
* \warning This class may explode in your face.
* \warning If you inherit anything from this class, you’re doomed.
*/
class WindowsNT {};

Voilà rien à ajouter ^^.

Pour télécharger le logiciel c'est par là, sans oublier le wiki.