[Doxygen] Doku von Funktionen mit compilerspez. Erweiterungen
-
Moin,
ich bin bei der Dokumentation via Doxygen auf ein kleines Problem gestossen. Ich habe im Code Funktionen (Interrupt Service Routinen (ISR)) wie:
/*! @brief Blabla... Even more blabla... */ void __attribute__((interrupt, no_auto_psv)) _T1Interrupt(void) { // code }
Die Doxygen-Tags funktionieren hier aber leider nicht, es wird immer __attribute__ als Funktionsname erkannt, nicht aber _T1Interrupt. Die Frage: wie kann man das mit anderen/speziellen Doxygen-Tags lösen?
PS: Eine Lösung, welche ich zur Zeit auch verwende, ist ein Makro:
#define T1_ISR __attribute__((interrupt, no_auto_psv)) _T1Interrupt // ... /*! @brief Blabla... Even more blabla... */ void T1_ISR(void){ // code }
Das löst das Problem mit Doxygen (und macht den Code imho sogar schöner). Ich frage nur der Vollständigkeit halber.
-
Ich bin jetzt zu faul das auszuprobieren, aber wie waers mit
void _T1Interrupt(void) __attribute__((interrupt, no_auto_psv))
?
-
Mr. N schrieb:
Ich bin jetzt zu faul das auszuprobieren, aber wie waers mit
void _T1Interrupt(void) __attribute__((interrupt, no_auto_psv))
?
Syntax Error
-
vielleicht hilft das?
http://osdir.com/ml/text.doxygen.general/2003-07/msg00056.html
-
Love is like Doxygen schrieb:
vielleicht hilft das?
http://osdir.com/ml/text.doxygen.general/2003-07/msg00056.html
Ah, das sieht gut aus. Muss ich probieren. Danke.