added phpdocs on what is returned.