doxygen - Problem beim Extrahieren von Aufzählungstypen

[eagle]

Ich habe ein Problem mit doxygen und der Dokumentation von Aufzählungstypen unter C++. doxygen extrahiert diese nur wenn die Option EXTRACT_ALL = YES gesetzt ist. Das ist aber nicht gewünscht, da so auch jede Menge anderer Informationen erscheinen.

eagle

[Joghurt]

Geht bei mir ohne Probleme:

Code: Alles auswählen

/// The Foo class
class Foo {
public:
    /// Bar enum
    enum Bar {
	/// Lorem ipsum dolor sit amet
	FOO, 
	/// consectetur adipisicing elit
	BAR,
	/// sed do eiusmod tempor incididunt ut labore 
	BAZ 
    };
}

Wichtig ist, dass die Klasse dokumentiert ist.

[eagle]

Ja das funktioniert bei mir auch allerdings nicht mehr so:

Code: Alles auswählen

/// Bar enum 
enum Bar { 
/// Lorem ipsum dolor sit amet 
   FOO, 
   /// consectetur adipisicing elit 
   BAR, 
   /// sed do eiusmod tempor incididunt ut labore 
   BAZ 
}; 


/// The Foo class 
class Foo { 
public: 
    /// Foobar
   void fooBar();
}

[Joghurt]

In dem Falle muss die Datei selbst "kommentiert" sein:

Code: Alles auswählen

///@file dateiname.cpp

an den Anfang schreiben.

[eagle]

Ja danke das war es. Ich hatte mir schon echt einen "Wolf" gesucht .

eagle

[Joghurt]

Ist übrigens schlechter Programmierstil. Das enum gehört mindestens in einen Namespace.

[eagle]

Erwischt und zwar ein sehr Fauler ... Ich werde versuchen den Tipp in Zukunft zu beherzigen.

eagle