Discussion :

[basnifo]

Bonjour

J'ai un projet que j'aimerais bien commenter de facon un peu plus "claire".
J'ai bien des commentaires mais bon ...

Mes questions sont donc :
- Comment bien commenter son code facilement sans que ca soit illisible ?
- Existe t'il des manières de commenter / des outils (internes ?) pour Visual C++ 6 ? (et non .net) (un peu comme la java doc par exemple ...)

merci !


La FAQ et la recherche ne m'ont pas aidé ...

[Aurelien.Regat-Barrel]

Avec VC++ 2005 y'a les commentaires xml, à la C#. Mais on utilise plus traditionnellement doxygen.
Les commentaires doivent apporter quelque chose. Si c'est pour réécrire en français le code C++, ça sert à rien. Par contre si tu expliques ton algo et le rôle des variables, c'est utile. Perso, j'essaye de décrire mon algo, pour que si on supprime le code on puisse retrouver son fonctionnement via les commentaires. Mais j'aime bien aussi l'approche de la programmation XP qui dit aucun commentaire car s'il en faut c'est que le code est dur à comprendre, donc il faut le retravailler pour le simplifier. C'est exagéré, mais tu vois l'idée : commenter ce que fait le code, et non comment il le fait.
Ecrire les commentaires avant le code, c'est utile aussi pour se rendre compte de bêtises avant de les écrire.

[barthelv]

Comme outil il existe Doxygen qui est gratuit, tres simple et fait des docs super. Il te cree meme les schemas qui te montrent comment s'incluent tes fichiers et classes. Tres utile pour voir si l'on a fait du code propre. Il est tres utilise dans le monde professionnel.

http://www.stack.nl/~dimitri/doxygen/

Pleins d'exemples de docs avec Doxygen:

http://www.stack.nl/~dimitri/doxygen/projects.html

[basnifo]

doxygen .. je vais me renseigner ..

Sinon j'ai bien précisé VC++ 6, pas 2005 ...

En fait je programme depuis quelques années donc je sais commenter "en gros".

Mais la je chercherais à avoir quelque chose de plus propre, p-e même que VC++ 6 utilise des instructions pour les commentaires afin de pouvoir les traiter ... bref cela je ne le sais pas , d'où ma question

merci ...

EDIT : merci aussi barthelv Je vais donc voir d'un peu plus près ce logiciel ...
Si vous avez d'autres renseignements à m'apporter, n'hesitez pas