PHPDoc improvements

Here's some small fixes / additions to improve PHPDoc and auto-completion in IDEs.