Fixed PHPdoc comments

As reported by PhpStorm. I let it add the @throw lines (183) automatically. The changes to the @param and @return lines (63) I went through manually to make sure they're correct.

I did not change any actual code, so it's safe from that POV. With tabs this time.