Ergänzungen & Berichtigungen

Doxygen

Im Buch wird die Doxygen-Version 1.5.2 beschrieben. Inzwischen wurden einige weitere Versionen veröffentlicht, die einige kleinere Änderungen und Erweiterungen mit sich bringen. Unter anderem sind dies:

Neue Konfigurationsschalter
- TYPEDEF_HIDES_STRUCT
  Erzeugt die Dokumentation eines Typalias (typedef) einer Struktur wie die Dokumentation der Struktur selbst.
- HTML_DYNAMIC_SECTIONS
  Im Browser können Grafiken durch Klick auf ein kleines Symbol am Seitenrand ein- und ausgeklappt werden. Ein aktueller Browser mit Javascript-Unterstützung ist Voraussetzung.
- EXTRACT_ANON_NSPACES
  Die Mitglieder anonymer Namensbereiche erscheinen in der Ausgabe.
- MAX_DOT_GRAPH_DEPTH
  Verbesserte Kontrolle der Größe von dotGraphiken
Neue Schlüsselworte
- @tparam zur Dokumentation von Template-Parametern
- @headerfile für die Verwendung von @class im Zusammenhang mit Header-Dateien.
Unter ALIASES können nun auch Aliase mit Argumenten definiert werden.
Mehrfache Kurzbeschreibungen und ausführliche Beschreibungen sind nun erlaubt. Die doxygen-Dokumentation rät jedoch davon ab, diese Möglichkeit zu nutzen.

Eine ausführliche Liste aller Änderungen gibt es im Doxygen Changelog.

Tippfehler

Auf Seite 283 und Seite 285 muss es SEPARATE_MEMBER_PAGES anstatt SEPERATE_MEMBER_PAGES heißen. Entsprechendes gilt auch für den Indexeintrag auf Seite 327.

(D. G.: Danke für den Hinweis!)

Unit Testing

Auf Seite 193 wird JUnit als Urvater aller Testumgebungen bezeichnet. Uwe Koloska wies als aufmerksamer Leser darauf hin, dass dies so natürlich nicht stimmt. Vielmehr gebührt dieser Titel dem Unit Testing Framework SUnit für Smalltalk.