Doxygen: Funktionsdefinition per Makro

OP #5955351
Hallo zusammen,

Doxygen stolpert bei meiner main()-Funktion. Man kann es ihm nicht ganz 
übel nehmen. Die Definition ist etwas schräg.

Mein Prä-Doxygen-Quelltext sieht so aus:
1
#if defined( STM32F10x ) || defined( STM32F4XX )
2
    /* Zielplattform (Debug, Release, Modultests) */
3
    #define MAINFUN  int __attribute__((OS_main)) main(void)
4

5
#elif defined( MOCKUP_SDL )
6
    /* Mockup */
7
    #define MAINFUN  int SDL_main(int argc, char *argv[])
8

9
#elif PC_UNITTEST
10
    /* Fuer Modultests auf dem PC existiert eine andere main() in UnityTestRunner.c */
11
    #define MAINFUN  int neverstart(void)
12

13
#else
14
    #error "unknown platform"
15

16
#endif
17

18

19

20

21
/** Main-Funktion fuer Zielplattform und PC-Mockup */
22
MAINFUN
23
{
24
    #if defined( STM32F4XX ) || defined( STM32F10x )
25

26
        /* Timer und Interrupt-Prioritaeten einstellen */
27
        SystemInit();
28
        SysTick_Config(SystemCoreClock/1000*(SYSTICK_TIMER_INTERVAL_MS));
29

30
        ...
31
   #endif
32
        
33
  ...
34
}

Die würde der erfahrene Doxydant das sinnvoll darstellen?

Antwort schreiben

Eine eigene Frage? Dieser Thread ist über 7 Jahre alt. Stell sie in einem eigenen Thread – dort lesen mehr Leute mit, und sie wird öfter und schneller beantwortet.

Neuen Thread starten

Eine Lösung, Ergänzung oder Rückmeldung zu diesem Thread? Dann antworte hier.

Formatierung
  • [c]C-Code[/c]
  • [code]Code in anderen Sprachen, ASCII-Zeichnungen[/code]
  • [math]Formel in LaTeX-Syntax[/math]
  • [[Titel]] – Link zu einem Artikel
  • Verweis auf einen anderen Beitrag: Rechtsklick auf dessen Beitrags-ID (#8078628), „Adresse kopieren“, in den Text einfügen

Mehr zur Formatierung

Längeren Sourcecode als Anhang, nicht in den Text. JPG nur für Fotos und Scans; Zeichnungen und Screenshots als PNG oder GIF. Siehe Bildformate.

Schon registriert? Anmelden

Wird nicht angezeigt. Wir schicken dir einen Link; sobald du damit bestätigst, erscheint dein Beitrag.

Mit dem Abschicken legst du einen kostenlosen Account an und erkennst die Nutzungsbedingungen und die Datenschutzerklärung an.