Doxygen

Doxygen ist ein freies Software-Dokumentationswerkzeug unter der GNU General Public License.

Doxygen

Eine mit Doxygen erzeugte Dokumentation einer C++-Klasse
Basisdaten
Entwickler Dimitri van Heesch
Erscheinungsjahr 26. Oktober 1997[1]
Aktuelle Version 1.9.3[2]
(31. Dezember 2021)
Betriebssystem Linux, macOS, Solaris, Unix, Windows
Programmiersprache C++
Kategorie Software-Dokumentationswerkzeug
Lizenz GPL
deutschsprachig ja
www.doxygen.nl

Hintergrund und Motivation

Durch spezielle Kommentare im Quelltext können Softwareentwickler Erläuterungen zu Programmelementen definieren, aus denen Doxygen eine übersichtliche Dokumentation erstellt. Außerdem ist es möglich, einen zusammenfassenden Überblick über den Aufbau und die Elemente eines bereits existierenden Programms (verwendete Dateien, Funktionen, Variablen sowie deren jeweilige Rolle im Programmablauf) zu erzeugen.

Das Ziel einer solchen Dokumentationsmethode ist die Vermeidung von Redundanz und die Steigerung der Übersichtlichkeit des Codes. Da Programmstrukturen im Quelltext selbst beschrieben werden müssen, ist eine parallele Dokumentation der Strukturen (Funktionen, Klassen, Methoden usw.) in einer separaten Entwicklerdokumentation fehleranfällig, da sich diese im Laufe einer Entwicklung häufig ändern. Zudem wird dem Entwickler der Aufwand einer separaten Dokumentenerstellung erspart und die Vollständigkeit der Dokumentation gesichert und gesteigert.

Mithilfe einer Doxy-Dokumentation ist es ferner möglich, einen unbekannten Code leichter zu verstehen und zu reengineeren.

Als grafische Benutzeroberfläche dient der sogenannte Doxywizard, mit dem die Einstellungen, welche Art und Form der Dokumentationserzeugung steuern, einfach vorgenommen werden können.

Die meisten gängigen Entwicklungsumgebungen (IDE) unterstützen Doxygen durch Syntaxhervorhebung.

Die erste Doxygen-Version verwendete Quelltext von DOC++, das am Zuse-Institut Berlin von Roland Wunderling und Malte Zöckler entwickelt wurde.

Doxygen ist kompatibel zur Code-Versionierung mit Subversion, womit automatisch erzeugte Codes für Autoren, Bearbeiter, Datum und Zeitpunkt des Eincheckens in die Doxygen Dokumentation übernommen werden können.

Unterstützte Programmiersprachen

Unterstützte Programmiersprachen sind C++, C, Objective-C, Java, Python, Fortran und IDL. Sie werden in ihrem vollen Sprachumfang unterstützt. Mit Einschränkungen ist auch die Kommentierung von PHP, C#, D und VHDL möglich. Ab Version 1.7.5 wird Tcl unterstützt. Durch zusätzliche Filter kann auch Quellcode in Perl oder Object Pascal bearbeitet werden.

Unterstützte Ausgabeformate

Als Ausgabeformat unterstützt Doxygen HTML, CHM, LaTeX, XML, RTF, PostScript, PDF, Manpages und Markdown.[3] Auch lassen sich entsprechende Steuerdaten für die Erstellung von Hilfedateien für das Hilfesystem von Qt erstellen. Ab Version 1.8.8 wird auch PlantUML unterstützt, um UML-Diagramme zu erstellen.[4]

Beispiel

Die Dokumentierung einer Funktion kann wie folgt in den Quelltext eingebettet werden (hier in der Programmiersprache C):

 /**
  * \brief Exemplarische Funktion
  *
  *     Diese Funktion gibt den übergebenen Parameter
  *     auf der Konsole aus.
  *
  * \param	parameter  Auszugebender Parameter
  * \return	      Status-Code
  *
  */
 int funktion(int parameter)
 {
     printf("Parameter: %d", parameter);

     return 0;
 }

Ähnliche Werkzeuge
Commons: Doxygen – Sammlung von Bildern, Videos und Audiodateien
Wikibooks: C++-Programmierung: Dokumentation mit Doxygen – Lern- und Lehrmaterialien

Einzelnachweise
  1. web.archive.org.
  2. Release 1.9.3. 31. Dezember 2021 (abgerufen am 3. Januar 2022).
  3. Doxygen Manual: Markdown support. Abgerufen am 20. August 2020.
  4. Doxygen Manual: Changelog. Abgerufen am 20. August 2020.
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. The authors of the article are listed here. Additional terms may apply for the media files, click on images to show image meta data.