[ticket/11896] Correctly document return of null in docblocks

Also got rid of previous incorrect comment in docblocks.

PHPBB3-11896