Add PHPDocumentor comments to method signatures

Reference #2