Discussion :

[Aymerik]

Salut,
je désire documenter mon code et pour ce faire, utiliser la documentation en XML. Ainsi je peux en disposer dans l'explorateur d'objets.
Voici un exemple de ce que j'ai pu écrire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
/// <summary>Creates a <c>MessageBox</c> in order to ask confirmation for saving the current board...</summary> 
/// <param name="msg">Text displayed in the <c>MessageBox</c></param>
/// <returns> true if Yes or No option has been chosen, false otherwise</returns>
private: bool saveMessageBox(System::String^ msg) {
	return true;
}

Le problème est le suivant : dans l'explorateur d'objet, lorsque je sélectionne la méthode documentée, j'ai le résultat suivant :

Résumé :
<summary>Creates a <c>MessageBox</c> in order to ask confirmation for saving the current board...</summary>
<param name="msg">Text displayed in the <c>MessageBox</c></param>
<returns> true if Yes or No option has been chosen, false otherwise</returns>

Les balises ne semblent pas être prise en compte, elles sont affichées comme du texte. Ai je oublié quelque chose, ou avez vous le même problème ?

pour info, je suis sur Visual C++ Express Fr

[nico-pyright(c)]

c'est une librairie (assembly) que tu commentes ?

[Aymerik]

non, c'est un source d'un éxecutable WinForms.

[Aymerik]

En fait, j'ai remarqué que même les commentaires XML ajoutés automatiquement à la création de la WinForm ne s'affichent pas correctement dans l'Explorateur d'objets.
Ce comportement est-il le même sur la version anglaise de VC++Express (quid de Visual Studio) ? Ou me manque t-il une option à activer ?

[PetitPapaNoël]

J'ai constaté le même problème dans Visual Studio 2005 (C++).
Je pense que cette fonctionnalité, qui vient d'apparaître en C++, n'en est qu'à ses débuts. Espérons qu'elle sera améliorée et enrichie dans les prochaines versions !