[ticket/12557] Fix doc block errors found by Sami

Thought it's better to send the ascraeus PR after this is reviewed.

[PHPBB3-12557](https://tracker.phpbb.com/browse/PHPBB3-12557)