Do you repeat those docs in all subclasses by mistake or is it intended? Maybe consider {@inlinedoc} http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.inlineinheritdoc.pkg.html