Forum: Mikrocontroller und Digitale Elektronik Beispiel gesucht: Assembler + Doxygen


von Gast Andy (Gast)


Lesenswert?

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

Bitte melde dich an um einen Beitrag zu schreiben. Anmeldung ist kostenlos und dauert nur eine Minute.
Bestehender Account
Schon ein Account bei Google/GoogleMail? Keine Anmeldung erforderlich!
Mit Google-Account einloggen
Noch kein Account? Hier anmelden.