DOXYGEN 'changelog' für gesamtes Projekt

[Christian R. (crothe)]

Guten Morgen,

ich kann ein Problem bei der Dokumentation meines Codes nicht lösen. 
Vielleicht hat jemand von Euch einen Rat.

Ich habe ein umfangreiches Projekt in c#, in dem viele einzelne code 
dateien für sich jeweils eigene Versionsnummern benötigen. Diese liegen 
jeweils in eigenen verzeichnissen incl. einer dazugehörigen Doxyfile 
Datei, die dieses code Modul einzeln mit DOXYGEN dokumentieren lässt 
(HTML).
Wichtig, um die Änderungen zu überblicken, ist hier der Bereich 
'Changelog'.
Im Header der sourcefiles sieht das z.B. so aus:

* \section chlog Changelog
* @version 0v00  -  .01.2016
* - first release 
* @version 0v03  -  27.07.2016
* - reading only frequencies of channel 1 was based on enabled debug settings  -  removed
* @version 0v05  -  21.09.2016
* - rate units changed from A to A/s
* @version 0v06  -  08.11.2016
* - activate QCM checkboxes moved from configuration tab to operation tab
* @version 0v07  -  12.12.2016
* - Deactivated channels now can be activated again

Das Ergebnis pro Datei ist gut und übersichtlich. Doxygen habe ich so 
weit konfiguriert, dass nur eine HTML Seite alle Informationen enthält 
die ich brauche.


Da das gesamte Projekt aber über 30 solcher Unterordner enthält wäre es 
nun nötig, eine Gesamtliste aller dieser Changelogs in eine HTML 
Dokumentation zu bringen. Einen geeigneten Syntax habe ich bislang nicht 
gefunden. Getestet habe ich folgendes:

* @page ChangeLog
* \section chlog Changelog
* @version 0v00  -  .01.2016
* - first release 
* @version 0v03  -  27.07.2016
* - reading only frequencies of channel 1 was based on enabled debug settings  -  removed
* @version 0v05  -  21.09.2016
* - rate units changed from A to A/s
* @version 0v06  -  08.11.2016
* - activate QCM checkboxes moved from configuration tab to operation tab
* @version 0v07  -  12.12.2016
* - Deactivated channels now can be activated again

Durch die Anweisung '@page Changelog' bekomme ich im "Related Pages" 
Menü der HTML Ausgabe von Doxygen zwar einen Link auf 'ChangeLog', 
welcher auch die entsprechenden changelogs der einzelnen Dateien 
enthält, jedoch ist dort
 1. keine Zuordnung mehr möglich velcher Eintrag zu welcher Datei gehört
 2. Die Einzeldokumentation enthält ihre eigenen changelogs nicht mehr


Zur eigentlichen Frage:
Wie erzeugt man eine Programmweite und nach sourcefile und release 
separierte Liste mit Doxygen?

Grüße
Christian

[StinkyWinky (Gast)]

Ich glaube nicht, dass das geht.

Aber du könntest mit @copydetails arbeiten.

[Torsten R. (Firma: Torrox.de) (torstenrobitzki)]

Christian R. schrieb:

> Zur eigentlichen Frage:
> Wie erzeugt man eine Programmweite und nach sourcefile und release
> separierte Liste mit Doxygen?

Kannst Du Dir ggf. die Informationen aus Deiner Version-Verwaltung holen 
und dann daraus etwas generieren, das Doxygen wiederum versteht?

[Christian R. (crothe)]

Im Grunde ist das doch Tex oder LaTex und das was ich brauche entspricht 
doch eigentlich dem Erstellen eines Verzeichnisses, oder sehe ich das 
falsch?

Es gibt halt kein Hauptdokument mit includes. Die Verwaltungsaufgaben 
müssten halt irgendwie von Doxygen ausgeführt werden. Hier kann ich ja 
unter "Expert->Input" die betroffenen Files z.B. anmelden.

[Der kein Bock mehr A. (Gast)]

Umpf, ich erinnere mich an ein Projekt was zeimlich lange her ist .. ich 
glaub ein Teil davon war, eben solche Metainformation zuerst selbst per 
bash/perl zu parsen und diese dann als Teil der doxy.conf zu inkludieren 
...

Hab das Projekt sogar noch gefunden, hehe...

Also, ich hatte damals die doxy.conf erst zur Laufzeit zusammengebaut 
und dann an den Doxygen-Aufruf übergeben.

In dem Projekt ging es darum, um für eine Software verschiedene Branches 
nightly aus dem SVN auszuchecken und deren Doku tagesaktuell zu 
präsentieren.

LG

[Christian R. (crothe)]

Hallo Jörg,

das klingt interessant mit dem täglich-automatischen Update, wie auch 
immer Du das im Detail gemacht hast...

Für mein Problem vielleicht nicht ganz die richtige Lösung? Ich würde 
gerne alle vorhandenen source files auf die Änderungen prüfen und dann 
als report oder HTML Seite (am liebsten incrementell) ausgeben. Ein 
Programm könnte man dafür natürlich auch schreiben, jedoch hoffte ich 
mit den Werkzeugen von Doxygen bereits zur Lösung zu kommen :-(

Grüße
Christian