[ticket/12060] Further clarifying new event docblocks as much as possible

PHPBB3-12060