Add phpdoc annotations for when action methods to help IDEs

Squashing [pull #17](https://github.com/hafriedlander/phockito/pull/17) into a single commit, as requested.