Since this has caused resistance and obstructed acceptance of the other fixes in here, I'll pull it out for now. 

@RSully the whole point of `@method` [is to deal with magic methods](http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/method.html). Without annotations like this, a static analyzer looks at invocations and believes that the method doesn't exist on the class and thus flags a warning.

@bencorlett I'll consider putting a proposal together later.