Tool zur Generierung von C++-Codedokumentation

Ich möchte automatisch HTML-Dokumente für C++-Code generieren und habe in der Vergangenheit Doxygen verwendet, aber wenn ich mir beispielsweise die NVIDIA CUDA-Dokumentation anschaue, muss es bessere Tools geben ;-)

Kennt jemand ein Dokumentenerstellungstool mit vergleichbarer Qualität. Wikipedia hat eine große Vergleichsseite , die aber so groß ist, dass sie für eine Empfehlung nicht brauchbar ist.

Bei allem Respekt Steve, aber auch deine Frage ist für eine Empfehlung nicht brauchbar . Wenn Sie keine Kriterien angeben, die die Software erfüllen muss, wie kann jemand eine Empfehlung aussprechen? Nur auf das NVidia-Beispiel zu verweisen, reicht nicht aus.
Können Sie uns sagen, was Ihnen an der NVIDIA-Dokumentation nicht gefällt? Gibt es Features, die „must have“ oder „nice to have“ sind? Es ist schwierig zu empfehlen, wenn wir den Hut, den Sie suchen, nicht kennen.
Ich persönlich sehe es nicht so viel besser als Doxygen. Wenn Sie uns jedoch keine Liste mit Anforderungen, Betriebsanweisungen oder Budget angeben, können wir nur vorschlagen, dass Sie das verwendete NVDIA verwenden. Ich sehe keine Erwähnung davon auf der Seite, aber Sie können sie jederzeit über ihren Feedback-Link (mailto:cudatools@nvidia.com?subject=CUDA Toolkit Documentation Feedback: cuRAND) kontaktieren und fragen, was sie verwenden und ob dies der Fall ist FOSS.
OK, das ist 6 Monate alt und Steve hat keine Lust, es zu verbessern. Abwertung als Empfehlungsanfrage von geringer Qualität.

Antworten (1)

Ich kann den Sphinx Document Generator wärmstens empfehlen - für eine Beispielseite werfen Sie einen Blick auf die neue wxPython-Dokumentation .

Erzeugt Dokumentation aus:

  • Python-Code
  • C/C++-Code
  • umstrukturierter Text 3
  • Mehrere Ausgabeformate - HTML (einschließlich Windows HTML Help), LaTeX (für druckbare PDF-Versionen), ePub, Texinfo, Handbuchseiten, einfacher Text
  • Code-Hervorhebung für eine Vielzahl von Sprachen
  • Themen
  • Index- und Inhaltsverzeichnisgenerierung

Kostenlos und plattformübergreifend.

Ihr Link führt zu einem Wiki - generiert Sphinx das auch (oder speist Inhalte in ein bestehendes Wiki ein)? Wie ist es auch anders / besser als Doxygen?
Sphinx generiert die wxPython-Dokumentation und das Wiki AFAIK - das OP sagte, dass ihnen das Aussehen der von Doxygen generierten Dokumente "nicht gefallen" habe - Sphinx verfügt über eine Reihe modernerer Vorlagen und viele Anpassungsoptionen.
Tool zur Generierung von C++-Codedokumentation
AntwortenHierDatenschutz-Bestimmungen1y, 0v