Improve docblocks

Couple of docblock and linting fixes.
mmmh.
I'm using this data to create the extension skeleton. Not really keen on making a full fledged javadoc parser :)