Discussion :

[adjoly]

Bonjour,

A peu près tout est dans le titre.
J'utilise Visual studio 2005. J'aimerais générer automatiquement de la doc à partir des commentaires, un peu comme pour la javadoc.
Après, je prendrais ce que je trouverais. Dans l'idéal, j'aimerais générer des fichiers au format xml ou au format doc (.doc, .odt etc...) et ce à partir de Visual C++.

Merci pour vos réponses

[koala01]

Salut,

N'ayant pas Visual Studio sous la main, je ne sais pas s'il existe un outil particulier propre à cet outil, mais tu peux envisager de te tourner vers doxygen qui est indépendant de tout outil particulier et qui fournit une document très semblable à javadoc.

[wakan]

Bonjour,
Si tu veux faire de la documentation en utilisant visual studio je te renvoie à ce sujet de conversation.
http://www.developpez.net/forums/d38...e-code-csharp/
C'est du C# je sais mais cela doit être exactement pareil pour visual C++.

J'espère que cela pourra t'éclairer un peu.
A bientôt

[PetitPapaNoël]

Bonjour,

J'utilise la documentation xml de mes commentaires dans toutes mes classes et ça marche très bien. Pour cela, j'utilise la fonctionnalité de base prévue dans Studio, avec les commentaires xml marqués par /// et les tags de Studio.

Dans les options de compilation, il faut ajouter l'option /doc. C'est dans les propriétés du projet : Propriétés de configuration / C/C++ / Fichiers de sortie / Génération de fichiers de documentation XML à Oui (/doc).
Ca permet une vérification des balises au moment de la compilation. En cas d'erreurs de balisage, des avertissements sont générés.

Par contre, pour générer la documentation proprement dite, au format chm, j'utilise Doxygen, comme suggéré par koala01. Il suffit de bien le paramétrer au départ et le résultat est vraiment bon.

NB : ta discussion rejoint celle-ci, où tu trouveras quelques précisions supplémentaires.

[adjoly]

Merci pour vos réponses.

Je découvre Doxygen et ça me semble tout à fait adapté à mon besoin !

J'essaierais aussi le générateur de fichiers xml de Visual studio pour voir si il y a des choses interessantes.

Merci bien