add missing @throws and @param to method phpdoc
add remark to a couple $annotation params that they are unused...
Merge pull request #42 from thewunder/v2

add missing @throws and @param to method phpdoc