Discussion :

[titi_77]

Bonjour,

Je souhaiterais pouvoir extraire les commentaires mis dans des sources C# dans un fichier XML, puisque j'ai lu que ça se faisait ainsi.
J'ai cru voir qu'il fallait compiler avec /doc:file.xml mais je ne vois pas où mettre cette option dans Visual Studio 2005.


Une fois le fichier XML créé, où peut-on trouver un XSL qui me donnera une belle présentation, HTML par exemple (l'habitude javadoc...) ?

Autrement, quelqu'un a-t-il utilisé Ndoc avec .net 2 ? J'ai pris la dernière version stable (car la dernière release n'accepte pas le .net 2) mais pas encore testée.


Merci...

[titi_77]

désolé, j'avais vu que la réponse est là :
http://www.developpez.net/forums/sho...ht=commentaire


Enorme, c'est un projet open-source qui est la seule solution pour générer la doc de Microsoft !!!
Certains me diront, avec l'XML, on peut tout faire... sauf que quand on veut faire simple, c'est pas possible...

Vive la javadoc intégrée dans le JDK...

[ORB99]

As tu réussi a faire fonctionner ndoc en .net 2.0?

Que faut il penser de doxygen ?
http://www.stack.nl/~dimitri/doxygen/index.html

et ici des exemples
http://cyberzoide.developpez.com/java/doxygen/

Quelle est la meilleure manière de documenter le code en c# ? Doit on passer par un outil qui extrait les commentaires ( j'arrive pas utiliser les deux la), ou en trouver un autre qui sert à fabriquer de la documentation à partir d'informations hors du code source ?

[dev01]

As tu réussi a faire fonctionner ndoc en .net 2.0?

NDoc est LA référence pour la génération de code à partir de .NET. La version qui supporte le .NET 2.0 est encore en version instable mais fonctionne assez bien (je l'utilise depuis 3 semaine). il faut que tu télécharges une nighty source et que tu compiles toi même (proj VS 2005).

[ORB99]

Je croyais que ndoc était à l 'arret.
Est ce que tu parles du cvs de sourceforge pour obtenir les sources ?

http://sourceforge.net/cvs/?group_id=36057

En tout cas je vais essayer...

Merci !!!