mikrocontroller.net

Forum: PC-Programmierung Doxygen: Funktionsdefinition per Makro


Announcement: there is an English version of this forum on EmbDev.net. Posts you create there will be displayed on Mikrocontroller.net and EmbDev.net.
Autor: Walter T. (nicolas)
Datum:

Bewertung
0 lesenswert
nicht 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:
#if defined( STM32F10x ) || defined( STM32F4XX )
    /* Zielplattform (Debug, Release, Modultests) */
    #define MAINFUN  int __attribute__((OS_main)) main(void)

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

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

#else
    #error "unknown platform"

#endif




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

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

        ...
   #endif
        
  ...
}

Die würde der erfahrene Doxydant das sinnvoll darstellen?

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.

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