Vortrag Code Dokumentation Eine Einfhrung in Doxygen und
- Slides: 16
Vortrag Code. Dokumentation Eine Einführung in Doxygen und Sandcastle Gunter Nagel, 21. 04. 2008
Inhalt Vergleich von Doxygen und Sandcastle Kurze Einführung in Doxygen Einführung in Sandcastle
Vergleich von Doxygen und Sandcastle Doxygen Unterstützt sehr viele Sprachen Kann Vererbung grafisch darstellen Viele verschiedene Ausgabeformate Auf viele Plattformen und Betriebssysteme portiert Sandcastle Erzeugte Dokumentation sieht aus wie MSDN Sehr gute Integration in. Net-Framework
Kurze Einführung in Doxygen Funktionsweise von Doxygen n n Doxygen parst den gesamten Quelltext Doxygen erstellt aus Klassendeklarationen und Methodendeklarationen grundlegende Dateien Doxygen fügt spezielle Kommentare in diese Dateien ein. Konfiguration dieses Prozesses erfolgt über die projektweite Konfigurationsdatei Doxyfile.
Aufbau der Doxygenkommentare Doxygen versteht unter Anderem folgende Kommentartypen: n n Doc++-Kommentare XML-Kommentare aus. Net (siehe Codebeispiel)
Wie benutzt man Doxygen Per Hand: n n Erstellung des Doxyfile Aufruf von Doxygen. exe Doxygen-Wizard n n Konfiguration des Projektes Erstellung der Dokumentations-Dateien
Ergebnisse von Doxygen Beispiele aus: n n Xerces-Dokumentation Qt-Dokumentation Links: n Doxygen
Einführung in Sandcastle Funktionsweise von Sandcastle Projekteinstellungen im Visual Studio Sandcastle GUI XML-Kommentare
Funktionsweise von Sandcastle Visual Studio erstellt auf Wunsch beim Compilieren XML-Kommentar-Dateien Sandcastle parst XML-Kommentar. Dateien Sandcastle erstellt daraus XML-Dateien Sandcastle erzeugt dann via XSLT neue Dateien, deren Format und Aussehen von den Settings abhängen
Konfiguration des Visual Studio Projektkonfiguration: n XML-Kommentar-Datei erstellen
Sandcastle GUI
XML Kommentare Kommentar für eine Zusammenfassung: <summary>Die Zusammenfassung</summary> Kommentar für ein Parameter: <param name='name'>Description. </param> Kommentar für den Rückgabewert: <returns>Rückgabewertbeschreibung</returns> Kommentar für eine Bemerkung: <remark>Die Bemerkung. </remark>
XML-Kommentare 2 Kommentar für einen Absatz <para>Inhalt des Absatzes</para> Kommentar für ein sehr kurzes Code-Beispiel im Fließtext <c>Das Code-Beispiel</c> Kommentar zum Verlinken von einem Parameter auf die ausführliche Beschreibung <paramref>name=“Parametername“</ paramref >
XML Kommentare 3 Verlinkung auf ein anderes Dokument für z. B. eine Klassenbeschreibung aus der MSDN <see cref=“Name“/> Kommentar für eine Exception, die Klasse wirft <exception cref=“Exceptionklasse“></exception> Kommentar für ein längeres Code-Beispiel, meist umgeben von <example> <code>Beispielcode</>
XML-Kommentare 4 Kommentar für ein Beispiel, meist in Verbindung mit <code> <example>Das Beispiel</example>
Sandcastle-Links Sandcastle Helpfile Builder http: //www. codeproject. com/KB/dotnet/ccn etsandcastle. aspx
- Zuordnung funktion
- Vortrag stressprävention
- Vortrag zusammenarbeit
- Transparente bewertung
- Sandcastle gui
- Doxygen adalah
- Doxygen tparam
- Doxygen eclipse
- Brandklasse 3
- Gloop dokumentation
- Aufbereitung der lieferanten-dokumentation
- Dokumentation software engineering
- Instrumentenaufbereitung praxis
- Pedagogisk dokumentation i tillblivelse
- Dokumentation schichtübergabe
- Dokumentation af it
- Dokumentation og evaluering i socialt arbejde