Update PHPDoc documentation of interfaces.

I've updated the PHPDoc annotations for some of the interface signatures, correcting the annotations of parameter names and types and adding types that were missing. I also fixed some minor grammatical errors and, in a separate commit, converted tabs to spaces.