Dokumentation mit Doxygen

[Dennis S. (eltio)]

Hallo zusammen,

In meinem Programm habe ich Header- und Source-Files getrennt. Zur Zeit 
habe ich in der .c-Datei lediglich einen kurzen Kommentar am Anfang der 
Datei:

/** \file
 * \brief Beinhaltet Funktionen zum Einlesen von Daten.
 */

und in der Header-Datei kommentiere ich die Prototypen:

/** \brief Liest Daten aus einer CSV-Datei. 
 *  \param *fileName Name der einzulesenden Datei
*/
void readData(char *fileName);

Wie ist die "gängige" Praxis für die Nutzung von Doxygen in 
C-Quellcodes?

Gruß
Dennis

[Georg A. (georga)]

Was gängig ist, weiss ich nicht. Für sinnvoll halte ich es jedenfalls, 
Funktionen/Methoden im C-File zu kommentieren, weil man selber gleich 
sieht, was "alles los" ist. Das kann die Doku nur verbessern. Im 
Headerfile mache ich das nur für Klassenvariablen etc. Doxygen fügt das 
ja dann eh alles zusammen.

[Stinkywinky (Gast)]

Man könnte in den Header-Dateien die Anwender-Doku beschreiben 
(Schnittstellen, etc) und in den C-Files die Entwickler-Dokumentation.

Nun kann man mit zwei Durchläufen von doxygen Anwender- und 
Entwickler-Doku separat generieren.

[Dennis S. (eltio)]

Hmm... danke für die Anregungen.

Ich habe es jetzt erstmal so realisiert, dass ich die 
Schnittstellenbeschreibung (d.h. Doxygen-Kommentare) in den 
Header-Dateien mache und in der Implementierung nur "normale" 
Kommentare.

Gruß
Dennis