[ticket/12408] Public functions and updated doc block

PHPBB3-12408