Hallo zusammen,
ich hatte im Unterforum PC Hard- & Software keine Antwort erhalten -
deshalb hier nochmals ein Versuch :-)
Ich bin gerade dabei mich in DOXYGEN einzuarbeiten, da ich meine Files
(Assembler) damit dokumentieren möchte.
Mir ist schon klar, daß das Programm die Assembler-Syntax eigentlich
nicht(voll) unterstützt, aber vielleicht kann man es trotzdem nutzen !?
Um die Syntax/Arbeitsweise von DOXYGEN besser zu verstehen, habe ich mit
einfachen Beispielen experimentiert. Variablen (.equ RAM_Variable =
0x60) werden vernünftig extrahiert bzw. als solche dann in der
erzeugten HTML-Doku angezeigt. Doch bei anderen Ausdrücken hapert es,
d.h. es wird nicht oder falsch interpretiert...
Beispiel:
In Assembler gibt es keine Funktionen mit "()" sondern nur Sprungmarken
mit ":". Gibt es eine Möglichkeit, wie man das durch geschickte
Gruppierung etc. lösen kann? Ich möchte einfach, dass DOXYGEN eine
Assembler-Routine wie eine Funktion "behandelt".
1 | /**
|
2 | * routinename. details about the routine
|
3 | */
|
4 | routine:
|
5 | mov temp2, temp
|
6 | ret
|
Habe auch schon das Perl-Script zur Konvertierung in Pseudo-C-Code
ausprobiert, doch das hat mir nur die Defines extrahiert, d.h. die
Variablen nicht. (user error...?)
Falls jemand seine Assemblerfiles mit DOXYGEN dokumentiert - es wäre
echt toll, wenn er mal ein solches File posten könnte!
Der eigentliche Code interessiert nicht, nur die Kommentare :-)
Auch Links wären super. Zum Thema DOXYGEN+Assembler bin ich bisher im
Netz nicht wirklich fündig geworden.
MFG
Andy