Forum: PC-Programmierung Doxygen: Funktionsdefinition per Makro


von Walter T. (nicolas)


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?

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.