Added/Fixed PHPDocs

PHPDocs make using and debugging eZFind a lot easier, so is a PR that adds/fixes the PHPDoc for most methods. I excluded the methods that override their parent method. IDEs like PHPStorm will then take the PHPDoc from the respective parent.

Cheers
:octocat: Jérôme