nicht angemeldet
Erreichen will man, dass ein typischerweise in IDEs eignebauter Parser anspringt und aus den Kommentaren Code-Dokumentation macht. Die ist dann im ganzen Projekt verfügbar und zeigt bei der Eingabe z.B. von Funktionsnamen die definierten Parameter und Rückgabewerte.
Inzwischen haben phpdoc-Kommentare häufig sogar eine eigene Semantik, die über die bloße Dokumentation weit hinausgeht. Beispiele dafür sind Typchecker, Object-relational-Mapper und Service-Locator-Pattern, die sich als Dependency-Injection missverstehen. Der Missbrauch der Kommentare wurde aus der Not heraus geboren, weil PHP kaum Mittel für Metaprogrammierung bietet.
Auge