Doxygen: Funktionsdefinition per Makro

OP #5955351
Lesenswert?

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

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