inherit phpdoc where possible, define it where there is nothing to inherit