source code dokumentation

[mjustin]

Zitat von Codewalker:

Der naive Versuch die direkt in den Sandcastle Help File Builder zu füttern klappt schon mal gar nicht.

doxygen (mit "support for C# style comments with XML markup") wäre meine erste Anlaufstelle, oder NDoc 3.

[Codewalker]

Mit Doxygen scheine ich aber keine Delphi-Hilfe kompatible Ausgabe erzeugen zu können. Das wiederum würde der Sandcastle Help File Builder hinkriegen, der mag aber die Delphi-Projekte nicht:

Code:

SHFB: Error BE0067: Unable to obtain assembly name from project file 'P:\...\Lib.dproj' using Configuration 'Debug', Platform 'x86'

[BUG]

Vielleicht konnte man das gut mit XSTL lösen.
Hier hat es jemand für .net-Dokumentationen gemacht, vermutlich sind die den Delphi-Dokus ziemlich ähnlich.

[mjustin]

Zitat von Codewalker:

Mit Doxygen scheine ich aber keine Delphi-Hilfe kompatible Ausgabe erzeugen zu können.

Wenn es möglich wäre, mit Doxygen 'out of the box' aus bestehenden Delphi XML Dokumentationsfiles eine (HTML) Onlinehilfe zu erstellen, wäre das schon viel.
(Nicht für alle Projekte muss die Onlinehilfe wie das Original aussehen.)

Sandcastle benötigt Assemblies und funktioniert daher nur mit .Net. Auch NDoc 3 wird vermutlich .Net Assemblies erfordern. Bleibt aktuell also nur noch doc-o-matic, oder gibt es noch andere kommerzielle Produkte?