Beispiel Dokumentation Assembler + Doxygen gesucht

Gast #1382593
Lesenswert?

Hallo zusammen,

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 nicht 
wirklich fündig geworden.

MFG
Andy

Antwort schreiben

Bitte melde dich an, um einen Beitrag zu schreiben.

oder

Mit Google-Account einloggen

Die Registrierung ist kostenlos und dauert nur eine Minute.

Jetzt registrieren