Doxygen docu mit \incude oder\includedoc

Also \include parst den Inhalt nicht, sondern geht davon aus, dass es 
Beispiel-Code ohne eigene Doxygen-Kommentare ist, bzw. dessen Kommentare 
nicht weiter geparst werden sollen.
\includedoc sollte aber laut Handbuch eigentlich das tun, was du willst. 
Hast du mal ein kurzes Beispiel für etwas, das deiner Meinung nach tun 
sollte, aber nicht tut?

Einige Features von Doxygen verlangen, dass jede Datei via

1

/// \file  filename.h

dokumentiert wird. Ich glaub ein reines \file geht auch, da bin ich mir 
aber grad nicht sicher. Innerhalb jener Datein lässt sich dann wie du 
bereits erkannt hast via \page eine neue Seite anlegen.

Um die erstellten Seiten in der Leftbar nach meinen Vorstellungen zu 
sortieren nutze ich dann meist \subpage. Dabei erstell ich eine Page die 
in einem Table eine Übersicht aller Subpages enthält. Die Reihenfolge im 
Table forciert dann die Reihenfolge in der Leftbar.

1

/// \page page_contents Contents

2

/// | Page           | Content |

3

/// | -------------- | ------- |

4

/// | \subpage page0 | Page0   |

5

/// | \subpage page1 | Page1   |

6

/// | \subpage page2 | Page2   |

Da mich das Thema in anderem Zusammenhang wieder mal gebissen hat hab 
ich es mal näher untersucht. Es ist tatsächlich so das /includedoc nicht 
wie erwartet funktioniert. Ich hatte per Markup ein paar Tabellen gebaut 
diese wurden genauso wenig korrekt bearbeitet wie alle anderen doxygen 
comands.
Das einzige was geholfen hat war im include File alles auf HTML 
umzustellen. Die Dokumentation sagt ja dass einige Comands nicht gehen, 
das ist allerdings stark untertrieben. Nur HTML geht und dort auch nicht 
alles. <li> </li> geht zum Beispiel innerhalb von Tabellen auch nicht.

Thomas