Discussion :

[samalairbien]

Bonjour,

J'ai en ma possession les sources d'un projet codé en C#. Ces sources sont commentées. Je souhaiterais générer la documentation de ce projet. Pour cela, j'ai installé MS Visual C# 2008 Express Edition, que j'ai paramétré pour me générer la documentation au format xml. Cependant, je souhaiterais transformer ce xml en format texte ou web.
J'ai vu que l'utilitaire NDoc (v 1.3) permettait de le faire (cf. http://dotnet.developpez.com/cours/?page=csharp). Mais lors son installation depuis la page http://sourceforge.net/project/downl...mirror=surfnet, j'ai une erreur qui ne me permet pas d'installer correctement l'utilitaire:

The cabinet file '_E2FF6FAD15853C03566B7E2D1F6485CA' required for this installation is corrupt and cannot be used. This could indicate a network error, an error reading from the CD-ROM, or a problem with this package.


Etant donné que HTML Help Workshop semble requis pour que NDoc fonctionne, je l'ai installé (je pensais qu'il l'avait été avec MS Visual C# 2008 Express Edition) mais le problème persiste.


Je me pose donc les questions suivantes:
1) Savez-vous d'où vient l'erreur déclenchée lors de l'installation de NDoc?
2) Si non, connaissez-vous un autre moyen pour transformer mon fichier xml de documentation en fichier texte ou web?


Merci d'avance pour votre aide.
Bonne journée.

[Philippe Vialatte]

Salut,

pour NDoc, tu risque d'avoir un peu de mal, vu qu'il ne supporte pas vraiment les versions recentes du framework (plus de dev depuis 2005, de tete).

Regarde du cote de sandcastle, plutot (je suis en train de bosser sur un p'tit article, mais il est encore trop dans les cartons....)

Ceci dit, en cherchant un peu sur le web, tu devrais pouvoir trouver assez d'infos pour generer ta doc

[samalairbien]

pour NDoc, tu risque d'avoir un peu de mal, vu qu'il ne supporte pas vraiment les versions recentes du framework (plus de dev depuis 2005, de tete).

En fait j'ai trouvé l'erreur: ça venait bêtement de l'installeur qui merdait. En changeant de mirroir, j'ai réussi à installer NDoc et à générer ma documentation en html.

Merci quand même pour ton aide pvialatte.
Bonne soirée.