mikrocontroller.net

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


Autor: Gast Andy (Gast)
Datum:

Bewertung
0 lesenswert
nicht 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".
/**
* routinename. details about the routine
*/
routine:
      mov temp2, temp
      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

Antwort schreiben

Die Angabe einer E-Mail-Adresse ist freiwillig. Wenn Sie automatisch per E-Mail über Antworten auf Ihren Beitrag informiert werden möchten, melden Sie sich bitte an.

Wichtige Regeln - erst lesen, dann posten!

  • Groß- und Kleinschreibung verwenden
  • Längeren Sourcecode nicht im Text einfügen, sondern als Dateianhang

Formatierung (mehr Informationen...)

  • [c]C-Code[/c]
  • [avrasm]AVR-Assembler-Code[/avrasm]
  • [code]Code in anderen Sprachen, ASCII-Zeichnungen[/code]
  • [math]Formel in LaTeX-Syntax[/math]
  • [[Titel]] - Link zu Artikel
  • Verweis auf anderen Beitrag einfügen: Rechtsklick auf Beitragstitel,
    "Adresse kopieren", und in den Text einfügen




Bild automatisch verkleinern, falls nötig
Bitte das JPG-Format nur für Fotos und Scans verwenden!
Zeichnungen und Screenshots im PNG- oder
GIF-Format hochladen. Siehe Bildformate.
Hinweis: der ursprüngliche Beitrag ist mehr als 6 Monate alt.
Bitte hier nur auf die ursprüngliche Frage antworten,
für neue Fragen einen neuen Beitrag erstellen.

Mit dem Abschicken bestätigst du, die Nutzungsbedingungen anzuerkennen.