permettant des commentaires XML en C ++ dans Visual Studio 2010
-
27-09-2019 - |
Question
Comment peut-on activer / obtenir des commentaires XML pour les méthodes ala C # et VB C dans Visual Studio 2010? Il semble que cette fonctionnalité est désactivée / disponible par défaut.
Ciblage initialement géré des projets C ++.
La solution
Ce n'est pas supporté en C ++ pour VS2010.
Autres conseils
Propriétés de configuration -> C / C ++ -> fichiers de sortie -.> Générer la documentation XML fichiers
Vous devrez ajouter manuellement tous vos documents XML (/// ne pas automatiquement créer un modèle de résumé pour vous). ne prend pas en charge paramref. http://msdn.microsoft.com/en-us/library/ms173501.aspx
Pour autocomplétion talons de documentation xml quand /// est dactylographiée essayer CppTripleSlash - commentaires doc xml pour c ++ l'extension. Il a aussi quelques IntelliSense de base pour compléter les balises XML dans les commentaires doc.
Je sais que c'est l'ancien, mais partout où je l'ai regardé tout le monde dire de PAS PRIS, besoin outil 3ème partie ou similaire, aucun qui n'est pas vrai. Ce que vous devez savoir est que la documentation XML est pris en charge et est disponible dans Visual Studio 2010, et il n'y a que deux choses à savoir à ce sujet:
-
Docs / Versions précédentes / Visual Studio / XML Documentation / Mots-clés recommandés pour la documentation Commentaires: https: //docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227%28v%3dvs.90%29
-
Dans "C de propriétés du projet / C / C ++ / de sortie des fichiers / Générer la documentation XML des fichiers" sur "Oui (/ doc)"
Il va générer .xdc fichier pour chaque fichier source contenant des commentaires de documentation « /// » et fusionner en un seul fichier de documentation .xml. Et la documentation fonctionne très bien plus tard dans d'autres projets.