C++ XML-Kommentare zum Generieren von MSDN-Stil CHM

Question

Ich habe mehrere Projekte, einige mit verwaltetem Code und einige mit nur nicht verwalteten. Alle haben die XML-Kommentare hinzugefügt und die XML-Dokumentation wird korrekt generiert (die generierte XML-Datei und dazwischen die xdc-Dateien).

Sicherlich gibt es etwas, das diese Dateien nehmen kann (die Ausgabe von xdcmake) und MSDN-Stil erzeugen chm help! ? Soweit ich weiß, ignorieren sowohl Doxygen als auch Sandcastle diesen offensichtlichen Schritt und erfinden das Rad neu, um den Code erneut zu scannen. (Es gibt auch die Tatsache, dass Sandcastle für Nicht-.NET-Projekte scheinbar nutzlos ist).

Doxygen (schreckliche Ausgabe, aber schnell) und Sandcastle (nette MSDN-Ausgabe, aber sloooooow) versucht beide von etwas viel einfacher zu übertreffen.

Es wäre auch schön, wenn es einen Editor gäbe, der auch die Seiten 'Erste Schritte' und 'Information' schreiben könnte, die auch für jede API-Dokumentation benötigt werden.

Kennt jemand irgendwelche Lösungen?

Answer 1

Sie möchten vielleicht DoxyComment versuchen. Hier ist die Beschreibung von Doxygen des Helper tools & scripts:

Ein Addin für Visual Studio 2005 genannt DoxyComment von Troels Gram erstellt wurde. Es wurde entwickelt, um Sie in assistieren kontextsensitiven Kommentar Blöcke in C/C++ - Quelldateien zu unterstützen. DoxyComment kommt auch mit einem xslt Vorlage, mit der Sie Dokumentation wie die MSDN-Bibliothek generieren können.

Answer 2

Ehrlich gesagt ist Sandcastle Ihre beste Wette. Ich weiß, dass die Konfiguration etwas mühsam sein kann, aber die Dokumentation ist genau der Stil, nach dem Sie suchen.

Answer 3

weiß, dass ich das Projekt, wo die Menschen noch NDocConsole

verwenden jedoch nehme ich an, dass NDoc ein totes Projekt ist, weil auf http://ndoc.sourceforge.net/ es keine Updates sind seit 2005