Add phpDoc to loaders and generated mock classes

This enables checking of stub return values by Augmented Types:
https://github.com/box/augmented_types

We use augmented types extensively and the fact that Phake elides
the docs from its mock method definitions allows invalid mock expectations
to be setup.