[ticket/11927] Add doc block to new function

PHPBB3-11927