Doxygen

aus Wikipedia, der freien Enzyklopädie
Wechseln zu: Navigation, Suche
Doxygen
Screenshot
Eine mit Doxygen erzeugte Dokumentation einer C++-Klasse
Basisdaten
Entwickler Dimitri van Heesch
Aktuelle Version 1.8.12
(05. September 2016)
Betriebssystem Linux, Mac OS X, Solaris, Unix, Windows
Programmier­sprache C++
Kategorie Software-Dokumentationswerkzeug
Lizenz GPL
deutschsprachig ja
www.stack.nl/~dimitri/doxygen/

Doxygen ist ein von Dimitri van Heesch entwickeltes Software-Dokumentationswerkzeug, es steht als freie Software unter der GNU General Public License.

Hintergrund und Motivation[Bearbeiten | Quelltext bearbeiten]

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. Da Programmstrukturen im Quelltext selbst beschrieben werden müssen, ist eine zusätzliche Dokumentation der Strukturen (Funktionen, Klassen, Methoden usw.) in einer separaten Entwicklerdokumentation fehleranfällig, da sich diese im Laufe einer Entwicklung häufig ändern. Zudem werden dem Entwickler der Aufwand einer separaten Dokumentenerstellung erspart und die Vollständigkeit der Dokumentation gesichert und gesteigert.

Als grafische Benutzeroberfläche dient der sogenannte Doxywizard, mit dem die Einstellungen sehr 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.

Unterstützte Programmiersprachen[Bearbeiten | Quelltext bearbeiten]

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. Seit 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[Bearbeiten | Quelltext bearbeiten]

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

Beispiel[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

Weblinks[Bearbeiten | Quelltext bearbeiten]

 Commons: Doxygen – Sammlung von Bildern, Videos und Audiodateien

Einzelnachweise[Bearbeiten | Quelltext bearbeiten]

  1. Markdown-Unterstützung (seit Version 1.8.0)
  2. PlantUML-Unterstützung (seit Version 1.8.8)