[Garoof]

Fair enough. Then it sounds like your problem is really with annotations, and not that much about the in-comment part of this.

[mmcnickle]

Yes, and it's not limited to PHP. I don't particularly like how Flask (python) uses decorators for its routing as well.