Aktivieren von XML-Kommentare in C ++ in Visual Studio 2010

Question

Wie kann man aktivieren / erzielt XML-Kommentare für C ++ Methoden ala C # und VB in Visual Studio 2010? Es scheint, diese Funktionalität ist nicht aktiviert / Standard verfügbar ist.

Ausrichtung zunächst verwaltete C ++ Projekte.

Answer 1

Dies ist nicht in C ++ für VS2010 unterstützt.

Answer 2

Konfigurationseigenschaften -> C / C ++ -> Ausgabedateien. -> generieren XML-Dokumentationsdateien

In Kürze erhalten Sie müssen manuell alle Unterlagen Ihre xml hinzufügen (/// nicht automatisch erstellen eine Zusammenfassung Vorlage für Sie). Auch nicht unterstützt paramref. http://msdn.microsoft.com/en-us/library/ms173501.aspx

Answer 3

Um die automatische vollständige xml Stubs Dokumentation, wenn /// ist typisierten versuchen CppTripleSlash - xml doc Kommentare zu c ++ Erweiterung. Es hat auch einige grundlegende Intellisense, um eine vollständige XML-Tags innerhalb doc Kommentare.

Answer 4

Ich weiß, das ist die alte, aber überall, wo ich ausgesehen haben alle sagen das nicht unterstützt wird, müssen 3rd-Party-Tool oder ähnliches, keine, die nicht wahr ist. Was Sie wissen müssen, ist, dass XML-Dokumentation unterstützt und ist in Visual Studio 2010 zur Verfügung, und es gibt nur zwei Dinge über sie wissen:

1. Docs / Vorherige Versionen / Visual Studio / XML-Dokumentation / Empfohlene Tags zu Dokumentation Kommentare: https: //docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2012/ms177227%28v%3dvs.90%29

2. In "C ++ Projekteigenschaften / C / C ++ / Ausgabedateien / generieren XML-Dokumentationsdateien" auf "Ja (/ doc)"

Es wird erzeugen .xdc Datei für jede Quelldatei enthält Dokumentationskommentare „///“ und führen Sie sie in eine XML-Dokumentationsdatei. Und Dokumentation funktioniert gut später in anderen Projekten.