Fix phpdocs

Mostly fully qualified namespaces, incorrect classes or wrong/missing
return values.
Allow for `Class@method` syntax to be used with `Validator::extend`. Closes #1061.