Can we move this documentation to the class docbloc, therefore it can be picked up by phpdocumentor.