[ticket/11786] Fix various defects in PHPDoc in-code documentation

http://tracker.phpbb.com/browse/PHPBB3-11786

Various PHPDoc in-code documentation fixes.