[ticket/10202] Improve method documentation.

PHPBB3-10202